github.com/kikitux/packer@v0.10.1-0.20160322154024-6237df566f9f/website/source/docs/provisioners/puppet-server.html.md (about)

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