Aller au contenu
Installer

Codes de sortie

Ce que signifie chaque code de sortie, et où Volant s'aligne sur ansible-playbook.

Volant sort avec les codes qu’utilise ansible-playbook : les scripts et les tâches CI écrits pour Ansible continuent donc de fonctionner.

Tous les hôtes ont terminé sans échec.

Une erreur générale : un playbook ou un rôle introuvable, un nom de notify ou une action meta inconnus, ou un motif d’hôtes qui ne laisse aucun hôte.

Au moins un hôte a échoué, ou l’exécution a demandé une méthode d’élévation de privilèges que cette version ne prend pas encore en charge.

Au moins un hôte était injoignable, que d’autres aient échoué ou non, comme ansible-playbook le signale, ou le playbook s’est arrêté avant l’exécution : il ne s’analyse pas, ou il utilise quelque chose que cette version ne prend pas encore en charge.

Un paramètre a une valeur qu’il ne peut pas prendre, comme forks = many, un mot inconnu pour gathering, runtime ou host_named_paths, ou un mot-clé order que le play ne connaît pas. Le message nomme la clé et la valeur.

Ctrl-C ou SIGTERM a arrêté l’exécution. Les lots en cours sont annulés, le récapitulatif s’affiche, et Volant sort avec 99, comme ansible-playbook.

--step n’a trouvé aucun terminal sur l’entrée standard. Volant s’arrête avant de toucher un hôte.

Après une exécution, le code vient du récapitulatif : on ajoute 2 quand un hôte a échoué, et 4 quand un hôte était injoignable. Un play serial s’arrête au premier lot qui a perdu tous ses hôtes actifs, avec 2 s’ils ont échoué et 4 s’ils sont tous devenus injoignables.

Un playbook arrêté par la vérification préalable sort avec 4 avant toute connexion, ce qu’Ansible utilise pour un playbook qu’il ne peut pas charger. Les cas dont le code a été mesuré sur Ansible gardent ce code : 1 pour un rôle manquant, une action meta inconnue ou un nom de notify inconnu. Un nom de notify inconnu dans un fichier qu’un include dynamique apporte n’est trouvé que pendant l’exécution, et il y met fin avec 1 également.

Dans quelques cas, ansible-core plante avec le code de sortie 250, par exemple sur un playbook qui s’importe lui-même ou sur serial: abc. Volant rejette ces cas à la place, avec un message clair et l’un des codes ci-dessus. Chaque cas est listé sous Différences avec Ansible dans la page qui le traite.

volant adhoc (ansible) sort avec 0 quand chaque hôte a réussi ou a été ignoré, 2 quand un hôte a échoué, 4 quand un hôte était injoignable, 1 quand -l ne laisse aucun hôte, et 5 pour un réglage invalide. volant vault (ansible-vault) et volant inventory (ansible-inventory) sortent avec 0 en cas de succès, 1 sur une erreur comme create sur un fichier qui existe, et 5 sur une mauvaise option ou action. Une erreur d’usage de l’une d’elles sort avec 2. Les noms des commandes ansible donne le tableau.