From 0922a6566d45f6766057d39862eac4dcbdf43b1f Mon Sep 17 00:00:00 2001 From: David M Noriega Date: Thu, 29 Nov 2018 07:33:43 -0800 Subject: [PATCH] Adding note on async+check mode incompatibility (#41427) Fixes ansible/ansible#40991 --- docs/docsite/rst/user_guide/playbooks_async.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/docsite/rst/user_guide/playbooks_async.rst b/docs/docsite/rst/user_guide/playbooks_async.rst index 08193688a0a..a4aa1264c76 100644 --- a/docs/docsite/rst/user_guide/playbooks_async.rst +++ b/docs/docsite/rst/user_guide/playbooks_async.rst @@ -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 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 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! `irc.freenode.net `_ #ansible IRC chat channel -