ansible / ansible.builtin / v2.16.5 / module / fail Fail with custom message | "added in version" 0.8 of ansible.builtin" Authors: Dag Wieers (@dagwieers) This plugin has a corresponding action plugin.ansible.builtin.fail (v2.16.5) — module
pip
Install with pip install ansible-core==2.16.5
This module fails the progress with a custom message.
It can be useful for bailing out when a certain condition is met using C(when).
This module is also supported for Windows targets.
- name: Example using fail and when together ansible.builtin.fail: msg: The system may not be provisioned according to the CMDB status. when: cmdb_status != "to-be-staged"
msg: default: Failed as requested from task description: - The customized message used for failing execution. - If omitted, fail will simply bail out with a generic message. type: str