mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
44 lines
1.1 KiB
ReStructuredText
44 lines
1.1 KiB
ReStructuredText
.. _fail:
|
|
|
|
fail
|
|
``````````````````````````````
|
|
|
|
.. versionadded:: 0.8
|
|
|
|
This module fails the progress with a custom message. It can be useful for bailing out when a certain condition is met using only_if.
|
|
|
|
.. raw:: html
|
|
|
|
<table>
|
|
<tr>
|
|
<th class="head">parameter</th>
|
|
<th class="head">required</th>
|
|
<th class="head">default</th>
|
|
<th class="head">choices</th>
|
|
<th class="head">comments</th>
|
|
</tr>
|
|
<tr>
|
|
<td>msg</td>
|
|
<td>no</td>
|
|
<td>'Failed because only_if condition is true'</td>
|
|
<td><ul></ul></td>
|
|
<td>The customized message used for failing execution. If ommited, fail will simple bail out with a generic message.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>rc</td>
|
|
<td>no</td>
|
|
<td>1</td>
|
|
<td><ul></ul></td>
|
|
<td>The return code of the failure. This is currently not used by Ansible, but might be used in the future.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
.. raw:: html
|
|
|
|
<p>Example playbook using fail and only_if together</p> <p><pre>
|
|
action: fail msg="The system may not be provisioned according to the CMDB status." rc=100
|
|
only_if: "'$cmdb_status' != 'to-be-staged'"
|
|
|
|
</pre></p>
|
|
<br/>
|
|
|