fail – Fail with custom message

From Get docs
Ansible/docs/2.7/modules/fail module


fail – Fail with custom message

Synopsis

  • This module fails the progress with a custom message. It can be useful for bailing out when a certain condition is met using when.
  • This module is also supported for Windows targets.

Parameters

Parameter Choices/Defaults Comments

msg

-

Default:

"\u0027Failed as requested from task\u0027"

The customized message used for failing execution. If omitted, fail will simply bail out with a generic message.



Notes

Note

  • This module is also supported for Windows targets.


Examples

# Example playbook using fail and when together
- fail:
    msg: "The system may not be provisioned according to the CMDB status."
  when: cmdb_status != "to-be-staged"

Status

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

  • Dag Wieers (@dagwieers)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/fail_module.html