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

Примечание

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

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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
apply строка добавлен в 2.7 of ansible.builtin		Принимает хеш с ключевыми словами задач (например, `tags`, `become`), которые будут применены к задачам внутри включения.
file строка добавлен в 2.7 of ansible.builtin		Имя импортируемого файла указывается напрямую без каких-либо других параметров. В отличие от ansible.builtin.import_tasks, большинство ключевых слов, включая циклы, с помощью элементов и условных выражений, применяются к этому оператору. Цикл 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.
Включение и импортирование: Дополнительная информация об использовании и импортировании плейбуков, ролей и задач.

Примеры

- 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/include_tasks_module.html