ansible.builtin.import_role – Импорт роли в проигрывание

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля import_role, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 2.4: of ansible.builtin

Описание
Параметры
Примечания
См. также
Примеры

Описание

Подобно ключевому слову roles:, эта задача загружает роль, но позволяет управлять временем выполнения задач роли между другими задачами проигрывания.
Большинство ключевых слов, циклов и условных выражений будут применяться только к импортированным задачам, а не к этому утверждению. Если вы хотите получить обратное поведение, используйте ansible.builtin.include_role вместо этого.
Не работает в обработчиках.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_duplicates boolean	Варианты: no yes ←	Переопределяет установку метаданных роли, чтобы разрешить использование роли более одного раза с теми же параметрами.
defaults_from string	Значение по умолчанию: "main"	Файл для загрузки из каталога `defaults/` роли.
handlers_from string добавлен в 2.8 of ansible.builtin	Значение по умолчанию: "main"	Файл для загрузки из каталога `handlers/` роли.
name string / обязательно		Имя роли, которая должна быть выполнена.
rolespec_validate boolean добавлен в 2.11 of ansible.builtin	Варианты: no yes ←	Выполнить валидацию спецификации аргументов роли, если определена спецификация аргументов.
tasks_from string	Значение по умолчанию: "main"	Файл для загрузки из каталога `tasks/` роли.
vars_from string	Значение по умолчанию: "main"	Файл для загрузки из каталога `vars/` роли.

Примечания

Примечание

Обработчики доступны для всего проигрывания.
С Ansible 2.7 переменные, определённые в vars и defaults для роли, доступны для проигрывания во время разбора плейбука. Благодаря этому эти переменные будут доступны ролям и задачам, выполненным до местоположения задачи ansible.builtin.import_role.
В отличие от ansible.builtin.include_role экспонирование переменных не настраивается и всегда будет экспонировано.

См. также

ansible.builtin.import_playbook: Официальная документация модуля ansible.builtin.import_playbook.
ansible.builtin.import_tasks: Официальная документация модуля ansible.builtin.import_tasks.
ansible.builtin.include_role: Официальная документация модуля ansible.builtin.include_role.
ansible.builtin.include_tasks: Официальная документация модуля ansible.builtin.include_tasks.
Включение и импорт: Дополнительная информация о включении и импорте плейбуков, ролей и задач.

Примеры

- 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)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/import_role_module.html