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

     1  ---
     2  layout: "docs"
     3  page_title: "Null Builder"
     4  ---
     5  
     6  # Null Builder
     7  
     8  Type: `null`
     9  
    10  The null builder is not really a builder, it just setups a SSH connection
    11  and runs the provisioners. It can be used to debug provisioners without
    12  incurring high wait times. It does not create any kind of image or artifact.
    13  
    14  ## Basic Example
    15  
    16  Below is a fully functioning example. It doesn't do anything useful, since
    17  no provisioners are defined, but it will connect to the specified host via ssh.
    18  
    19  <pre class="prettyprint">
    20  {
    21    "type":     "null",
    22    "host":     "127.0.0.1",
    23    "ssh_username": "foo",
    24    "ssh_password": "bar"
    25  }
    26  </pre>
    27  
    28  ## Configuration Reference
    29  
    30  Configuration options are organized below into two categories: required and
    31  optional. Within each category, the available options are alphabetized and
    32  described.
    33  
    34  ### Required:
    35  
    36  * `host` (string) - The hostname or IP address to connect to.
    37  
    38  * `ssh_password` (string) - The password to be used for the ssh connection.
    39    Cannot be combined with ssh_private_key_file.
    40  
    41  * `ssh_private_key_file` (string) - The filename of the ssh private key to be
    42    used for the ssh connection. E.g. /home/user/.ssh/identity_rsa.
    43  
    44  * `ssh_username` (string) - The username to be used for the ssh connection.
    45  
    46  ### Optional:
    47  
    48  * `port` (integer) - ssh port to connect to, defaults to 22.
    49