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.