include – Включение списка задач или плейбука

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

Описание

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

Параметры

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

Примечания

Примечание

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

См. также

import_playbook – Импортировать плейбук: Официальная документация модуля import_playbook.
import_role – Импортировать роль в плейбук: Официальная документация модуля import_role.
import_tasks – Импортировать список задач: Официальная документация модуля import_tasks.
include_role – Загрузить и выполнить роль: Официальная документация модуля include_role.
include_tasks – Динамически включить список задач: Официальная документация модуля include_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 Core. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний 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.8/modules/include_module.html