L'espace de travail Plug-ins master vous permet de mettre à jour la version du plug-in master sur votre master Salt pour qu'elle corresponde à la version d'SaltStack Config. Cette fonctionnalité est prise en charge pour les déploiements cloud et sur site. Vous pouvez également télécharger la dernière version du plug-in master.

L'espace de travail Plug-ins master fournit des informations sur l'état du plug-in, la version du plug-in, la version Salt, le JID de la dernière mise à jour, etc. La dernière version de sseapiclient est également disponible via l'espace de travail Plug-ins master. Pour plus d'informations, reportez-vous à la section Utilisation de l'API.

Le plug-in master permet à vos masters Salt de communiquer avec SaltStack Config. Le plug-in inclut également divers paramètres que vous pouvez ajuster pour améliorer les performances. Pour plus d'informations, reportez-vous à la référence des paramètres de configuration du plug-in master.

RaaS contient les versions actuelles et précédentes du plug-in master. Lorsque le master Salt se connecte à RaaS, le master Salt vérifie si RaaS dispose de versions de plug-in dont il ne dispose pas. Si le master Salt ne dispose pas de ces versions de plug-in, le master Salt récupère les plug-ins de RaaS et les met en cache localement dans /var/cache/salt/master/plugin_cache/.

Le plug-in n'est pas mis à jour automatiquement dès qu'une nouvelle version de SaltStack Config est disponible. Vous devez initier le processus de mise à jour vous-même. Il est recommandé d'effectuer une mise à jour vers la dernière version du plug-in lorsque celle-ci est disponible.

Le processus de mise à jour du plug-in master repose sur le module service de Salt et sur l'état de service.running pour redémarrer le master Salt après la mise à jour du plug-in. Le module service dépend du gestionnaire d'initialisation de votre distribution, tel que systemd.

Note :

Si vous exécutez le master Salt dans un conteneur ou sur une distribution qui n'utilise pas de gestionnaire d'initialisation, vous devez redémarrer manuellement le master Salt après la mise à jour. Si vous ne redémarrez pas le master Salt, l'espace de travail Plug-ins master signale que le master Salt exécute une version de plug-in obsolète.

Avant de commencer

Avant de pouvoir utiliser l'espace de travail Plug-ins master, les conditions préalables suivantes doivent être remplies :

  • Installez le plug-in master sur votre master Salt. Pour plus d'informations, reportez-vous à la section Installer et configurer le plug-in master.
  • Vérifiez que la clé du master Salt a été acceptée dans l'interface utilisateur d'SaltStack Config.
  • Vérifiez que le master Salt s'exécute en tant que root. Si le master Salt s'exécute en tant qu'utilisateur non racine, la mise à jour échoue.
  • Assurez-vous que votre master Salt exécute Salt version 3002.1 ou ultérieure. Si votre master Salt exécute la version 3002 ou une version antérieure, vous devez mettre à jour la version de Salt avant de pouvoir utiliser l'espace de travail Plug-ins master. Pour plus d'informations, reportez-vous à la section Mettre à niveau Salt.
  • Assurez-vous que votre master Salt exécute la version 8.11.2 ou une version ultérieure du plug-in master. Si votre master Salt exécute la version 8.11.1 ou une version antérieure, vous devez mettre à niveau manuellement le plug-in avant de pouvoir utiliser l'espace de travail Plug-ins master. Pour plus d'informations, reportez-vous à la section Mettre à niveau le plug-in master à l'aide de la CLI.

Mettre à jour le plug-in master

Vous pouvez mettre à jour la version du plug-in master sur un ou plusieurs masters Salt.

Note :

Vous pouvez uniquement mettre à jour la version du plug-in master via l'espace de travail Plug-ins master si l'état du plug-in est Nécessite une mise à jour. Si l'état du plug-in indique que le master Salt nécessite une intervention manuelle, vous devez vous connecter à votre master Salt pour résoudre le problème. Consultez Dépanner les mises à jour du plug-in pour plus d'informations.

Pour mettre à jour le plug-in master :

  1. Dans SaltStack Config, sélectionnez Administration > Plug-ins master.
  2. Sélectionnez un master Salt avec un état de plug-in Nécessite une mise à jour.
  3. Cliquez sur Mettre à jour.
  4. Vérifiez les informations dans la boîte de dialogue pour vous assurer que vous avez sélectionné le master Salt approprié.
  5. Cliquez sur Mettre à jour.
  6. Pour surveiller la progression de la mise à jour, cliquez sur le JID de dernière mise à jour.
  7. Dans l'espace de travail Plug-ins master, vérifiez que l'état du plug-in est À jour.

    Si la mise à jour échoue, reportez-vous à la section Dépanner les mises à jour du plug-in.

Dépanner les mises à jour du plug-in

Si la mise à jour de votre plug-in échoue, vous devez résoudre manuellement le problème en vous connectant à votre master Salt. Il n'existe aucune restauration automatique pour les mises à jour de plug-in ayant échoué.

Les mises à jour du plug-in peuvent échouer en raison de :
  • Problèmes d'infrastructure
  • Problèmes de configuration avec les machines virtuelles
  • Problèmes de connexion avec le master Salt

Essayez les étapes suivantes pour déterminer la cause de l'échec de la mise à jour :

  1. Vérifiez le JID de dernière mise à jour et recherchez les données brutes à la recherche d'erreurs.
  2. Exécutez systemctl status salt-master pour vérifier l'état du service salt-master.
  3. Exécutez salt-master -l debug pour démarrer le master Salt en mode de débogage.
  4. Téléchargez le plug-in master depuis l'espace de travail Plug-ins master et installez manuellement le plug-in.