From 9a6530be77ac313af2f92d68eae8592418b534a3 Mon Sep 17 00:00:00 2001 From: Brian Coca Date: Wed, 5 Sep 2018 21:24:37 -0400 Subject: [PATCH] clarify free strategy (#44645) * clarify free strategy * wordsmithing * shorten line per Shippable --- lib/ansible/plugins/strategy/free.py | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/lib/ansible/plugins/strategy/free.py b/lib/ansible/plugins/strategy/free.py index 207f63207be..25fd3bb67cc 100644 --- a/lib/ansible/plugins/strategy/free.py +++ b/lib/ansible/plugins/strategy/free.py @@ -20,11 +20,13 @@ __metaclass__ = type DOCUMENTATION = ''' strategy: free - short_description: Executes tasks on each host independently + short_description: Executes tasks without waiting for all hosts description: - - Task execution is as fast as possible per host in batch as defined by C(serial) (default all). - Ansible will not wait for other hosts to finish the current task before queuing the next task for a host that has finished. - Once a host is done with the play, it opens it's slot to a new host that was waiting to start. + - Task execution is as fast as possible per batch as defined by C(serial) (default all). + Ansible will not wait for other hosts to finish the current task before queuing more tasks for other hosts. + All hosts are still attempted for the current task, but it prevents blocking new tasks for hosts that have already finished. + - With the free strategy, unlike the default linear strategy, a host that is slow or stuck on a specific task + won't hold up the rest of the hosts and tasks. version_added: "2.0" author: Ansible Core Team '''