puppet/puppet-agent-alpine repository overview

NOTE: As alpine packages for puppet-agent are not provided, this image builds puppet-agent from source and will not exactly match what is included in a puppet-agent package. This includes but is not limited to using system packages rather than vendoring various software (ruby, ssl, etc).

The Dockerfile for this image is available in the puppet-agent repository⁠ under the 'docker/puppet-agent-alpine' directory.

The simplest way of testing the puppet/puppet-agent-alpine image is to run it without any arguments.

docker run --link puppet:puppet puppet/puppet-agent-alpine

This will connect to a Puppet Server at https://puppet and try to download a catalogue. It will also provide verbose output as well as a summary of anything that changed. Note that this is of limited use outside testing, in that it is changing the running container which then exits.

Any additional arguments are passed straight to Puppet, so you can run any arbitrary Puppet command. For example getting the help information is as simple as this:

docker run --link puppet:puppet puppet/puppet-agent-alpine help

If you want to manage the host using Puppet from the image, you need to mount folders from the host and connect to the host network. For instance on CoreOS you would do this:

docker run --rm --privileged --hostname agent -v /tmp:/tmp -v /etc:/etc -v /var:/var -v /usr:/usr -v /lib64:/lib64 --link puppet:puppet puppet/puppet-agent-alpine

See the pupperware repository⁠ for how to run a full Puppet stack using Docker Compose.