Включение и импортирование

• Включение и импортирование
• Импортирование плейбуков
• Включение и импортирование файлов задач
• Включение и импортирование ролей

Включение и импортирование

Как отмечалось в Создание многократно используемых плейбуков, инструкции включения и импортирования очень похожи, но движок Ansible обрабатывает их по-разному.

• Все import* инструкции обрабатываются на этапе разбора плейбуков.
• Все include* инструкции обрабатываются при выполнении плейбука.

Для получения информации о компромиссах при использовании каждого типа см. Создание многократно используемых плейбуков.

Обратите внимание, что это поведение изменилось в версии 2.4. До Ansible 2.4 был доступен только include, и его поведение зависело от контекста.

Импортирование плейбуков

Можно включать плейбуки в основной плейбук. Например:

- import_playbook: webservers.yml
- import_playbook: databases.yml

Плейы и задачи из каждого перечисленных плейбуков будут выполняться в порядке их перечисления, как если бы они были определены здесь напрямую.

До версии 2.4 был доступен только include, и он работал как для плейбуков, так и для задач, как для импорта, так и для включения.

Включение и импортирование файлов задач

Разбиение задач на отдельные файлы — отличный способ организовать сложные наборы задач или повторно использовать их. Файл задач просто содержит список задач:

# common_tasks.yml
- name: placeholder foo
  command: /bin/foo
- name: placeholder bar
  command: /bin/bar

Затем вы можете использовать import_tasks или include_tasks для выполнения задач в файле в основном списке задач:

tasks:
- import_tasks: common_tasks.yml
# or
- include_tasks: common_tasks.yml

Вы также можете передавать переменные в импорты и включения:

tasks:
- import_tasks: wordpress.yml
  vars:
    wp_user: timmy
- import_tasks: wordpress.yml
  vars:
    wp_user: alice
- import_tasks: wordpress.yml
  vars:
    wp_user: bob

См. Порядок приоритета переменных: Где следует размещать переменную? для получения дополнительной информации о наследовании и приоритете переменных.

Инструкции включения и импорта задач могут использоваться на любой глубине.

Включения и импорты также могут быть использованы в разделе handlers:. Например, если вы хотите определить, как перезапустить Apache, вам нужно сделать это только один раз для всех ваших плейбуков. Вы можете создать handlers.yml , который выглядит так:

# more_handlers.yml
- name: restart apache
  service: name=apache state=restarted

А в вашем основном файле плейбука:

handlers:
- include_tasks: more_handlers.yml
# or
- import_tasks: more_handlers.yml

Вы можете смешивать включения с обычными задачами и обработчиками.

Включение и импортирование ролей

Подробную информацию об включении и импортировании ролей см. в Ролях.