2013-09-29 23:03:51 +00:00
|
|
|
Asynchronous Actions and Polling
|
|
|
|
|
================================
|
|
|
|
|
|
|
|
|
|
By default tasks in playbooks block, meaning the connections stay open
|
|
|
|
|
until the task is done on each node. This may not always be desirable, or you may
|
|
|
|
|
be running operations that take longer than the SSH timeout.
|
|
|
|
|
|
|
|
|
|
The easiest way to do this is
|
|
|
|
|
to kick them off all at once and then poll until they are done.
|
|
|
|
|
|
|
|
|
|
You will also want to use asynchronous mode on very long running
|
|
|
|
|
operations that might be subject to timeout.
|
|
|
|
|
|
|
|
|
|
To launch a task asynchronously, specify its maximum runtime
|
|
|
|
|
and how frequently you would like to poll for status. The default
|
|
|
|
|
poll value is 10 seconds if you do not specify a value for `poll`::
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
- hosts: all
|
|
|
|
|
remote_user: root
|
|
|
|
|
tasks:
|
|
|
|
|
- name: simulate long running op (15 sec), wait for up to 45, poll every 5
|
|
|
|
|
command: /bin/sleep 15
|
|
|
|
|
async: 45
|
|
|
|
|
poll: 5
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
There is no default for the async time limit. If you leave off the
|
|
|
|
|
'async' keyword, the task runs synchronously, which is Ansible's
|
|
|
|
|
default.
|
|
|
|
|
|
|
|
|
|
Alternatively, if you do not need to wait on the task to complete, you may
|
|
|
|
|
"fire and forget" by specifying a poll value of 0::
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
- hosts: all
|
|
|
|
|
remote_user: root
|
|
|
|
|
tasks:
|
|
|
|
|
- name: simulate long running op, allow to run for 45, fire and forget
|
|
|
|
|
command: /bin/sleep 15
|
|
|
|
|
async: 45
|
|
|
|
|
poll: 0
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
You shouldn't "fire and forget" with operations that require
|
|
|
|
|
exclusive locks, such as yum transactions, if you expect to run other
|
|
|
|
|
commands later in the playbook against those same resources.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Using a higher value for ``--forks`` will result in kicking off asynchronous
|
|
|
|
|
tasks even faster. This also increases the efficiency of polling.
|
|
|
|
|
|
2013-10-05 16:31:16 +00:00
|
|
|
|
|
|
|
|
.. seealso::
|
|
|
|
|
|
|
|
|
|
:doc:`playbooks`
|
|
|
|
|
An introduction to playbooks
|
|
|
|
|
`User Mailing List <http://groups.google.com/group/ansible-devel>`_
|
|
|
|
|
Have a question? Stop by the google group!
|
|
|
|
|
`irc.freenode.net <http://irc.freenode.net>`_
|
|
|
|
|
#ansible IRC chat channel
|
|
|
|
|
|
