github.com/aspring/packer@v0.8.1-0.20150629211158-9db281ac0f89/website/source/docs/provisioners/puppet-server.html.markdown (about) 1 --- 2 layout: "docs" 3 page_title: "Puppet Server Provisioner" 4 description: |- 5 The `puppet-server` Packer provisioner provisions Packer machines with Puppet by connecting to a Puppet master. 6 --- 7 8 # Puppet Server Provisioner 9 10 Type: `puppet-server` 11 12 The `puppet-server` Packer provisioner provisions Packer machines with Puppet 13 by connecting to a Puppet master. 14 15 -> **Note:** Puppet will _not_ be installed automatically 16 by this provisioner. This provisioner expects that Puppet is already 17 installed on the machine. It is common practice to use the 18 [shell provisioner](/docs/provisioners/shell.html) before the 19 Puppet provisioner to do this. 20 21 ## Basic Example 22 23 The example below is fully functional and expects a Puppet server to be accessible 24 from your network.: 25 26 ```javascript 27 { 28 "type": "puppet-server", 29 "options": "--test --pluginsync", 30 "facter": { 31 "server_role": "webserver" 32 } 33 } 34 ``` 35 36 ## Configuration Reference 37 38 The reference of available configuration options is listed below. 39 40 The provisioner takes various options. None are strictly 41 required. They are listed below: 42 43 * `client_cert_path` (string) - Path to the client certificate for the 44 node on your disk. This defaults to nothing, in which case a client 45 cert won't be uploaded. 46 47 * `client_private_key_path` (string) - Path to the client private key for 48 the node on your disk. This defaults to nothing, in which case a client 49 private key won't be uploaded. 50 51 * `facter` (object of key/value strings) - Additional Facter facts to make available to the 52 Puppet run. 53 54 * `ignore_exit_codes` (bool) - If true, Packer will never consider the 55 provisioner a failure. 56 57 * `options` (string) - Additional command line options to pass 58 to `puppet agent` when Puppet is ran. 59 60 * `prevent_sudo` (boolean) - By default, the configured commands that are 61 executed to run Puppet are executed with `sudo`. If this is true, 62 then the sudo will be omitted. 63 64 * `puppet_node` (string) - The name of the node. If this isn't set, 65 the fully qualified domain name will be used. 66 67 * `puppet_server` (string) - Hostname of the Puppet server. By default 68 "puppet" will be used. 69 70 * `staging_directory` (string) - This is the directory where all the configuration 71 of Puppet by Packer will be placed. By default this is "/tmp/packer-puppet-server". 72 This directory doesn't need to exist but must have proper permissions so that 73 the SSH user that Packer uses is able to create directories and write into 74 this folder. If the permissions are not correct, use a shell provisioner 75 prior to this to configure it properly.