salt-stack Getting started with salt-stack
Remarks
This section provides an overview of what salt-stack is, and why a developer might want to use it.
It should also mention any large subjects within salt-stack, and link out to the related topics. Since the Documentation for salt-stack is new, you may need to create initial versions of those related topics.
Versions
| Versions | Status | Release Date |
|---|---|---|
| 2016.3.2 | Latest Stable release | 2016-08-02 |
| 2016.3.1 | 2016-06-09 | |
| 2016.3.0 | 2016-05-26 | |
| 2015.8.11 | Previous Stable release | 2016-06-14 |
| 2015.8.10 | 2016-05-20 | |
| 2015.8.9 | 2016-05-17 | |
| 2015.8.8 | 2016-03-17 | |
| 2015.8.7 | 2016-02-11 | |
| 2015.8.6 | 2016-02-04 | |
| 2015.8.5 | 2016-02-02 | |
| 2015.8.4 | 2016-01-25 | |
| 2015.8.3 | 2015-11-25 | |
| 2015.8.2 | 2015-11-13 | |
| 2015.8.1 | 2015-10-01 | |
| 2015.8.0 | 2015-09-09 | |
| 2015.5.11 | 2016-05-20 | |
| 2015.5.10 | 2016-03-11 | |
| 2015.5.9 | 2016-01-09 | |
| 2015.5.8 | 2015-11-24 | |
| 2015.5.7 | 2015-11-13 | |
| 2015.5.6 | 2015-10-01 | |
| 2015.5.5 | 2015-08-20 | |
| 2015.5.4 | 2015-08-13 | |
| 2015.5.3 | 2015-07-01 | |
| 2015.5.2 | 2015-06-03 | |
| 2015.5.1 | 2015-05-20 | |
| 2015.5.0 | 2015-05-06 | |
| 2014.7.9 | 2016-03-11 | |
| 2014.7.8 | 2015-11-13 | |
| 2014.7.7 | 2015-10-01 | |
| 2014.7.6 | 2015-05-18 | |
| 2014.7.5 | 2015-04-16 | |
| 2014.7.4 | 2015-03-30 | |
| 2014.7.3 | 2015-03-25 | |
| 2014.7.2 | 2015-02-09 | |
| 2014.7.1 | 2015-01-13 | |
| 2014.7.0 | 2015-11-03 |
Command Syntax
Salt commands are executed using a common structure:
salt '*' pkg.install vim
[target] [module.function] [arguments]
The target determines which systems apply the command. In the example above we target all ('*' ) the Salt minions. See the targeting minions documentation for more information about targeting Salt minions.
The command (module.function) is the function to execute. In the above example we use the pkg.install function to tell the targets to install a package.
The arguments provide any extra data that is needed by the function you are calling. In the example above we tell the pkg.install function to install the package named vim .
Installation or Setup
Salt can be installed via :
salt-bootstrap: a shell script, that can install salt (client and/or master packages) on standard Unix/Linux platform,- Platform Specific binaries: available for Windows, Mac OS X and Linux,
- Package Management systems: available for pacman, apt-get, yum and other package management systems.
Salt Installation via Salt-Bootstrap
Download Salt:
- via curl:
curl -o bootstrap_salt.sh -L https://bootstrap.saltstack.com - via wget:
wget -O bootstrap_salt.sh https://bootstrap.saltstack.com
bootstrap_salt.sh provides many options. Among them executing the script with:
-Mflag will installsalt-master,-Nflag will not installsalt-minionpackage,-Aflag can be used to define thesalt-masterip.
It can be invoked with the version of salt to be installed.
Common pattern are:
sh bootstrap_salt.sh -M -N stableto install a "stable" salt master,sh bootstrap_salt.sh -A <ip> stableto install a "stable" salt minion, with the master IP defined.
Official Documentation can be found here.
Salt Installation via platform specific binaries:
Latest stable installers can be found here:
Salt Installation via package management systems
Under Ubuntu 16.04
- add the saltstack repository key to APT via:
wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add - - add the repository in apt configuration via
sudo echo "deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest denial main" > /etc/apt/sources.list.d/saltstack.list - update your apt cache via
apt-get update
If you wish to install a salt-master run apt-get install salt-master , otherwise apt-get install salt-minion .
Instructions for other OSes can be found here
Version Numbers
As of Salt version 2014.1.0 , Salt uses a date based system for version numbers. Version numbers are in the format YYYY.MM.R . The year (YYYY ) and month (MM ) indicate when the release was created. The bugfix release number (R ) increments within that feature release.
In order to distinguish future releases from the current release, code names are used. Salt uses the periodic table to derive the next codename. The first release in the date based system was code name Hydrogen , each subsequent release will go to the next atomic release.
