ansible / ansible.builtin / v2.7.18 / module / include_tasks Dynamically include a task list | "added in version" 2.4 of ansible.builtin" Authors: Ansible Core Team (@ansible) preview | supported by coreansible.builtin.include_tasks (v2.7.18) — module
pip
Install with pip install ansible==2.7.18
Includes a file with a list of tasks to be executed in the current playbook.
- hosts: all tasks: - debug: msg: task1 - name: Include task list in play include_tasks: stuff.yaml - debug: msg: task10
- hosts: all tasks: - debug: msg: task1 - name: Include task list in play only if the condition is true include_tasks: "{{ hostvar }}.yaml" when: hostvar is defined
- name: Apply tags to tasks within included file include_tasks: file: install.yml apply: tags: - install tags: - always
- name: Apply tags to tasks within included file when using free-form include_tasks: install.yml args: apply: tags: - install tags: - always
file: description: - The name of the imported file is specified directly without any other option. - Unlike M(import_tasks), most keywords, including loop, with_items, and conditionals, apply to this statement. - The do until loop is not supported on M(include_tasks). version_added: '2.7' version_added_collection: ansible.builtin apply: description: - Accepts a hash of task keywords (e.g. C(tags), C(become)) that will be applied to the tasks within the include. version_added: '2.7' version_added_collection: ansible.builtin free-form: description: - 'Supplying a file name via free-form C(- include_tasks: file.yml) of a file to be included is the equivalent of specifying an argument of I(file). '