diff --git a/website/source/docs/provisioners/puppet-server.html.markdown b/website/source/docs/provisioners/puppet-server.html.markdown new file mode 100644 index 000000000..5b6d7a7ae --- /dev/null +++ b/website/source/docs/provisioners/puppet-server.html.markdown @@ -0,0 +1,68 @@ +--- +layout: "docs" +page_title: "Puppet Provisioner" +--- + +# Puppet Provisioner + +Type: `puppet-server` + +The Puppet provisioner configures Puppet to run on the machines +communicating with a Puppet master. + +
+{ + "type": "puppet-server", + "options": "--test --pluginsync", + "facter": { + "server_role": "webserver" + } +} ++ +## Configuration Reference + +The reference of available configuration options is listed below. + +The provisioner takes various options. None are strictly +required. They are listed below: + +* `client_cert_path` (string) - Path to the client certificate for the + node on your disk. This defaults to nothing, in which case a client + cert won't be uploaded. + +* `client_private_key_path` (string) - Path to the client private key for + the node on your disk. This defaults to nothing, in which case a client + private key won't be uploaded. + +* `facter` (hash) - Additional Facter facts to make available to the + Puppet run. + +* `options` (string) - Additional command line options to pass + to `puppet agent` when Puppet is ran. + +* `puppet_node` (string) - The name of the node. If this isn't set, + the fully qualified domain name will be used. + +* `puppet_server` (string) - Hostname of the Puppet server. By default + "puppet" will be used. + +* `staging_directory` (string) - This is the directory where all the configuration + of Puppet by Packer will be placed. By default this is "/tmp/packer-puppet-server". + This directory doesn't need to exist but must have proper permissions so that + the SSH user that Packer uses is able to create directories and write into + this folder. If the permissions are not correct, use a shell provisioner + prior to this to configure it properly. diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index d8a70dc56..ed9a45b58 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -47,7 +47,8 @@