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 bool |
| Overrides the role's metadata setting to allow using a role more than once with the same parameters. |
defaults_from | Default: main | File to load from a role's defaults/ directory. |
name required | The name of the role to be executed. | |
private bool |
| This option is a no op, and the functionality described in previous versions was not implemented. This option will be removed in Ansible v2.8. |
tasks_from | Default: main | File to load from a role's tasks/ directory. |
vars_from | 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.include_role
variable exposure is not configurable, and will always be exposed.- 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
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Core Team, see here.
For more information about Red Hat’s support of this module, please refer to this Knowledge Base article
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/import_role_module.html