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:

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 <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
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 7 years ago			`.. _playbooks_strategies:`

fixed typo 9 years ago			`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 9 years ago			`===========`

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 7 years ago			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 9 years ago
			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 7 years ago			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 9 years ago			`the play as fast as it can.::`

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


			`.. _strategy_plugins:`

updated as per feedback 9 years ago			`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 9 years ago			`````````````````

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 7 years ago			`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 9 years ago			`a code contribution.`

Add debug strategy plugin (#15125) * Add debug strategy plugin * Fix Python 2-3 compatiblity issue * Add document for debug strategy 9 years ago			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 9 years ago			`.. 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. 8 years ago			: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 9 years ago			`Playbook organization by roles`
			`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`