github.com/mmcquillan/packer@v1.1.1-0.20171009221028-c85cf0483a5d/website/source/docs/provisioners/shell-local.html.md (about)

     1  ---
     2  description: |
     3      The shell Packer provisioner provisions machines built by Packer using shell
     4      scripts. Shell provisioning is the easiest way to get software installed and
     5      configured on a machine.
     6  layout: docs
     7  page_title: 'Shell (Local) - Provisioners'
     8  sidebar_current: 'docs-provisioners-shell-local'
     9  ---
    10  
    11  # Local Shell Provisioner
    12  
    13  Type: `shell-local`
    14  
    15  The local shell provisioner executes a local shell script on the machine running
    16  Packer. The [remote shell](/docs/provisioners/shell.html) provisioner executes
    17  shell scripts on a remote machine.
    18  
    19  ## Basic Example
    20  
    21  The example below is fully functional.
    22  
    23  ``` json
    24  {
    25    "type": "shell-local",
    26    "command": "echo foo"
    27  }
    28  ```
    29  
    30  ## Configuration Reference
    31  
    32  The reference of available configuration options is listed below. The only
    33  required element is "command".
    34  
    35  Required:
    36  
    37  -   `command` (string) - The command to execute. This will be executed within
    38      the context of a shell as specified by `execute_command`.
    39  
    40  Optional parameters:
    41  
    42  -   `execute_command` (array of strings) - The command to use to execute
    43      the script. By default this is `["/bin/sh", "-c", "{{.Command}}"]`. The value
    44      is an array of arguments executed directly by the OS. The value of this is
    45      treated as [configuration
    46      template](/docs/templates/engine.html). The only available
    47      variable is `Command` which is the command to execute.