import_role - Импорт роли в пьесу
Новая версия 2.4.
Обзор
- Подобно ключевому слову
roles:, эта задача загружает роль, но позволяет управлять ею, когда задачи роли выполняются между другими задачами пьесы. - Большинство ключевых слов, циклов и условных операторов будут применяться только к импортированным задачам, а не к этому оператору самому. Если вам нужно обратное поведение, используйте include_role вместо этого. Для лучшего понимания различий можно прочитать Руководство по включению и импорту.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_duplicates bool |
| Переопределяет параметр метаданных роли, чтобы разрешить использование роли более одного раза с одинаковыми параметрами. |
| defaults_from | Значение по умолчанию: "main" | Файл для загрузки из каталога defaults/ роли. |
| name обязательно | Имя роли для выполнения. | |
| private bool |
| Этот параметр не выполняет никаких действий, и функциональность, описанная в предыдущих версиях, не была реализована. Этот параметр будет удален в Ansible v2.8. |
| 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 condition to each task in role
import_role:
name: myrole
when: not idontwanttorun
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как ядро, что означает, что он поддерживается командой Ansible Core. Дополнительную информацию см. в Руководстве по техническому обслуживанию и поддержке модулей.
Список других модулей, также поддерживаемых командой Ansible Core, см. в здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/import_role_module.html
