saltstack/salt
1
0
Fork 0
mirror of https://github.com/saltstack/salt.git synced 2025-04-17 10:10:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Updated Salt version requirements for Formulas

Browse source
This commit is contained in:
Seth House 2013-08-27 11:47:50 -06:00
parent 81ba8889da
commit cbf0b79ab5
1 changed files with 15 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
doc/topics/conventions/formulas.rst
View file

@ -4,24 +4,28 @@
Salt Formulas
=============
.. note:: Salt version requirements
Many Formulas require Salt 0.16.4 or later although this can currently be
side-stepped by copying the newer version of :blob:`salt/modules/grains.py`
into the :file:`/srv/salt/_modules` directory and it will be automatically
distributed to all minions.
Formulas are pre-written Salt States. They are as open-ended as Salt States
themselves and can be used for tasks such as installing a package, configuring
and starting a service, setting up users or permissions, and many other common
tasks.
.. seealso:: Salt Formula repositories
.. note:: Formulas require Salt 0.17 or later.
All official Salt Formulas are found as separate Git repositories in the
"saltstack-formulas" organization on GitHub:
More accurately, Formulas are not tested on earlier versions of Salt so
your milage may vary.
https://github.com/saltstack-formulas
All Formulas require the grains execution module that shipped with Salt
0.16.4. Earlier Salt versions may copy :blob:`salt/modules/formula_util.py`
into the :file:`/srv/salt/_modules` directory and it will be automatically
distributed to all minions.
Some Formula utilize features added in Salt 0.17 and will not work on
earlier Salt versions.
All official Salt Formulas are found as separate Git repositories in the
"saltstack-formulas" organization on GitHub:
https://github.com/saltstack-formulas
As an example, quickly install and configure the popular memcached server using
sane defaults simply by including the :formula:`memcached-formula` repository