github.com/rstandt/terraform@v0.12.32-0.20230710220336-b1063613405c/website/docs/provisioners/salt-masterless.html.md (about)

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