Minions

L'espace de travail Minions permet d'afficher les détails de minions, de rechercher ou de trier des minions par ID ou d'autres propriétés, d'exécuter des tâches ou des commandes ad hoc, et de créer des cibles. Vous pouvez également utiliser cet espace de travail pour ajuster les paramètres cibles, tels que les piliers attachés, exécuter des tâches, accepter ou rejeter des clés, et attribuer un rôle ou un pilier à une cible. Pour plus d'informations, reportez-vous à la section Minions.

Note : Dans le cadre de l'initiative de VMware visant à supprimer la terminologie problématique, le terme master Salt sera remplacé par un meilleur terme dans SaltStack Config et les produits associés, ainsi que dans la documentation. Cette mise à jour terminologique peut s'étendre sur plusieurs cycles de publication.

Gestion des minions et des cibles

L'espace de travail Minions inclut une liste de tous les minions Salt qui exécutent le service de minion et qui sont actuellement gérés par SaltStack Config. Les minions sont des nœuds exécutant le service de minion, qui peut écouter les commandes d'un master Salt et effectuer les tâches demandées. Les masters Salt peuvent eux-mêmes exécuter le service de minion, ce qui permet de configurer et de gérer le nœud exécutant le service de contrôleur Salt si nécessaire.

Le panneau latéral de l’espace de travail inclut une liste de cibles. 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. La définition d'une cible pour une tâche ou une opération empêche également l'opération de s'exécuter sur les nœuds qui ne devraient pas exécuter cette opération. Les cibles peuvent contenir des minions connectés à n'importe quel master Salt de votre environnement. Vous pouvez attacher des données de Pillar à différentes cibles. 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.

Par défaut, lorsque vous ouvrez l'espace de travail, la cible Tous les minions est active. La cible Tous les minions répertorie tous les minions auxquels vous avez accès.

Tâches ou commandes ad hoc

L'espace de travail Minions inclut également un contrôle Exécuter la commande qui vous permet d'exécuter une commande ad hoc unique sur un ou plusieurs minions sans créer de tâche réutilisable. Cette fonctionnalité est utile pour exécuter des commandes rapidement ou pour exécuter des tâches ponctuelles qui ne font pas partie de votre workflow quotidien, par exemple lors d'un dépannage ou de la configuration initiale. Consultez Exécuter une commande pour plus d'informations.

Dans l’espace de travail Minions, vous pouvez exécuter une tâche ou une commande ad hoc sur :

Minion unique
Liste de minions
Un master Salt ou tous les masters Salt (à l'aide de salt-run)
Cible

Reportez-vous à la section Workflow de tâches de SaltStack Config pour obtenir un aperçu de l'utilisation de l'espace de travail Minions avec les autres espaces de travail de SaltStack Config pour créer et utiliser des tâches pour la gestion de la configuration.

Accès à l'espace de travail Minions

Pour utiliser l'espace de travail Minions, cliquez sur Cibles dans le menu latéral.

Affichage des détails d'un minion

Pour afficher les détails d'un minion spécifique :

Dans l'espace de travail Minions, sélectionnez un ID de minion dans ID de minion pour ouvrir la page des détails du minion.
Sur la page des détails du minion, vous pouvez afficher une liste de grains ou d'informations sur le minion. Vous pouvez également exécuter une tâche ad hoc sur un minion unique.
Sélectionnez l'onglet Activité pour afficher l'historique des tâches du minion. Pour plus d'informations, consultez Tâches.

Téléchargement des données minion

Pour télécharger les données de tous les minions :

Dans l'espace de travail Minions, cliquez sur Plus d'actions pour ouvrir un menu.
Dans le menu, sous Télécharger la table, sélectionnez le format requis pour commencer le téléchargement.

Recherche d’un minion

Pour trouver un minion spécifique :

Dans l'espace de travail Minions, cliquez sur le bouton filtre de la colonne sur laquelle doit porter la recherche.
Commencez à saisir les critères de recherche pour voir le filtre de lignes instantanément. Par exemple, vous pouvez rechercher un ID de minion dans la colonne Minion.
Note :
Vous pouvez également cliquer sur n'importe quel nom de colonne pour trier les lignes par ordre décroissant. Cliquez de nouveau pour inverser l'ordre. Pour plus d'informations sur le filtrage, reportez-vous à la section Filtrage et tri des colonnes du tableau.

Filtrage et tri des colonnes du tableau

Vous pouvez filtrer chaque colonne en sélectionnant son icône de filtre filter-icon et en sélectionnant ou en entrant vos critères de filtre. Pour effacer un filtre, cliquez sur Effacer les filtres au-dessus du tableau des minions.

Vous pouvez également trier une colonne en sélectionnant son nom. Pour personnaliser les colonnes qui s'affichent dans le tableau, cliquez sur le bouton Afficher les colonnes show-columns-icon dans le coin sous le tableau des minions.

Note :

Si vous filtrez par rapport à la cible Tous les minions, ce filtre reste persistant sur toutes vos cibles.

Les filtres, le tri des colonnes et les paramètres de visibilité des colonnes sont persistants pour un utilisateur donné, quel que soit le périphérique utilisé pour se connecter. Cela signifie que lorsqu'un utilisateur particulier se connecte, il voit les mêmes paramètres de filtrage, de tri et de visibilité la prochaine fois qu'il se connecte jusqu'à ce que les filtres soient effacés ou que les paramètres de tri et de visibilité soient modifiés.

Vous pouvez également trier une colonne en sélectionnant son nom.

Exécution d'une tâche ad hoc

Dans l’espace de travail Minions, vous pouvez exécuter une tâche ou une commande ad hoc sur :

Minion unique
Liste de minions
Un master Salt ou tous les masters Salt (à l'aide de salt-run)
Cible

Note :

Les cibles sont dynamiques et de nouveaux minions sont automatiquement ajoutés à toute définition de cible correspondante. Veillez à examiner les minions inclus dans une cible avant d'exécuter une tâche.

Pour exécuter une tâche ad hoc :

Dans l'espace de travail Minions, sélectionnez le minion, la cible ou la liste des minions sur lesquels vous souhaitez exécuter la tâche :
- Pour sélectionner un seul minion ou une liste de minions, cochez la case en regard des minions dans le tableau.
- Pour sélectionner une cible, cliquez sur le nom de la cible dans le panneau latéral Cibles. Le nom de la cible actuellement sélectionnée s'affiche au-dessus de la liste des minions.
Cliquez sur Exécuter la tâche pour exécuter une tâche.
Dans la boîte de dialogue de confirmation, sélectionnez la tâche que vous souhaitez exécuter et confirmez que la cible ou les minions appropriés sont sélectionnés.
Sélectionnez des options supplémentaires si nécessaire et cliquez sur Exécuter maintenant.

Pour plus d'informations sur les tâches et les différentes options disponibles lors de l'exécution d'une tâche, reportez-vous à la section Tâches.

Note :

Vous pouvez également exécuter une tâche sur un minion unique en sélectionnant son ID de minion et en affichant la page des détails du minion.

Exécuter une commande

Dans l’espace de travail Minions, vous pouvez exécuter une tâche ou une commande ad hoc sur :

Minion unique
Liste de minions
Un master Salt ou tous les masters Salt (à l'aide de salt-run)
Cible

Note :

Pour exécuter une commande sur un ou plusieurs minions :

Dans l'espace de travail Minions, sélectionnez le minion, la cible ou la liste des minions sur lesquels vous souhaitez exécuter la tâche :
- Pour sélectionner un seul minion ou une liste de minions, cochez la case en regard des minions dans le tableau.
- Pour sélectionner une cible, cliquez sur le nom de la cible dans le panneau latéral Cibles. Le nom de la cible actuellement sélectionnée s'affiche au-dessus de la liste des minions.
Cliquez sur Exécuter la commande.
Dans la boîte de dialogue Exécuter la commande, confirmez que la commande et la cible appropriées sont sélectionnées, puis sélectionnez une fonction.
Note :
Si vous sélectionnez la commande salt-run, vous pouvez choisir d'exécuter la commande sur tous les masters Salt ou sur un master Salt spécifique. Il s'agit d'un exécuteur Salt. Pour plus d'informations, reportez-vous à la section Exécuteurs Salt.

Incluez tous les arguments éventuellement requis. Pour plus d'informations sur les commandes et fonctions Salt, reportez-vous à la section Tâches.
Cliquez sur Exécuter la commande.

La commande est exécutée en tant que tâche. Vous pouvez suivre sa progression et ses résultats comme pour d'autres tâches dans SaltStack Config. Reportez-vous à la section Retours de tâche.

Création d'une cible

Chaque cible dans SaltStack Config inclut un nom, un master Salt et des critères cibles. Pour définir une nouvelle cible incluant un ou plusieurs minions :

Dans l'espace de travail Minions, cliquez sur Tous les minions dans le panneau latéral Cibles.
Cliquez sur le bouton Créer une cible.
Dans la boîte de dialogue Créer une cible dans le champ Nom, entrez un nom descriptif pour la nouvelle cible.
Par défaut, le paramètre Tous les masters est activé, ce qui signifie que les minions gérés par un master Salt peuvent être inclus dans la cible. Cliquez sur ce bouton pour appliquer cette cible uniquement à un sous-ensemble de minions associés à un ou plusieurs masters Salt.
Si vous désactivez ce paramètre, un menu s'affiche que vous pouvez utiliser pour sélectionner le ou les masters Salt auxquels appliquer la cible. Consultez Paramètres de la cible pour plus d'informations.
Cliquez sur le menu Grain et sélectionnez le type de cible à utiliser. Vous pouvez cibler des minions à l'aide de grains, de globs, de listes ou de composés. Pour plus d'informations sur ces options de ciblage, reportez-vous à la section Paramètres de la cible. Pour plus d'informations générales sur les cibles Salt, reportez-vous à la section Ciblage de minions.
Différents paramètres et critères cibles sont disponibles en fonction du type de cible que vous avez sélectionné à l’étape précédente. Pour plus d'informations sur ces paramètres, reportez-vous à la section Paramètres de la cible.
Note :
Si vous sélectionnez Composé comme premier critère, vous devez suivre la syntaxe de ciblage incluse dans la Référence de ciblage Salt et vous devez inclure tous les critères secondaires dans la définition de cible de composé. SaltStack Config ne vous permet pas d'ajouter d'autres critères dans l'éditeur de cible. Pour plus d'informations sur le ciblage de composés, reportez-vous à la section Paramètres de la cible.
Lorsque vous avez terminé, cliquez sur Enregistrer.

Définition d’une cible de liste simple

Pour créer une nouvelle cible à l'aide d'une liste simple :

Dans l'espace de travail Minions, cliquez sur Tous les minions dans le panneau latéral Cibles.
Cochez la case en regard des minions que vous souhaitez inclure dans la liste et cliquez sur Créer la cible.
Note :
Le filtrage ou le tri de vos minions peut être utile pour définir une liste. Reportez-vous à la section Filtrage et tri des colonnes du tableau.

La liste sélectionnée est incluse en tant que critère.
Entrez un nom cible et définissez des paramètres cibles supplémentaires. Reportez-vous à la section Paramètres de la cible.
Lorsque vous avez terminé, cliquez sur Enregistrer.

Affectation d'un Pillar à une cible

Pour attribuer des données de Pillar à une cible de minions spécifique :

Dans l'espace de travail Minions, sélectionnez une cible dans le panneau latéral Cibles.
Cliquez sur Plus d'actions.
Dans le menu, cliquez sur Attacher un Pillar.
Dans la boîte de dialogue, sélectionnez les colonnes que vous souhaitez appliquer à la cible.
Outre la sélection d'un Pillar, sélectionnez Actualiser le Pillar pour rendre le Pillar disponible immédiatement pour la cible sélectionnée.
Cliquez sur Mettre à jour la cible.
Les données du Pillar sélectionné sont disponibles pour tous les minions de la cible.

Note :
Vous pouvez également attribuer un Pillar à une cible dans l'espace de travail Pillars. Consultez Pillars.

Présence de minions

La colonne Présence indique si SaltStack Config a récemment reçu des données de tâche du minion, dans un intervalle défini appelé raas_presence_expiration. Par défaut, cet intervalle est défini sur 3 600 secondes. Présence peut fournir un indicateur de la santé de la machine à l'aide de la balise Présence installée sur les minions.

Si la balise Présence est en place, les minions envoient des charges utiles d'état périodiques à leurs masters Salt, que SaltStack Config extrait ensuite, ce qui a une incidence sur l'état affiché dans la colonne Présence.

Les balises sont utilisées pour surveiller les processus non-Salt. Lorsque l'activité surveillée se produit, un événement est envoyé. Il peut être configuré pour déclencher un réacteur. Pour plus d'informations sur les balises, reportez-vous à la section Référence sur les balises Salt.

Note : Vous pouvez vérifier quelles balises sont installées et actives sur un minion en exécutant une tâche avec beacons.list sur la cible respective d'un minion. Pour plus d'informations, consultez Tâches.

SaltStack Config fournit les états Présence suivants.


État	Description
Inconnu	SaltStack Config n'a jamais vu de réponse du minion. Il s’agit de l’état par défaut pour les minions nouvellement connectés. Une fois que les minions ont reçu une commande, l'état se met à jour sur Présent.
Présent	SaltStack Config a vu des réponses du minion dans le dernier intervalle `raas_presence_expiration`, défini sur 3 600 secondes par défaut.
Déconnecté	SaltStack Config a vu une réponse du minion, mais pas dans le dernier intervalle `raas_presence_expiration`.

Paramètres de la cible

Le ciblage dans SaltStack Config est semblable au ciblage dans Open Source Salt, mais SaltStack Config dispose d'une interface simplifiée pour la définition des cibles, qui vous permet également d'enregistrer les définitions de cibles réutilisables. Pour plus d'informations sur le ciblage dans Salt, reportez-vous à la section Référence sur le ciblage Salt.

Chaque cible dans SaltStack Config inclut un nom, un master Salt et des critères cibles, décrits en détails ci-dessous.

Nom

Entrez un nom de cible. Les noms de cibles ne doivent pas nécessairement être uniques. Cela peut entraîner l'affichage de différents éléments sous le même nom dans l'interface utilisateur de SaltStack Config.

Tous les masters Salt

Par défaut, la cible inclut tous les masters Salt. Cependant, vous pouvez choisir de cibler des minions qui appartiennent uniquement à un master Salt spécifique. Par exemple, si votre environnement comporte plusieurs machines responsables de l'exécution d'une application particulière et que vous avez partitionné votre infrastructure Salt afin que ces machines soient toutes connectées à un seul master Salt, vous pouvez créer une cible qui inclut l'intégralité des sous-ensembles de minions en sélectionnant uniquement le master Salt.

Pour activer le targeting par Salt master, cliquez sur ce bouton radio pour désactiver ce paramètre. Un nouveau groupe de paramètres s'affiche.

Sous le champ Master, sélectionnez un master Salt dont vous souhaitez cibler les minions. Tous les critères cibles supplémentaires sont appliqués uniquement au sous-ensemble de minions associés au master Salt sélectionné.

Critères cibles

Utilisez des critères cibles pour spécifier un groupe de minions, faisant référence aux descriptions de champ suivantes.

Les cibles sont dynamiques et de nouveaux minions sont automatiquement ajoutés à toute définition de cible correspondante. L'enregistrement de votre cible dans une liste empêche l'ajout automatique de nouveaux minions correspondant au paramètre de cible dynamique à une cible.


Type de cible	Description
Grain	Faire correspondre une valeur de grain spécifique, par exemple `osfullname` est `Debian`. Une fois que vous avez sélectionné un grain, la liste de valeurs se préremplit pour que vous puissiez cliquer sur le champ afin d'afficher les options disponibles ou de commencer à entrer une valeur. Pour plus d'informations, reportez-vous à la section Référence sur les grains Salt. Note : Lors de la création de cibles de composés à l'aide de grains, RaaS ne retourne aucun minion si le nom du grain inclut un espace. Pour cette raison, tout espace est automatiquement converti en `?`.
Glob	Correspondance de caractère générique à l'aide de l'ID du minion. Par exemple, vous pouvez entrer `webserver*` pour sélectionner plusieurs minions, nommés `webserver01`, `webserver02` et `webserver03`.
Liste	Spécifiez une liste de sérions à inclure dans la cible. Par exemple, `dc3-north-db1,dc3-north-db2`. Note : La spécification d'une liste est utile si vous ne souhaitez pas accorder dynamiquement l'accès aux cibles. Cela empêche l'ajout automatique à une cible de nouveaux minions correspondant aux critères dynamiques de la cible.
Composé	Combinez plusieurs interfaces cibles, séparées par des conjonctions et, ou non. Pour tirer parti du ciblage de composés dans SaltStack Config, examinez d'abord le ciblage de composés dans la Référence sur le ciblage Salt. Note : Si vous sélectionnez Composé comme critère, vous devez suivre la syntaxe de ciblage de composés de Salt et inclure tout critère secondaire dans la définition de cible de composé. SaltStack Config ne vous permet pas d'inclure d'autres types de critères en plus d'un critère Composé.