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

Статус

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

Поддержка

Для получения дополнительной информации о поддержке этого модуля Red Hat, пожалуйста, ознакомьтесь со статьей базы знаний Knowledge Base article

Автор

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