Resource Type: filebucket

This version of Puppet is not included in Puppet Enterprise. The latest version of PE includes Puppet 4.8.

NOTE: This page was generated from the Puppet source code on 2017-01-31 13:37:40 -0600

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’s backup 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 the file 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.
  • Content distribution. The optional static compiler populates the puppet master’s filebucket with the desired content for each file, then instructs the agent to retrieve the content for a specific checksum. For more details, see the static_compiler section in the catalog indirection docs.

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 only consulted if the path attribute is set to false.

(↑ Back to filebucket attributes)

NOTE: This page was generated from the Puppet source code on 2017-01-31 13:37:40 -0600

↑ Back to top