Skip to content

Commit 6da56af

Browse files
committed
Info about the Salt stack
1 parent d13792a commit 6da56af

File tree

1 file changed

+51
-0
lines changed

1 file changed

+51
-0
lines changed

docs/scenarios/admin.rst

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,57 @@ programs, and host grouping.
6868

6969
`Fabric Documentation <http://docs.fabfile.org>`_
7070

71+
Salt
72+
----
73+
74+
`Salt <http://saltstack.org/>`_ is an open source infrastructure management tool.
75+
It supports remote command execution from a central point (master host) to multiple
76+
hosts (minions). It also supports system states which can be used to configure
77+
multiple servers using simple template files.
78+
79+
Salt supports python versions 2.6 and 2.7 and can be installed via pip:
80+
81+
.. code-block:: bash
82+
83+
$ pip install salt
84+
85+
After configuring a master server and any number of minion hosts, we can run arbitrary
86+
shell commands or use pre-built modules of complex commands on our minions.
87+
88+
The following command lists all available minion hosts, using the ping module.
89+
90+
.. code-block:: bash
91+
92+
$ salt '*' test.ping
93+
94+
The host filtering is acomplished by matching the minion id, or using the grains system.
95+
The `grains <http://docs.saltstack.org/en/latest/topics/targeting/grains.html>`_ system
96+
uses static host information like the operating system version or the CPU architecture to
97+
provide a host taxonomy for the salt modules.
98+
99+
The following command lists all available minions running CentOS using the grains system:
100+
101+
.. code-block:: bash
102+
103+
$ salt -G 'os:CentOS' test.ping
104+
105+
Salt also provides a state system. States can be used to configure the minion hosts.
106+
107+
For example, when a minion host is ordered to read the following state file, will install
108+
and start the Apache server:
109+
110+
.. code-block:: yaml
111+
112+
apache:
113+
pkg:
114+
- installed
115+
service:
116+
- running
117+
118+
State files can be written using YAML, the Jinja2 template system or pure python.
119+
120+
`Salt Documentation <http://docs.saltstack.org/en/latest/index.html>`_
121+
71122
Chef
72123
----
73124

0 commit comments

Comments
 (0)