packer-cn/website/source/docs/provisioners/salt-masterless.html.md

79 lines
3.1 KiB
Markdown
Raw Normal View History

2013-07-26 17:15:02 -04:00
---
2015-07-22 22:31:00 -04:00
description: |
The `salt-masterless` Packer provisioner provisions machines built by Packer
using Salt states, without connecting to a Salt master.
layout: docs
page_title: 'Salt (Masterless) Provisioner'
...
2013-07-26 17:15:02 -04:00
2013-07-29 02:30:03 -04:00
# Salt Masterless Provisioner
2013-07-26 17:15:02 -04:00
2013-07-29 02:30:03 -04:00
Type: `salt-masterless`
2013-07-26 17:15:02 -04:00
2015-07-22 22:31:00 -04:00
The `salt-masterless` Packer provisioner provisions machines built by Packer
using [Salt](http://saltstack.com/) states, without connecting to a Salt master.
2013-07-26 17:15:02 -04:00
## Basic Example
The example below is fully functional.
2015-07-22 22:31:00 -04:00
``` {.javascript}
2013-07-26 17:15:02 -04:00
{
"type": "salt-masterless",
"local_state_tree": "/Users/me/salt"
2013-07-26 17:15:02 -04:00
}
```
2013-07-26 17:15:02 -04:00
## Configuration Reference
2015-07-22 22:31:00 -04:00
The reference of available configuration options is listed below. The only
required argument is the path to your local salt state tree.
2013-07-26 17:15:02 -04:00
Optional:
2013-07-27 02:36:14 -04:00
2015-07-22 23:25:58 -04:00
- `bootstrap_args` (string) - Arguments to send to the bootstrap script. Usage
is somewhat documented on
[github](https://github.com/saltstack/salt-bootstrap), but the [script
itself](https://github.com/saltstack/salt-bootstrap/blob/develop/bootstrap-salt.sh)
has more detailed usage instructions. By default, no arguments are sent to
the script.
- `disable_sudo` (boolean) - By default, the bootstrap install command is prefixed with `sudo`. When using a
Docker builder, you will likely want to pass `true` since `sudo` is often not pre-installed.
- `remote_pillar_roots` (string) - The path to your remote [pillar
roots](http://docs.saltstack.com/ref/configuration/master.html#pillar-configuration).
default: `/srv/pillar`. This option cannot be used with `minion_config`.
- `remote_state_tree` (string) - The path to your remote [state
tree](http://docs.saltstack.com/ref/states/highstate.html#the-salt-state-tree).
default: `/srv/salt`. This option cannot be used with `minion_config`.
2015-07-22 23:25:58 -04:00
- `local_pillar_roots` (string) - The path to your local [pillar
roots](http://docs.saltstack.com/ref/configuration/master.html#pillar-configuration).
This will be uploaded to the `remote_pillar_roots` on the remote.
2015-07-22 23:25:58 -04:00
- `local_state_tree` (string) - The path to your local [state
tree](http://docs.saltstack.com/ref/states/highstate.html#the-salt-state-tree).
This will be uploaded to the `remote_state_tree` on the remote.
2015-07-22 23:25:58 -04:00
2016-10-07 21:00:21 -04:00
- `custom_state` (string) - A state to be run instead of `state.highstate`.
Defaults to `state.highstate` if unspecified.
2015-07-31 00:16:11 -04:00
- `minion_config` (string) - The path to your local [minion config
file](http://docs.saltstack.com/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.
2015-07-22 23:25:58 -04:00
- `skip_bootstrap` (boolean) - By default the salt provisioner runs [salt
bootstrap](https://github.com/saltstack/salt-bootstrap) to install salt. Set
this to true to skip this step.
- `temp_config_dir` (string) - Where your local state tree will be copied
before moving to the `/srv/salt` directory. Default is `/tmp/salt`.
- `no_exit_on_failure` (boolean) - Packer will exit if the `salt-call` command
fails. Set this option to true to ignore Salt failures.
- `log_level` (string) - Set the logging level for the `salt-call` run.