New in version 2.4.
roles:
keyword, this task loads a role, but it allows you to control it when the role tasks run in between other tasks of the play.Parameter | Choices/Defaults | Comments |
---|---|---|
allow_duplicates
boolean
|
|
Overrides the role's metadata setting to allow using a role more than once with the same parameters.
|
defaults_from
string
|
Default: "main"
|
File to load from a role's
defaults/ directory. |
handlers_from
string
added in 2.8 |
Default: "main"
|
File to load from a role's
handlers/ directory. |
name
string
/ required
|
The name of the role to be executed.
|
|
tasks_from
string
|
Default: "main"
|
File to load from a role's
tasks/ directory. |
vars_from
string
|
Default: "main"
|
File to load from a role's
vars/ directory. |
Note
vars
and defaults
for the role are exposed at playbook parsing time. Due to this, these variables will be accessible to roles and tasks executed before the location of the import_role task.See also
- hosts: all
tasks:
- import_role:
name: myrole
- name: Run tasks/other.yaml instead of 'main'
import_role:
name: myrole
tasks_from: other
- name: Pass variables to role
import_role:
name: myrole
vars:
rolevar1: value from task
- name: Apply condition to each task in role
import_role:
name: myrole
when: not idontwanttorun
More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.
Hint
If you notice any issues in this documentation you can edit this document to improve it.