website: better salt-masterless docs
This commit is contained in:
parent
f7cbdf4112
commit
09ffe83e50
|
@ -0,0 +1,38 @@
|
||||||
|
---
|
||||||
|
layout: "docs"
|
||||||
|
---
|
||||||
|
|
||||||
|
# Salt Masterless Provisioner
|
||||||
|
|
||||||
|
Type: `salt-masterless`
|
||||||
|
|
||||||
|
The salt-masterless provisioner provisions machines built by Packer using [Salt](http://saltstack.com/) states.
|
||||||
|
|
||||||
|
## Basic Example
|
||||||
|
|
||||||
|
The example below is fully functional.
|
||||||
|
|
||||||
|
<pre class="prettyprint">
|
||||||
|
{
|
||||||
|
"type": "salt-masterless",
|
||||||
|
"bootstrap_args": "git v0.16.0"
|
||||||
|
"local_state_tree": "/Users/me/salt"
|
||||||
|
}
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
## Configuration Reference
|
||||||
|
|
||||||
|
The reference of available configuration options is listed below. The only required argument is the path to your local salt state tree.
|
||||||
|
|
||||||
|
Required:
|
||||||
|
|
||||||
|
* `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 `/srv/salt` on the remote, and removed before shutdown.
|
||||||
|
|
||||||
|
Optional:
|
||||||
|
|
||||||
|
* `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.
|
||||||
|
|
||||||
|
* `boostrap_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.
|
||||||
|
|
||||||
|
* `temp_config_dir` (string) - Where your local state tree will be copied before moving to the `/srv/salt` directory. Default is `/tmp/salt`.
|
|
@ -6,7 +6,8 @@ layout: "docs"
|
||||||
|
|
||||||
Type: `salt-masterless`
|
Type: `salt-masterless`
|
||||||
|
|
||||||
The salt-masterless provisioner provisions machines built by Packer using [Salt](http://saltstack.com/) states.
|
The `salt-masterless` provisioner provisions machines built by Packer using
|
||||||
|
[Salt](http://saltstack.com/) states, without connecting to a Salt master.
|
||||||
|
|
||||||
## Basic Example
|
## Basic Example
|
||||||
|
|
||||||
|
@ -15,7 +16,6 @@ The example below is fully functional.
|
||||||
<pre class="prettyprint">
|
<pre class="prettyprint">
|
||||||
{
|
{
|
||||||
"type": "salt-masterless",
|
"type": "salt-masterless",
|
||||||
"bootstrap_args": "git v0.16.0"
|
|
||||||
"local_state_tree": "/Users/me/salt"
|
"local_state_tree": "/Users/me/salt"
|
||||||
}
|
}
|
||||||
</pre>
|
</pre>
|
||||||
|
@ -26,13 +26,22 @@ The reference of available configuration options is listed below. The only requi
|
||||||
|
|
||||||
Required:
|
Required:
|
||||||
|
|
||||||
* `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 `/srv/salt` on the remote, and removed before shutdown.
|
* `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 `/srv/salt` on the remote, and removed before
|
||||||
|
shutdown.
|
||||||
|
|
||||||
Optional:
|
Optional:
|
||||||
|
|
||||||
* `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.
|
* `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.
|
||||||
|
|
||||||
* `boostrap_args` (string) -
|
* `boostrap_args` (string) - Arguments to send to the bootstrap script. Usage
|
||||||
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.
|
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.
|
||||||
|
|
||||||
* `temp_config_dir` (string) - Where your local state tree will be copied before moving to the `/srv/salt` directory. Default is `/tmp/salt`.
|
* `temp_config_dir` (string) - Where your local state tree will be copied
|
||||||
|
before moving to the `/srv/salt` directory. Default is `/tmp/salt`.
|
||||||
|
|
|
@ -38,6 +38,7 @@
|
||||||
<li><h4>Provisioners</h4></li>
|
<li><h4>Provisioners</h4></li>
|
||||||
<li><a href="/docs/provisioners/shell.html">Shell Scripts</a></li>
|
<li><a href="/docs/provisioners/shell.html">Shell Scripts</a></li>
|
||||||
<li><a href="/docs/provisioners/file.html">File Uploads</a></li>
|
<li><a href="/docs/provisioners/file.html">File Uploads</a></li>
|
||||||
|
<li><a href="/docs/provisioners/salt-masterless.html">Salt</a></li>
|
||||||
<li><a href="/docs/provisioners/custom.html">Custom</a></li>
|
<li><a href="/docs/provisioners/custom.html">Custom</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue