Die Vorabprüfung
Wie die Prüfung funktioniert, die benennt, was dieses Release noch nicht unterstützt, wann sie läuft und wie sie sich von ansible-core unterscheidet.
Volant liest die gesamte Grammatik von ansible-core 2.19, ein Playbook wird hier also so geparst wie unter Ansible. Eine zweite Prüfung, die Vorabprüfung, sucht dann alles, was der Loader akzeptiert hat und dieses Release noch nicht unterstützt. Findet sie etwas, benennt sie jeden Fund und stoppt den Lauf vor der ersten Verbindung, vor jedem Banner und vor jedem Recap.
Ohne sie würde ein Keyword, das an beiden Prüfungen vorbeigerutscht ist, stillschweigend ignoriert, und der Lauf würde Erfolg melden, nachdem er übersprungen hat, worum Sie gebeten haben.
flowchart TB L[Playbook laden, volle 2.19-Grammatik] --> P1[Vorabprüfung des Playbooks wie geschrieben] P1 --> C[Rollen und Imports kompilieren] C --> P2[Vorabprüfung der kompilierten Schritte] P2 --> R[verbinden und ausführen] P1 -. noch nicht unterstützt .-> X[Exit 4, nichts lief] P2 -. noch nicht unterstützt .-> X class P1,P2 key class X quiet
Die Prüfung läuft zweimal: einmal auf dem Playbook, wie es geschrieben ist, und einmal auf den kompilierten Schritten. Der erste Durchgang liest das Play wie geschrieben, sodass ein Task, den --tags weggelassen hätte, den Lauf trotzdem stoppt, wenn er etwas nicht Unterstütztes verwendet. Der zweite Durchgang liest die kompilierten Schritte nach der Tag-Auswahl und ist der einzige Ort, an dem ein Keyword sichtbar ist, das in einer Rolle oder einer importierten Datei steht. Das irrt in Richtung häufigeres Stoppen, nie in Richtung selteneres. Jeder Abschnitt eines Blocks wird geprüft, auch rescue und always.
Was ein dynamisches Include einbringt, wird geprüft, wenn ein Host es erreicht. Eine Ablehnung dort lässt das Include für diesen Host fehlschlagen, und ein rescue oder ignore_errors fängt es auf. Siehe Imports und Includes.
Was heute abgelehnt wird
Abschnitt betitelt „Was heute abgelehnt wird“Läuft mein Playbook? hat die Tabelle dessen, was die Prüfung ablehnt, mit der Meldung jedes Falls und seinem Exit-Code.
Exit-Codes
Abschnitt betitelt „Exit-Codes“Ein Lauf, den die Vorabprüfung stoppt, endet mit Code 4, den Ansible für ein Playbook verwendet, das es nicht laden kann. Einige Fälle behalten den Code, den Ansible laut Messung verwendet:
| Fall | Exit-Code |
|---|---|
| Alles, was dieses Release noch nicht unterstützt | 4 |
Eine Rolle, die roles: oder import_role nicht finden kann |
1 |
| Eine Methode der Rechteausweitung, die dieses Release noch nicht unterstützt | 2 |
Drei Fälle sind keine Vorabprüfungsfälle mehr. Sie schlagen fehl, wenn der Task erreicht wird, wie in ansible-core:
- Eine unbekannte
meta-Action gibt ihr Banner aus, danninvalid meta action requested: <action>, und endet mit 1, was auch immer ihrwhensagt. - Ein
notify, das keinen Handler benennt, beendet den Lauf mit Exit 1, wenn der Taskchangedmeldet. Siehe Handler. - Ein
include_roleeiner Rolle, deren Task-Datei sich nicht laden lässt, führt die Plays und Tasks davor aus und endet dann nach dem Banner der Anweisung mit Exit 4. Einwhen: falseam Include verbirgt den Fehler.
Exit-Codes listet jeden Code auf, den Volant verwendet.
Auflistungen und --syntax-check rufen die Vorabprüfung nie auf, sodass Sie ein Playbook lesen können, bevor das Release erscheint, das es ausführt.
Unterschiede zu Ansible
Abschnitt betitelt „Unterschiede zu Ansible“tagsundtimeoutwerden geprüft, bevor ihr Wert angesehen wird, sodasstags: 3nicht den Typfehler von Ansible bekommt.- Ein
with_<name>, das kein Lookup-Plugin des ansible-core des Controllers ist, wird mit dem Satz von ansible-core abgelehnt,'with_xyz' is not a valid attribute for a Task. In einer Datei, dieinclude_tasksoderinclude_roleliest, während das Play läuft, schlägt das Include für den Host fehl, der es erreicht hat, und das Play stoppt nicht mit Exit 4. - Bei einem Modul, das dieses Release noch nicht unterstützt, werden die Argumente nicht geparst, sodass der Fehler das Modul betrifft und nicht ein
key=valuein der nächsten Zeile. gather_facts,ignore_errorsundbecome, die als etwas anderes als true oder false geschrieben sind, werden beim Laden des Playbooks abgelehnt, einen Schritt früher als Ansible sie ablehnt, mit der Meldung und dem Exit-Code von ansible-core. Ein Template wird nicht abgelehnt:ignore_errors: "{{ ... }}"wird gerendert, wenn der Task läuft, für jedes Schleifenelement, und die Keywords als Templates werden im selben Moment für jeden Host gerendert.gather_factsundforce_handlerseines Plays werden gerendert, wenn das Play startet. Alle werden nach den Regeln von ansible-core gelesen, und ein Wert, den sie nicht annehmen können, lässt den Task fehlschlagen, oder bei den letzten beiden das Play stoppen, mit der Meldung von ansible-core.