Quand une exécution échoue
Trouvez la tâche qui a échoué et pourquoi, vérifiez le même playbook sous ansible-playbook, et signalez ce que vous avez trouvé.
Partez du code de sortie. Il vous dit si l’exécution s’est arrêtée avant de toucher un hôte ou si elle a échoué sur l’un d’eux.
| Code | Ce qui s’est passé | Où regarder |
|---|---|---|
| 4, sans récapitulatif | Le playbook s’est arrêté avant la première connexion. Il ne s’analyse pas, ou il utilise quelque chose que cette version ne prend pas encore en charge. | Le message au-dessus du code. Voir Arrêt avant l’exécution. |
| 2, 4 ou 6, avec un récapitulatif | Un hôte a échoué (2), un hôte était injoignable (4), ou les deux (6). | La ligne fatal: de la tâche, puis Échec pendant l’exécution. |
| 1 | Un rôle, un playbook ou un motif d’hôtes est introuvable. | Le fichier ou le nom que cite le message. |
Codes de sortie liste tous les codes.
Arrêt avant l’exécution
Section intitulée « Arrêt avant l’exécution »Presque tout ce que cette version ne sait pas exécuter est nommé avant que Volant ne se connecte à quoi que ce soit. Le message dit ce qu’il a refusé et où :
| Message | Que faire |
|---|---|
task 'NAME': keyword 'KEYWORD' is not supported yet on 'MODULE' |
Vérifiez le mot-clé dans Mots-clés. Retirez-le, ou gardez ce play sous ansible-playbook pour l’instant. |
task 'NAME': argument 'ARGUMENT' is not supported yet on 'MODULE' |
Vérifiez le module dans Modules. La plupart des arguments refusés y ont une solution de contournement. |
couldn't resolve module/action 'NAME' |
Vérifiez l’orthographe. Si le module vient d’une collection, installez-la avec volant runtime install --collections NAMESPACE.COLLECTION. |
strategy 'NAME' is not supported yet |
Utilisez linear, free, host_pinned ou debug. Un plugin de stratégie ne s’exécute que s’il hérite de l’une d’elles sans rien ajouter. |
become_method 'NAME' is not supported yet |
Utilisez sudo ou su. Celui-ci se termine avec le code 2. |
the role 'NAME' was not found in ... |
Le message liste les répertoires explorés. Ajoutez le répertoire du rôle à roles_path. Celui-ci se termine avec le code 1. |
Mon playbook va-t-il s’exécuter ? liste ces refus et montre comment vérifier un projet entier sans l’exécuter. La vérification préalable explique comment cette vérification fonctionne.
Échec pendant l’exécution
Section intitulée « Échec pendant l’exécution »-
Relancez sur l’hôte en échec seulement, avec plus de sortie.
-vvvaffiche les arguments reçus par chaque module :Fenêtre de terminal volant playbook -i inventory.ini site.yml --limit web1 -vvv -
Sautez les tâches qui passent déjà.
--start-at-taskdémarre à la tâche que vous nommez, et--stepdemande confirmation avant chaque tâche :Fenêtre de terminal volant playbook -i inventory.ini site.yml --limit web1 --start-at-task "Install nginx" -
Arrêtez-vous sur l’échec et regardez autour. Avec
debugger: on_failedsur le play ou la tâche, Volant ouvre le débogueur de tâches d’Ansible quand une tâche échoue. Vous pouvez afficher des variables, changer les arguments et relancer la tâche.
Comparer avec ansible-playbook
Section intitulée « Comparer avec ansible-playbook »Volant lit les mêmes fichiers : la même commande s’exécute donc sous Ansible :
ansible-playbook -i inventory.ini site.yml --limit web1Si Ansible échoue de la même façon, le problème est dans le playbook ou sur l’hôte. Si seul Volant échoue, ou si les deux donnent des résultats différents, c’est un bug de Volant. Vous pouvez garder le play sous ansible-playbook le temps de le corriger.
Revenir à ansible-playbook
Section intitulée « Revenir à ansible-playbook »Les mêmes fichiers s’exécutent sous ansible-playbook sans changement. Volant n’ajoute rien à vos playbooks, rôles, inventaires ni à ansible.cfg : il n’y a donc rien à reconvertir.
Sur les hôtes, la seule chose qui reste est l’agent en cache : un répertoire appelé volant-agent-<version>-<uid> dans ~/.ansible/tmp, et un répertoire volant-blobs-<version>-<uid> à côté si une exécution a utilisé des modules Python. Pour les supprimer, effacez-les sur chaque hôte, avec le compte que l’exécution a utilisé :
ssh web1 'rm -rf ~/.ansible/tmp/volant-*'Un hôte où des tâches se sont exécutées avec become contient une seconde copie dans le répertoire personnel du compte vers lequel il a élevé ses privilèges. Lancez la même commande avec ce compte. Pour retirer aussi Volant du contrôleur, voir Désinstaller. Ce que Volant laisse sur vos machines liste tout.
Le signaler
Section intitulée « Le signaler »- Une différence avec
ansible-playbookva dans un rapport d’écart de compatibilité Ansible. - Tout le reste qui ne fonctionne pas comme documenté va dans un rapport de bug.
- Un problème de sécurité passe par la politique de sécurité, jamais par un ticket public.
Joignez la sortie de volant --version, le plus petit playbook et inventaire qui échouent encore, et la sortie de l’exécution en échec avec -vvv. Retirez les mots de passe, les clés, le contenu vault et les noms d’hôtes avant de les publier. Un ticket public reste public.