import_role - Импорт роли в пьесу
Новая версия 2.4.
Обзор
- Подобно ключевому слову
roles:, эта задача загружает роль, но позволяет управлять ею, когда задачи роли выполняются между другими задачами пьесы. - Большинство ключевых слов, циклов и условных операторов будут применяться только к импортированным задачам, а не к этому оператору. Если вам нужно обратное поведение, используйте include_role вместо этого. Для лучшего понимания различий вы можете прочитать Руководство по включению и импорту.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_duplicates | Значение по умолчанию: да | Переопределяет настройку метаданных роли, чтобы разрешить использование роли более одного раза с одними и теми же параметрами. |
| defaults_from | Значение по умолчанию: main | Файл для загрузки из каталога defaults/ роли. |
| name обязательно | Имя роли, которая будет выполнена. | |
| private | Значение по умолчанию: None | Если True, переменные из defaults/ и vars/ в роли не будут доступны остальной части пьесы. |
| tasks_from | Значение по умолчанию: main | Файл для загрузки из каталога tasks/ роли. |
| vars_from | Значение по умолчанию: main | Файл для загрузки из каталога vars/ роли. |
Примечания
Примечание
- Обработчики становятся доступными для всей пьесы.
Примеры
- 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 loop to each task in role
import_role:
name: myrole
with_items:
- '{{ roleinput1 }}'
- '{{ roleinput2 }}'
loop_control:
loop_var: roleinputvar
- name: Apply condition to each task in role
import_role:
name: myrole
when: not idontwanttorun
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- Команда Ansible Core (@ansible)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/import_role_module.html