Resource Type: filebucket
NOTE: This page was generated from the Puppet source code on 2018-08-28 06:48:02 -0700 filebucket —–
Description
A repository for storing and retrieving file content by MD5 checksum. Can be local to each agent node, or centralized on a puppet master server. All puppet masters provide a filebucket service that agent nodes can access via HTTP, but you must declare a filebucket resource before any agents will do so.
Filebuckets are used for the following features:
-
Content backups. If the
file
type’sbackup
attribute is set to the name of a filebucket, Puppet will back up the old content whenever it rewrites a file; see the documentation for thefile
type for more details. These backups can be used for manual recovery of content, but are more commonly used to display changes and differences in a tool like Puppet Dashboard.
To use a central filebucket for backups, you will usually want to declare
a filebucket resource and a resource default for the backup
attribute
in site.pp:
# /etc/puppetlabs/puppet/manifests/site.pp
filebucket { 'main':
path => false, # This is required for remote filebuckets.
server => 'puppet.example.com', # Optional; defaults to the configured puppet master.
}
File { backup => main, }
Puppet master servers automatically provide the filebucket service, so
this will work in a default configuration. If you have a heavily
restricted auth.conf
file, you may need to allow access to the
file_bucket_file
endpoint.
Attributes
filebucket { 'resource title':
name => # (namevar) The name of the...
path => # The path to the _local_ filebucket; defaults to...
port => # The port on which the remote server is...
server => # The server providing the remote filebucket...
# ...plus any applicable metaparameters.
}
name
(Namevar: If omitted, this attribute’s value defaults to the resource’s title.)
The name of the filebucket.
(↑ Back to filebucket attributes)
path
The path to the local filebucket; defaults to the value of the
clientbucketdir
setting. To use a remote filebucket, you must set
this attribute to false
.
(↑ Back to filebucket attributes)
port
The port on which the remote server is listening. Defaults to the
value of the masterport
setting, which is usually 8140.
(↑ Back to filebucket attributes)
server
The server providing the remote filebucket service. Defaults to the
value of the server
setting (that is, the currently configured
puppet master server).
This setting is consulted only if the path
attribute is set to false
.
(↑ Back to filebucket attributes)
NOTE: This page was generated from the Puppet source code on 2018-08-28 06:48:02 -0700