github.com/hugorut/terraform@v1.1.3/website/docs/language/resources/provisioners/salt-masterless.mdx (about)

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