Exit-Codes
Was jeder Exit-Code bedeutet und wo Volant mit ansible-playbook übereinstimmt.
Volant beendet sich mit den Codes, die ansible-playbook verwendet, sodass für Ansible geschriebene Skripte und CI-Jobs weiter funktionieren.
Die Codes
Abschnitt betitelt „Die Codes“Jeder Host wurde ohne Fehler beendet.
Ein allgemeiner Fehler: ein Playbook oder eine Rolle, die sich nicht finden lässt, ein unbekannter notify-Name oder eine unbekannte meta-Aktion oder ein Host-Muster, das keine Hosts übrig lässt.
Mindestens ein Host ist fehlgeschlagen, oder der Lauf hat eine Methode der Rechteausweitung verlangt, die dieses Release noch nicht unterstützt.
Mindestens ein Host war nicht erreichbar, ob andere fehlgeschlagen sind oder nicht, wie ansible-playbook es meldet, oder das Playbook wurde vor dem Lauf gestoppt: Es lässt sich nicht parsen oder nutzt etwas, das dieses Release noch nicht unterstützt.
Eine Einstellung hat einen Wert, den sie nicht annehmen kann, etwa forks = many, ein unbekanntes Wort für gathering, runtime oder host_named_paths oder ein Keyword order, das das Play nicht kennt. Die Meldung nennt den Schlüssel und den Wert.
Strg+C oder SIGTERM hat den Lauf gestoppt. Laufende Batches werden abgebrochen, der Recap wird ausgegeben, und Volant endet mit 99, wie ansible-playbook.
--step hat auf der Standardeingabe kein Terminal gefunden. Volant stoppt, bevor es einen Host berührt.
Nach einem Lauf
Abschnitt betitelt „Nach einem Lauf“Nach einem Lauf ergibt sich der Code aus dem Recap: 2 kommt hinzu, wenn ein Host fehlgeschlagen ist, und 4, wenn ein Host nicht erreichbar war. Ein serial-Play stoppt beim ersten Batch, der jeden aktiven Host verloren hat, mit 2, wenn sie fehlgeschlagen sind, und mit 4, wenn sie alle nicht erreichbar wurden.
Vor einem Lauf
Abschnitt betitelt „Vor einem Lauf“Ein Playbook, das die Vorabprüfung stoppt, endet vor jeder Verbindung mit 4, was Ansible für ein Playbook verwendet, das es nicht laden kann. Fälle, deren Code an Ansible gemessen wurde, behalten diesen Code: 1 für eine fehlende Rolle, eine unbekannte meta-Aktion oder einen unbekannten notify-Namen. Ein unbekannter notify-Name in einer Datei, die ein dynamisches Include einbringt, wird erst während des Laufs gefunden und beendet den Lauf dort ebenfalls mit 1.
Wo Ansible abstürzt
Abschnitt betitelt „Wo Ansible abstürzt“In einigen Fällen stürzt ansible-core mit Exit-Code 250 ab, zum Beispiel bei einem Playbook, das sich selbst importiert, oder bei serial: abc. Volant lehnt diese Fälle stattdessen mit einer klaren Meldung und einem der obigen Codes ab. Jeder Fall steht unter Unterschiede zu Ansible auf der Seite, die ihn behandelt.
Die anderen Befehle
Abschnitt betitelt „Die anderen Befehle“volant adhoc (ansible) endet mit 0, wenn jeder Host erfolgreich war oder übersprungen wurde, mit 2, wenn ein Host fehlgeschlagen ist, mit 4, wenn ein Host nicht erreichbar war, mit 1, wenn -l keinen Host übrig lässt, und mit 5 bei einer ungültigen Einstellung. volant vault (ansible-vault) und volant inventory (ansible-inventory) enden bei Erfolg mit 0, bei einem Fehler wie create auf eine vorhandene Datei mit 1 und bei einer falschen Option oder Aktion mit 5. Ein Aufruffehler bei einem von ihnen endet mit 2. Ansible-Befehlsnamen hat die Tabelle.