github.com/eliastor/durgaform@v0.0.0-20220816172711-d0ab2d17673e/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  !> **Warning:** This provisioner was removed in the 0.15.0 version of Terraform after being deprecated as of Terraform 0.13.4. Provisioners should also be a last resort. There are better alternatives for most situations. Refer to
    16  [Declaring Provisioners](/language/resources/provisioners/syntax) for more details.
    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](https://docs.saltproject.io/en/latest/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](https://docs.saltproject.io/en/latest/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](https://docs.saltproject.io/en/latest/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](https://docs.saltproject.io/en/latest/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](https://docs.saltproject.io/en/latest/ref/configuration/minion.html). This will be uploaded to the `/etc/salt` on the remote. This option overrides the `remote_state_tree` or `remote_pillar_roots` options.
    71  
    72  - `skip_bootstrap` (boolean) - By default the salt provisioner runs [salt
    73    bootstrap](https://github.com/saltstack/salt-bootstrap) to install salt. Set
    74    this to true to skip this step.
    75  
    76  - `temp_config_dir` (string) - Where your local state tree will be copied
    77    before moving to the `/srv/salt` directory. Default is `/tmp/salt`.
    78  
    79  - `no_exit_on_failure` (boolean) - Terraform will exit if the `salt-call` command
    80    fails. Set this option to true to ignore Salt failures.
    81  
    82  - `log_level` (string) - Set the logging level for the `salt-call` run.
    83  
    84  - `salt_call_args` (string) - Additional arguments to pass directly to `salt-call`. See
    85    [salt-call](https://docs.saltproject.io/en/latest/ref/cli/salt-call.html) documentation for more
    86    information. By default no additional arguments (besides the ones Terraform generates)
    87    are passed to `salt-call`.
    88  
    89  - `salt_bin_dir` (string) - Path to the `salt-call` executable. Useful if it is not
    90    on the PATH.