SaltStack Config fournit plusieurs cibles et tâches par défaut, ainsi que des fichiers de prise en charge et des données de Pillar. Les exemples de fichiers de tâche et de données de Pillar sont placés dans l'environnement Salt afin qu'ils n'interfèrent pas avec les fichiers et les données de Pillar de l'environnement . L'exemple de contenu inclut des cibles, des tâches, des données de Pillar et des fichiers de support.

Pour tester la fonctionnalité de base de SaltStack Config, essayez d'utiliser des exemples de contenu dans l'interface utilisateur. Vous devrez peut-être installer le service de minion Salt sur plusieurs nœuds que vous souhaitez gérer avant d'essayer l'exemple de contenu.

Les exemples de fichiers de tâche et de données de Pillar sont placés dans l'environnement Salt sse afin qu'ils n'interfèrent pas avec les fichiers et les données de Pillar de l'environnement base. Pour plus d'informations, consultez Environnements.

Une cible est le groupe de minions, dans un ou plusieurs masters Salt, à qui s'applique la commande Salt d'une tâche. Un master Salt peut également être géré comme un minion et peut être une cible s'il exécute le service de minion. Pour plus d'informations, consultez Minions.

Les tâches servent à exécuter des tâches à distance, à appliquer des états et à démarrer des activités Salt. Pour plus d'informations, consultez Tâches.

Les fichiers dans SaltStack Config sont utiles pour configurer les états que vous pouvez ensuite appliquer via des tâches. Les fichiers sont stockés dans le serveur de fichiers. Le serveur de fichiers est un emplacement permettant de stocker des fichiers spécifiques de Salt, tels que des fichiers principaux ou des fichiers d'état, ainsi que des fichiers qui peuvent être distribués à des minions, tels que des fichiers de configuration système. Pour plus d'informations, consultez Serveur de fichiers.

Les Pillars sont des structures de données définies sur le master Salt et transmises à un ou plusieurs minions, à l'aide de cibles. Ils permettent l'envoi sécurisé de données confidentielles et ciblées uniquement au minion approprié. Pour plus d'informations, reportez-vous à la section Pillars.

Utilisation d'exemples de SaltStack Config

Les exemples sont utilisés pour gagner du temps lors de la configuration de votre environnement SaltStack Config. Avec les tâches par défaut, vous pouvez tirer parti des fichiers d'état prédéfinis et des données de Pillar pour commencer à exécuter des opérations fréquemment utilisées.

Vous pouvez également vous référer à des exemples en tant que modèle pour savoir comment différents éléments système sont configurés pour fonctionner ensemble lorsque vous créez vos propres workflows.

Cibles par défaut

SaltStack Config inclut une plage de groupes cibles par défaut contenant tous les minions d'un système d'exploitation donné. Les cibles par défaut suivantes sont définies en faisant correspondre le grain os.

  • CentOS
  • Linux
  • MacOS
  • RedHat
  • SUSE
  • Ubuntu
  • Windows
  • Serveurs Windows

Pour plus d'informations, consultez Minions.

Exemples de tâches

SaltStack Config fournit diverses tâches d'état et d'exécution à distance. Chacune est décrite en détails ci-dessous, avec une description des fichiers et des Pillars associés, le cas échéant.

Activer la présence

Permet une détection de présence plus précise. La présence indique si SaltStack Config a récemment reçu des données de tâche du minion, dans un intervalle défini. Pour plus d'informations, reportez-vous à la section Présence d'un minion.

Highstate

Exécute un state.highstate sur des minions ciblés. Un highstate est un module d'état qui applique tous les états configurés dans le fichier top.sls. top.sls doit être défini par l'utilisateur et n'est pas inclus comme exemple de fichier. Pour plus d'informations, consultez Tâches.

Exemple Apache

fichiers
sse/apache/init.sls
pillar
Aucune

Installe Apache. Cet état contient une logique pour déterminer le nom correct du module Apache en fonction du système d'exploitation cible.

Exemple d'utilisation de disque

Exécute la commande disk.usage sur les minions ciblés.

Exemple DokuWiki

fichiers
sse/dokuwiki/init.sls,sse/dokuwiki/files/*
inclut
PHP, Apache
personnalisation du Pillar
  • dokuwiki_url : définit le chemin d'accès de l'URL où le wiki doit se trouver, par défaut wiki.
  • wiki_title : définit le titre wiki, par défaut MyWiki.

Exemple d'installation HTOP

fichiers
sse/htop/init.sls
pillar
Aucune

Installe HTOP.

Exemple de suppression HTOP

fichiers
sse/htop/remove.sls
pillar
Aucune

Supprime HTOP.

Exemple de pile LAMP

fichiers
sse/LAMP/init.sls
inclut
mySQL, PHP, Apache
personnalisation du Pillar
  • db_user : par défaut dbuser.
  • db_name : par défaut dbname.
  • db_pass : par défaut password.
  • db_host : par défaut localhost.

Installe Apache, mySQL et PHP.

Exemple mySQL

fichiers
sse/mysql/init.sls
pillar
Aucune

Installe mySQL.

Exemple PHP

fichiers
sse/php/init.sls
pillar
Aucune

Installe PHP.

Exemple de Pillar d'actualisation

Actualise le Pillar Salt sur les minions ciblés. Exécutez cette opération après avoir attribué des données de pilier à des minions.

Exemple WordPress

fichiers
sse/wordpress/init.sls
pillar
Aucune

Installe WordPress.

test.ping

Exécute la commande test.ping sur les minions ciblés.