Adding note on async+check mode incompatibility (#41427)

Fixes ansible/ansible#40991
This commit is contained in:
David M Noriega 2018-11-29 07:33:43 -08:00 committed by ansibot
parent 392a12589e
commit 0922a6566d

View file

@ -30,6 +30,11 @@ poll value is 10 seconds if you do not specify a value for `poll`::
'async' keyword, the task runs synchronously, which is Ansible's 'async' keyword, the task runs synchronously, which is Ansible's
default. default.
.. note::
As of Ansible 2.3, async does not support check mode and will fail the
task when run in check mode. See :doc:`playbooks_checkmode` on how to
skip a task in check mode.
Alternatively, if you do not need to wait on the task to complete, you may Alternatively, if you do not need to wait on the task to complete, you may
run the task asynchronously by specifying a poll value of 0:: run the task asynchronously by specifying a poll value of 0::
@ -127,4 +132,3 @@ of tasks running concurrently, you can do it this way::
Have a question? Stop by the google group! Have a question? Stop by the google group!
`irc.freenode.net <http://irc.freenode.net>`_ `irc.freenode.net <http://irc.freenode.net>`_
#ansible IRC chat channel #ansible IRC chat channel