github.com/hashicorp/packer@v1.14.3/website/content/docs/builders/null.mdx (about)

     1  ---
     2  description: |
     3    The `null` builder creates an SSH connection and runs provisioners. Use the `null` builder to debug provisioners without incurring long wait times. 
     4  page_title: null builder reference
     5  ---
     6  
     7  <BadgesHeader>
     8    <PluginBadge type="official" />
     9  </BadgesHeader>
    10  
    11  # `null` builder
    12  
    13  The `null` builder sets up an SSH connection and runs provisioners. You can use it to debug provisioners without incurring long wait times. It does not create a images or artifacts.
    14  
    15  ## Basic Example
    16  
    17  Below is a fully functioning example. It doesn't do anything useful, since no
    18  provisioners are defined, but it will connect to the specified host via ssh.
    19  
    20  <Tabs>
    21  <Tab heading="HCL2">
    22  
    23  ```hcl
    24  source "null" "basic-example" {
    25    ssh_host = "127.0.0.1"
    26    ssh_username = "foo"
    27    ssh_password = "bar"
    28  }
    29  
    30  build {
    31    sources = ["sources.null.basic-example"]
    32  }
    33  ```
    34  
    35  </Tab>
    36  <Tab heading="JSON">
    37  
    38  ```json
    39  {
    40    "type": "null",
    41    "ssh_host": "127.0.0.1",
    42    "ssh_username": "foo",
    43    "ssh_password": "bar"
    44  }
    45  ```
    46  
    47  </Tab>
    48  </Tabs>
    49  
    50  ## Configuration Reference
    51  
    52  The null builder has no configuration parameters other than the
    53  [communicator](/packer/docs/templates/legacy_json_templates/communicator) settings.