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. [ядро]

Поддержка 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.9/modules/include_module.html