github.com/muratcelep/terraform@v1.1.0-beta2-not-internal-4/website/docs/language/resources/provisioners/salt-masterless.html.md (about)

     1  ---
     2  layout: "language"
     3  page_title: "Provisioner: salt-masterless"
     4  sidebar_current: "docs-provisioners-salt-masterless"
     5  description: |-
     6    The salt-masterless Terraform provisioner provisions machines built by Terraform
     7  ---
     8  
     9  # Salt Masterless Provisioner
    10  
    11  Type: `salt-masterless`
    12  
    13  The `salt-masterless` Terraform provisioner provisions machines built by Terraform
    14  using [Salt](http://saltstack.com/) states, without connecting to a Salt master. The `salt-masterless` provisioner supports `ssh` [connections](/docs/language/resources/provisioners/connection.html).
    15  
    16  !> **Note:** This provisioner was removed in the 0.15.0 version of Terraform after being deprecated as of Terraform 0.13.4. For most common situations there are better alternatives to using provisioners. For more information, see [the main Provisioners page](./).
    17  
    18  ## Requirements
    19  
    20  The `salt-masterless` provisioner has some prerequisites. `cURL` must be available on the remote host.
    21  
    22  ## Example usage
    23  
    24  The example below is fully functional.
    25  
    26  ```hcl
    27  
    28  provisioner "salt-masterless" {
    29      "local_state_tree" = "/srv/salt"
    30  }
    31  ```
    32  
    33  ## Argument Reference
    34  
    35  The reference of available configuration options is listed below. The only
    36  required argument is the path to your local salt state tree.
    37  
    38  Optional:
    39  
    40  -   `bootstrap_args` (string) - Arguments to send to the bootstrap script. Usage
    41      is somewhat documented on
    42      [github](https://github.com/saltstack/salt-bootstrap), but the [script
    43      itself](https://github.com/saltstack/salt-bootstrap/blob/develop/bootstrap-salt.sh)
    44      has more detailed usage instructions. By default, no arguments are sent to
    45      the script.
    46  
    47  -   `disable_sudo` (boolean) - By default, the bootstrap install command is prefixed with `sudo`. When using a
    48      Docker builder, you will likely want to pass `true` since `sudo` is often not pre-installed.
    49  
    50  -   `remote_pillar_roots` (string) - The path to your remote [pillar
    51      roots](http://docs.saltstack.com/ref/configuration/master.html#pillar-configuration).
    52      default: `/srv/pillar`. This option cannot be used with `minion_config`.
    53  
    54  -   `remote_state_tree` (string) - The path to your remote [state
    55      tree](http://docs.saltstack.com/ref/states/highstate.html#the-salt-state-tree).
    56      default: `/srv/salt`. This option cannot be used with `minion_config`.
    57  
    58  -   `local_pillar_roots` (string) - The path to your local [pillar
    59      roots](http://docs.saltstack.com/ref/configuration/master.html#pillar-configuration).
    60      This will be uploaded to the `remote_pillar_roots` on the remote.
    61  
    62  -   `local_state_tree` (string) - The path to your local [state
    63      tree](http://docs.saltstack.com/ref/states/highstate.html#the-salt-state-tree).
    64      This will be uploaded to the `remote_state_tree` on the remote.
    65  
    66  -   `custom_state` (string) - A state to be run instead of `state.highstate`.
    67      Defaults to `state.highstate` if unspecified.
    68  
    69  -   `minion_config_file` (string) - The path to your local [minion config
    70      file](http://docs.saltstack.com/ref/configuration/minion.html). This will be
    71      uploaded to the `/etc/salt` on the remote. This option overrides the
    72      `remote_state_tree` or `remote_pillar_roots` options.
    73  
    74  -   `skip_bootstrap` (boolean) - By default the salt provisioner runs [salt
    75      bootstrap](https://github.com/saltstack/salt-bootstrap) to install salt. Set
    76      this to true to skip this step.
    77  
    78  -   `temp_config_dir` (string) - Where your local state tree will be copied
    79      before moving to the `/srv/salt` directory. Default is `/tmp/salt`.
    80  
    81  -   `no_exit_on_failure` (boolean) - Terraform will exit if the `salt-call` command
    82      fails. Set this option to true to ignore Salt failures.
    83  
    84  -   `log_level` (string) - Set the logging level for the `salt-call` run.
    85  
    86  -   `salt_call_args` (string) - Additional arguments to pass directly to `salt-call`. See
    87      [salt-call](https://docs.saltstack.com/ref/cli/salt-call.html) documentation for more
    88      information. By default no additional arguments (besides the ones Terraform generates)
    89      are passed to `salt-call`.
    90  
    91  -   `salt_bin_dir` (string) - Path to the `salt-call` executable. Useful if it is not
    92      on the PATH.