ansible/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
Code Releases Activity

doc update

Browse source
This commit is contained in:
bennojoy 2013-09-25 10:22:51 +05:30
parent 0e749611ac
commit daf2f49116
1 changed files with 13 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
docsite/latest/rst/playbooks2.rst
View file

@ -467,11 +467,11 @@ Do/Until
Sometimes you would want to retry a task till a certain condition is met, In such conditions the Do/Until feature will help. Sometimes you would want to retry a task till a certain condition is met, In such conditions the Do/Until feature will help.
Here's an example which show's the syntax to be applied for the task. Here's an example which show's the syntax to be applied for the task.
- action: shell /usr/bin/foo - action: shell /usr/bin/foo
register: result register: result
until: register.stdout.find("all systems go") != -1 until: register.stdout.find("all systems go") != -1
retries: 5 retries: 5
delay: 10 delay: 10
The above example run the shell module recursively till the module's result has "all systems go" in it's stdout or the task has The above example run the shell module recursively till the module's result has "all systems go" in it's stdout or the task has
been retried for 5 times with a delay of 10 seconds. The default value for "retries" is 3 and "delay" is 5. been retried for 5 times with a delay of 10 seconds. The default value for "retries" is 3 and "delay" is 5.
@ -480,12 +480,15 @@ The task returns the results returned by the last task run. The results of indiv
The results will have a new key "attempts" which will have the number of the retries for the task. The results will have a new key "attempts" which will have the number of the retries for the task.
.. note:: .. note::
The Do/Until does not take decision on whether to fail or pass the play when the maximum retries are completed, the user can The Do/Until does not take decision on whether to fail or pass the play when the maximum retries are completed, the user can
can do that in the next task as follows: can do that in the next task as follows:
- name: fail the play - action: shell /usr/bin/foo
fail: msg=" This play fails as the foo exceeded maximum retries" register: result
fail_when: register.attempts >= 5 until: register.stdout.find("all systems go") != -1
retries: 5
delay: 10
failed_when: result.attempts == 5
Loops Loops