import_role - Импорт роли в пьесу
Новое в версии 2.4.
Описание
- Подобно ключевому слову
roles:, эта задача загружает роль, но позволяет контролировать её выполнение во время выполнения задач роли между другими задачами пьесы. - Большинство ключевых слов, циклов и условных операторов будут применяться только к импортированным задачам, а не к этому оператору. Если требуется обратное поведение, используйте include_role вместо этого.
Параметры
| параметр | обязательный | по умолчанию | значения | комментарии |
|---|---|---|---|---|
| allow_duplicates | нет | True | Переопределяет параметр метаданных роли, разрешая использование роли более одного раза с одинаковыми параметрами. | |
| 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, пожалуйста, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если вы так решите, пожалуйста, ознакомьтесь с Информация о сообществе и вклад, Тестирование 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.4/import_role_module.html