include - Включение списка задач или пьесы

Описание
Параметры
Примечания
Примеры
Статус
Техническое сопровождение
- Поддержка
- Автор

Описание

Включает файл со списком пьес или задач, которые должны быть выполнены в текущем плане.
Файлы со списком пьес могут включаться только на верхнем уровне. Списки задач могут включаться только там, где выполняются задачи (в пьесе).
До версии Ansible 2.0 все включения были «статическими» и выполнялись при компиляции пьесы.
Статические включения не поддаются большинству директив. Например, циклы или условные операторы применяются вместо этого к каждой унаследованной задаче.
Начиная с Ansible 2.0, включения задач являются динамическими и ведут себя больше как реальные задачи. Это означает, что они могут циклироваться, пропускаться и использовать переменные из любого источника. Ansible пытается автоматически определить это, но вы можете использовать директиву static (которая была добавлена в Ansible 2.1), чтобы обойти автоматическое определение.
Этот модуль также поддерживается для целевых платформ Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
free-form		Этот модуль позволяет указать имя файла непосредственно без других параметров.

Примечания

Примечание

Это основная функция Ansible, а не модуль, и ее нельзя переопределить как модуль.
Включение имеет некоторые неинтуитивные поведения в зависимости от того, выполняется ли оно в статическом или динамическом режиме в контексте пьесы или плана. В стремлении прояснить поведение, мы переходим к новым модулям (include_tasks, include_role, import_playbook, import_tasks), которые имеют хорошо установленные и ясные правила поведения. Этот модуль все еще будет поддерживаться некоторое время, но мы рассматриваем возможность его устаревания в ближайшем будущем.

Примеры

- hosts: localhost
  tasks:
    - debug:
        msg: play1

- name: Include a play after another play
  include: otherplays.yaml


- hosts: all
  tasks:
    - debug:
        msg: task1

    - name: Include task list in play
      include: stuff.yaml

    - debug:
        msg: task10

- hosts: all
  tasks:
    - debug:
        msg: task1

    - name: Include task list in play only if the condition is true
      include: "{{ hostvar }}.yaml"
      static: no
      when: hostvar is defined

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое сопровождение

Этот модуль помечен как основной, что означает, что он поддерживается Командой разработки Ansible. Подробнее см. Техническое сопровождение и поддержка модулей.

Список других модулей, которые также поддерживаются Командой разработки Ansible, см. здесь.

Поддержка

Дополнительную информацию о поддержке данного модуля компанией Red Hat см. в этой статье базы знаний

Автор

Команда разработчиков Ansible (@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/include_module.html