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'Automation 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 Automation 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 Automation 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
.
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'Automation 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.
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 :
- Dans Automation Config, sélectionnez .
- Sélectionnez un master Salt avec un état de plug-in Nécessite une mise à jour.
- Cliquez sur Mettre à jour.
- Vérifiez les informations dans la boîte de dialogue pour vous assurer que vous avez sélectionné le master Salt approprié.
- Cliquez sur Mettre à jour.
- Pour surveiller la progression de la mise à jour, cliquez sur le JID de dernière mise à jour.
- 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é.
- 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 :
- Vérifiez le JID de dernière mise à jour et recherchez les données brutes à la recherche d'erreurs.
- Exécutez
systemctl status salt-master
pour vérifier l'état du servicesalt-master
. - Exécutez
salt-master -l debug
pour démarrer le master Salt en mode de débogage. - Téléchargez le plug-in master depuis l'espace de travail Plug-ins master et installez manuellement le plug-in.