mirror of
https://github.com/hashicorp/packer.git
synced 2026-06-16 03:59:00 -04:00
50da6c8dc8
* Adding check-legacy-links-format workflow * Adding test-link-rewrites workflow * Migrating links to new format * Updating docs-content-check-legacy-links-format hash * chore: update source * Update generated partials from Packer plugin SDK * Bump packer-plugin-sdk to get latest packer-sdc * Update website/content/docs/templates/hcl_templates/blocks/build/provisioner.mdx * Update Plugin SDK to fix shell-local regression --------- Co-authored-by: Kendall Strautman <kendallstrautman@gmail.com> Co-authored-by: Wilken Rivera <wilken@hashicorp.com> Co-authored-by: Kendall Strautman <36613477+kendallstrautman@users.noreply.github.com>
61 lines
1.3 KiB
Text
61 lines
1.3 KiB
Text
---
|
|
description: |
|
|
The null Packer builder is not really a builder, it just sets up an SSH
|
|
connection and runs the provisioners. It can be used to debug provisioners
|
|
without incurring high wait times. It does not create any kind of image or
|
|
artifact.
|
|
page_title: Null - Builders
|
|
---
|
|
|
|
<BadgesHeader>
|
|
<PluginBadge type="official" />
|
|
</BadgesHeader>
|
|
|
|
# Null Builder
|
|
|
|
Type: `null`
|
|
|
|
The `null` Packer builder is not really a builder, it just sets up an SSH
|
|
connection and runs the provisioners. It can be used to debug provisioners
|
|
without incurring high wait times. It does not create any kind of image or
|
|
artifact.
|
|
|
|
## Basic Example
|
|
|
|
Below is a fully functioning example. It doesn't do anything useful, since no
|
|
provisioners are defined, but it will connect to the specified host via ssh.
|
|
|
|
<Tabs>
|
|
<Tab heading="JSON">
|
|
|
|
```json
|
|
{
|
|
"type": "null",
|
|
"ssh_host": "127.0.0.1",
|
|
"ssh_username": "foo",
|
|
"ssh_password": "bar"
|
|
}
|
|
```
|
|
|
|
</Tab>
|
|
<Tab heading="HCL2">
|
|
|
|
```hcl
|
|
source "null" "basic-example" {
|
|
ssh_host = "127.0.0.1"
|
|
ssh_username = "foo"
|
|
ssh_password = "bar"
|
|
}
|
|
|
|
build {
|
|
sources = ["sources.null.basic-example"]
|
|
}
|
|
```
|
|
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## Configuration Reference
|
|
|
|
The null builder has no configuration parameters other than the
|
|
[communicator](/packer/docs/templates/legacy_json_templates/communicator) settings.
|