0
0
mirror of https://github.com/saltstack-formulas/salt-formula.git synced 2024-11-28 05:07:54 +01:00
salt-formula/README.rst
2014-10-17 10:21:24 +02:00

68 lines
1.6 KiB
ReStructuredText

====
salt
====
Yes, Salt can Salt itself!
.. note::
See the full `Salt Formulas installation and usage instructions
<http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
Available states
================
.. contents::
:local:
``salt.minion``
---------------
Install a minion
``salt.master``
---------------
Install a master.
``salt.syndic``
---------------
Install a syndic.
``salt.cloud``
---------------
Install salt cloud.
``Configuration``
=================
Every option available in the templates can be set in pillar. Settings under 'salt' will be overridden by more specific settings under ``salt['master']``, ``salt['minion']`` or ``salt['cloud']``
::
salt:
ret_port: 4506
master:
user: saltuser
...
minion:
user: saltuser
...
cloud:
providers: ec2
...
``Extending``
=============
Additional templates can be added by the user under salt/files/minion.d and master.d. This might be useful if, for example, a recently-added configuration option is not yet provided by the default template.
``Vagrant``
===========
Executing the provided `Vagrantfile <http://www.vagrantup.com/>`_ will create a Ubuntu 14.04 VM, add the default Saltstack Repository and install the current stable version.
The folders inside the VM will be set up in a way that enables you to simply execute 'sudo salt "*" state.highstate' to apply the salt formula to the VM, using the pillar.example config. You can check /etc/salt/ for results.
Remember, you will have to run ``state.highstate`` or ``state.sls salt.(master|minion|cloud)`` manually.