github.com/askholme/packer@v0.7.2-0.20140924152349-70d9566a6852/website/source/docs/provisioners/puppet-server.html.markdown (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Puppet Server Provisioner"
     4  ---
     5  
     6  # Puppet Server Provisioner
     7  
     8  Type: `puppet-server`
     9  
    10  The `puppet-server` provisioner provisions Packer machines with Puppet
    11  by connecting to a Puppet master.
    12  
    13  <div class="alert alert-info alert-block">
    14  <strong>Note that Puppet will <em>not</em> be installed automatically
    15  by this provisioner.</strong> This provisioner expects that Puppet is already
    16  installed on the machine. It is common practice to use the
    17  <a href="/docs/provisioners/shell.html">shell provisioner</a> before the
    18  Puppet provisioner to do this.
    19  </div>
    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  <pre class="prettyprint">
    27  {
    28     "type": "puppet-server",
    29     "options": "--test --pluginsync",
    30     "facter": {
    31       "server_role": "webserver"
    32     }
    33  }
    34  </pre>
    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` (hash) - Additional Facter facts to make available to the
    52    Puppet run.
    53  
    54  * `options` (string) - Additional command line options to pass
    55    to `puppet agent` when Puppet is ran.
    56  
    57  * `prevent_sudo` (boolean) - By default, the configured commands that are
    58    executed to run Puppet are executed with `sudo`. If this is true,
    59    then the sudo will be omitted.
    60  
    61  * `puppet_node` (string) - The name of the node. If this isn't set,
    62     the fully qualified domain name will be used.
    63  
    64  * `puppet_server` (string) - Hostname of the Puppet server. By default
    65    "puppet" will be used.
    66  
    67  * `staging_directory` (string) - This is the directory where all the configuration
    68    of Puppet by Packer will be placed. By default this is "/tmp/packer-puppet-server".
    69    This directory doesn't need to exist but must have proper permissions so that
    70    the SSH user that Packer uses is able to create directories and write into
    71    this folder. If the permissions are not correct, use a shell provisioner
    72    prior to this to configure it properly.