ansible/docs/docsite/rst/user_guide/playbooks_strategies.rst

.. _playbooks_strategies:

Strategies
===========

Strategies are a way to control play execution. By default, plays run with a  ``linear`` strategy, in which all hosts will run each task before any host starts the next task, using the number of forks (default 5) to parallelize.

The ``serial`` directive can 'batch' this behaviour to a subset of the hosts, which then run to
completion of the play before the next 'batch' starts.

A second ``strategy`` ships with Ansible - ``free`` - which allows each host to run until the end of
the play as fast as it can.::

    - hosts: all
      strategy: free
      tasks:
      ...


Strategy Plugins
`````````````````

The strategies are implemented as plugins. In the future, new
execution strategies can be added, either locally by users or to Ansible itself by
a code contribution.

One example is ``debug`` strategy. See :doc:`playbooks_debugger` for details.

.. seealso::

   :doc:`playbooks`
       An introduction to playbooks
   :doc:`playbooks_reuse_roles`
       Playbook organization by roles
   `User Mailing List <https://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
Reduce warnings (#39254) * removes FAQ links; no entries exist for linked config settings * fixes various anchors and links * addresses abadger comments, thanks * marks orphan pages, avoids TOC errors * adds links for remote_tmp setting to FAQ 2018-04-25 18:18:52 +00:00			`.. _playbooks_strategies:`

fixed typo 2015-07-20 02:35:49 +00:00			`Strategies`
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`===========`

Removing obsolete version behavior callout notes - initial pass. (#33172) * Removing obsolete version behavior callout notes - initial pass. * Fixed example text punctuation. * Removed old version callout. * Typo fix * Updated example * Fixed awkward sentence * Fixed incorrect feature name * Reinstated current version callout 2017-11-22 04:14:27 +00:00			Strategies are a way to control play execution. By default, plays run with a ``linear`` strategy, in which all hosts will run each task before any host starts the next task, using the number of forks (default 5) to parallelize.
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00
			The ``serial`` directive can 'batch' this behaviour to a subset of the hosts, which then run to
			`completion of the play before the next 'batch' starts.`

Removing obsolete version behavior callout notes - initial pass. (#33172) * Removing obsolete version behavior callout notes - initial pass. * Fixed example text punctuation. * Removed old version callout. * Typo fix * Updated example * Fixed awkward sentence * Fixed incorrect feature name * Reinstated current version callout 2017-11-22 04:14:27 +00:00			A second ``strategy`` ships with Ansible - ``free`` - which allows each host to run until the end of
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`the play as fast as it can.::`

			`- hosts: all`
			`strategy: free`
			`tasks:`
			`...`


updated as per feedback 2015-07-19 21:27:13 +00:00			`Strategy Plugins`
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`````````````````

Removing obsolete version behavior callout notes - initial pass. (#33172) * Removing obsolete version behavior callout notes - initial pass. * Fixed example text punctuation. * Removed old version callout. * Typo fix * Updated example * Fixed awkward sentence * Fixed incorrect feature name * Reinstated current version callout 2017-11-22 04:14:27 +00:00			`The strategies are implemented as plugins. In the future, new`
			`execution strategies can be added, either locally by users or to Ansible itself by`
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`a code contribution.`

Add debug strategy plugin (#15125) * Add debug strategy plugin * Fix Python 2-3 compatiblity issue * Add document for debug strategy 2016-04-08 18:39:08 +00:00			One example is ``debug`` strategy. See :doc:`playbooks_debugger` for details.

moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`.. seealso::`

			:doc:`playbooks`
			`An introduction to playbooks`
Imports and includes (#25399) Initial commit to split includes into static imports/dynamic includes This implements the new include/import syntax for Ansible 2.4: * include_{tasks,role,variables} = dynamic * import_{playbook,tasks,role} = static The old bare `include` will be considered deprecated, as will any use of the `static: {yes\|no}` option. This also adds docs for import/include and reorganizing the "Playbook Reuse" section of the documentation. 2017-06-06 21:39:48 +00:00			:doc:`playbooks_reuse_roles`
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`Playbook organization by roles`
Prefer https:// links in the docs site All the changed urls are availible by way of https://. Most of them already redirect. 2018-07-21 13:48:47 +00:00			`User Mailing List <https://groups.google.com/group/ansible-devel>`_
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`Have a question? Stop by the google group!`
			`irc.freenode.net <http://irc.freenode.net>`_
			`#ansible IRC chat channel`