ansible.builtin.include_tasks – Динамически включать список задач

Примечание

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

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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
apply строка добавлен в 2.7 ansible.builtin		Принимает хеш с ключевыми словами задач (например, `tags`, `become`) которые будут применены к задачам внутри include.
file строка добавлен в 2.7 of ansible.builtin		Имя импортируемого файла указывается напрямую без других опций. В отличие от ansible.builtin.import_tasks, большинство ключевых слов, включая цикл, с_items и условия, применяются к этому оператору. Цикл do until не поддерживается в ansible.builtin.include_tasks.
free-form строка		Указание имени файла через свободную форму `- include_tasks: file.yml` файла, который нужно включить, эквивалентно указанию аргумента file.

Примечания

Примечание

Это основная функция Ansible, а не модуль, и её нельзя переопределить, как модуль.

См. также

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

Примеры

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

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

    - debug:
        msg: task10

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

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

- name: Apply tags to tasks within included file
  include_tasks:
    file: install.yml
    apply:
      tags:
        - install
  tags:
    - always

- name: Apply tags to tasks within included file when using free-form
  include_tasks: install.yml
  args:
    apply:
      tags:
        - install
  tags:
    - always

Авторы

Команда 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/include_tasks_module.html