packer-cn/website/source/docs/provisioners/shell-local.html.md

1.3 KiB

layout sidebar_current page_title description
docs docs-provisioners-shell-local Shell (Local) - Provisioners The shell Packer provisioner provisions machines built by Packer using shell scripts. Shell provisioning is the easiest way to get software installed and configured on a machine.

Local Shell Provisioner

Type: shell-local

The local shell provisioner executes a local shell script on the machine running Packer. The remote shell provisioner executes shell scripts on a remote machine.

Basic Example

The example below is fully functional.

{
  "type": "shell-local",
  "command": "echo foo"
}

Configuration Reference

The reference of available configuration options is listed below. The only required element is "command".

Required:

  • command (string) - The command to execute. This will be executed within the context of a shell as specified by execute_command.

Optional parameters:

  • execute_command (array of strings) - The command to use to execute the script. By default this is ["/bin/sh", "-c", "{{.Command}}"]. The value is an array of arguments executed directly by the OS. The value of this is treated as configuration template. The only available variable is Command which is the command to execute.