ansible / ansible.builtin / v2.9.3 / module / include_role Load and execute a role | "added in version" 2.2 of ansible.builtin" Authors: Ansible Core Team (@ansible) stableinterface | supported by coreansible.builtin.include_role (v2.9.3) — module
pip
Install with pip install ansible==2.9.3
Dynamically loads and executes a specified role as a task.
May be used only where Ansible tasks are allowed - inside C(pre_tasks), C(tasks), or C(post_tasks) playbook objects, or as a task inside a role.
Task-level keywords, loops, and conditionals apply only to the C(include_role) statement itself.
To apply keywords to the tasks within the role, pass them using the C(apply) option or use M(import_role) instead.
Ignores some keywords, like C(until) and C(retries).
This module is also supported for Windows targets.
- include_role: name: myrole
- name: Run tasks/other.yaml instead of 'main' include_role: name: myrole tasks_from: other
- name: Pass variables to role include_role: name: myrole vars: rolevar1: value from task
- name: Use role in loop include_role: name: '{{ roleinputvar }}' loop: - '{{ roleinput1 }}' - '{{ roleinput2 }}' loop_control: loop_var: roleinputvar
- name: Conditional role include_role: name: myrole when: not idontwanttorun
- name: Apply tags to tasks within included file include_role: name: install apply: tags: - install tags: - always
name: description: - The name of the role to be executed. required: true type: str apply: description: - Accepts a hash of task keywords (e.g. C(tags), C(become)) that will be applied to all tasks within the included role. version_added: '2.7' version_added_collection: ansible.builtin public: default: false description: - This option dictates whether the role's C(vars) and C(defaults) are exposed to the playbook. If set to C(yes) the variables will be available to tasks following the C(include_role) task. This functionality differs from standard variable exposure for roles listed under the C(roles) header or C(import_role) as they are exposed at playbook parsing time, and available to earlier roles and tasks as well. type: bool version_added: '2.7' version_added_collection: ansible.builtin vars_from: default: main description: - File to load from a role's C(vars/) directory. type: str tasks_from: default: main description: - File to load from a role's C(tasks/) directory. type: str defaults_from: default: main description: - File to load from a role's C(defaults/) directory. type: str handlers_from: default: main description: - File to load from a role's C(handlers/) directory. type: str version_added: '2.8' version_added_collection: ansible.builtin allow_duplicates: default: true description: - Overrides the role's metadata setting to allow using a role more than once with the same parameters. type: bool