Commencer avec la pile de sel

Installation ou configuration

Le sel peut être installé via :

  • salt-bootstrap : un script shell, qui peut installer salt (packages client et/ou maître) sur la plate-forme standard Unix/Linux,
  • Binaires spécifiques à la plate-forme : disponibles pour Windows, Mac OS X et Linux,
  • Systèmes de gestion de paquets : disponibles pour pacman, apt-get, yum et d’autres systèmes de gestion de paquets.

Installation de sel via Salt-Bootstrap

Télécharger 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 fournit de nombreuses options. Parmi eux exécutant le script avec :

  • Le drapeau -M installera salt-master,
  • Le drapeau -N n’installera pas le paquet salt-minion,
  • Le drapeau -A peut être utilisé pour définir l’ip salt-master.

Il peut être appelé avec la version de sel à installer.

Les modèles communs sont :

  • sh bootstrap_salt.sh -M -N stable pour installer un maître de sel “stable”,
  • sh bootstrap_salt.sh -A <ip> stable pour installer un minion de sel “stable”, avec l’IP maître définie.

La documentation officielle peut être trouvée ici.

Installation de Salt via des binaires spécifiques à la plate-forme :

Les derniers installateurs stables peuvent être trouvés ici :

  • Windows
  • [Mac OS] (https://docs.saltstack.com/en/latest/topics/installation/osx.html)

Installation de sel via des systèmes de gestion de packages

Sous Ubuntu 16.04

  • ajoutez la clé du référentiel saltstack à 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

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.

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.