Add deploy script document

This commit is contained in:
Thomas S Hatch 2012-06-23 21:53:16 -06:00
parent c73a219dd2
commit 7b95c5f1d3

25
doc/topics/deploy.rst Normal file
View File

@ -0,0 +1,25 @@
========================
OS Support for Cloud VMS
========================
Salt cloud works primarily by executing a script on the virtual machines as
soon as they become available. The script that is executed is referenced in
the cloud profile as the ``os``.
The scipt should eb written in bash and is a Jinja template. Deploy scripts
need to execute a number of functions to do a complate salt setup. These
functions include:
1. Install the salt minion, if this can be done via system packages this method
is HIGHLY preferred.
2. Add the salt minion keys before the minion is started for the first time.
The minion keys are available as strings that can be copied into place in
the Jinja template under the dict named "vm"
3. Start the salt-minion daemon and enable it at startup time.
4. Set up the minion configuration file from the "minion" data available in
the Jinja template.
A good, well commented, example of this process is the Fedora deployment
script:
https://github.com/saltstack/salt-cloud/blob/master/saltcloud/deploy/Fedora.sh