Strategy plugins control the flow of play execution by handling task and host scheduling. For more information on using strategy plugins and other ways to control execution order, see Controlling playbook execution: strategies and more.
Enabling strategy plugins
All strategy plugins shipped with Ansible are enabled by default. You can enable a custom strategy plugin by putting it in one of the lookup directory sources configured in ansible.cfg.
Using strategy plugins
Only one strategy plugin can be used in a play, but you can use different ones for each play in a playbook or ansible run. By default Ansible uses the linear plugin. You can change this default in Ansible configuration using an environment variable:
or in the ansible.cfg file:
You can also specify the strategy plugin in the play via the strategy keyword in a play:
- hosts: all strategy: debug tasks: - copy: src=myhosts dest=/etc/hosts notify: restart_tomcat - package: name=tomcat state=present handlers: - name: restart_tomcat service: name=tomcat state=restarted
You can use
ansible-doc -t strategy -l to see the list of available plugins.
ansible-doc -t strategy <plugin name> to see plugin-specific specific documentation and examples.
- Ansible playbooks
An introduction to playbooks
- Inventory plugins
- Callback plugins
- Filter plugins
- Test plugins
- Lookup plugins
- User Mailing List
Have a question? Stop by the google group!
- Real-time chat
How to join Ansible chat channels