The pre-flight check
How the check that names what this release does not support yet works, when it runs and how it differs from ansible-core.
Volant reads the whole ansible-core 2.19 grammar, so a playbook parses here as it parses under Ansible. A second check, the pre-flight, then looks for everything the loader accepted and this release does not support yet. If it finds any, it names each one and stops the run before the first connection, before any banner and before any recap.
Without it, a keyword that slipped past both checks would be ignored in silence, and the run would report success after skipping what you asked for.
flowchart TB L[load the playbook, full 2.19 grammar] --> P1[pre-flight on the playbook as written] P1 --> C[compile roles and imports] C --> P2[pre-flight on the compiled steps] P2 --> R[connect and run] P1 -. not supported yet .-> X[exit 4, nothing ran] P2 -. not supported yet .-> X class P1,P2 key class X quiet
The check runs twice: once on the playbook as written, and once on the compiled steps. The first pass reads the play as written, so a task that --tags would have dropped still stops the run when it uses something not supported yet. The second pass reads the compiled steps, after tag selection, and is the only place where a keyword written inside a role or an imported file is visible. This errs toward stopping more often, never less. Every section of a block is checked, rescue and always included.
What a dynamic include brings in is checked when a host reaches it. A refusal there fails the include for that host, and a rescue or ignore_errors takes it. See Includes and imports.
What it refuses today
Section titled “What it refuses today”Will my playbook run? has the table of what the check refuses, with the message of each and its exit code.
Exit codes
Section titled “Exit codes”A run the pre-flight stops exits with code 4, which is what Ansible uses for a playbook it cannot load. Some cases keep the code Ansible was measured to use:
| Case | Exit code |
|---|---|
| Anything this release does not support yet | 4 |
A role that roles: or import_role cannot find |
1 |
| An escalation method this release does not support yet | 2 |
Three cases are no longer pre-flight cases. They fail when the task is reached, as in ansible-core:
- An unknown
metaaction prints its banner, theninvalid meta action requested: <action>and exits 1, whatever itswhensays. - A
notifythat names no handler ends the run with exit 1 when the task reportschanged. See Handlers. - An
include_roleof a role whose task file does not load runs the plays and tasks before it, then ends with exit 4 after the statement’s banner. Awhen: falseon the include hides the failure.
Exit codes lists every code Volant uses.
Listings and --syntax-check never call the pre-flight, so you can read a playbook before the release that runs it ships.
Differences from Ansible
Section titled “Differences from Ansible”tagsandtimeoutare checked before their value is looked at, sotags: 3does not get Ansible’s type error.- A
with_<name>that is no lookup plugin of the controller’s ansible-core is refused with ansible-core’s sentence,'with_xyz' is not a valid attribute for a Task. In a file thatinclude_tasksorinclude_rolereads while the play runs, the include fails for the host that reached it, and the play does not stop at exit 4. - For a module this release does not support yet, the arguments are not parsed, so the error is about the module and not about a
key=valueon the next line. gather_facts,ignore_errorsandbecomewritten as something other than true or false are rejected when the playbook loads, one step earlier than Ansible rejects them, with ansible-core’s message and exit code. A template is not rejected:ignore_errors: "{{ ... }}"renders when the task runs, for each loop item, and the templated keywords render for each host at the same moment.gather_factsandforce_handlersof a play render when the play starts. All of them are read with ansible-core’s rules, and a value they cannot take fails the task, or stops the play for the last two, with ansible-core’s message.