Роль запускает Playbook, или Playbook запускает роль

Отличный, очень глубокий вопрос, который затрагивает самую суть философии Ansible и понимания композиции его конфигураций. Давайте разберем детально.

Краткий ответ: Playbook запускает роль. Playbook — это отправная точка выполнения, оркестратор, который декларирует что и на каких хостах нужно сделать. Роль (Role) — это модульный, многократно используемый компонент, который описывает как это сделать для конкретной задачи. Playbook "вызывает" или "включает" роль, делегируя ей выполнение определенной части работы.

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

Техническая механика: как это работает

Синтаксически роль подключается в Playbook с помощью директивы roles: или задач include_role: / import_role:.

Пример 1: Классическое объявление ролей в Playbook

---
- name: Развертывание веб-приложения
  hosts: webservers
  become: yes

  # Этот блок "запускает" роли. Они будут выполнены в порядке объявления.
  roles:
    - role: common # Роль для базовой настройки всех серверов
      vars:
        timezone: Europe/Moscow
    - role: nginx  # Роль установки и настройки веб-сервера
    - role: deploy # Роль деплоя кода приложения

В этом примере playbook deploy-app.yml запускает три роли последовательно. Выполнение начинается с playbook.

Пример 2: Динамическое включение роли в рамках задачи

---
- name: Условная установка ПО
  hosts: all
  tasks:
    - name: Проверить, требуется ли база данных
      debug:
        msg: "Проверяем конфигурацию"

    - name: Запустить роль настройки PostgreSQL только если нужно
      include_role:
        name: postgresql
      when: install_postgresql == true # Условный "запуск" роли

Здесь роль postgresql также запускается задачей внутри playbook, причем условие when контролирует, произойдет ли этот запуск.

Архитектурная перспектива: кто главный?

Чтобы понять отношения, представьте себе следующую аналогию:

• Playbook — это режиссерский сценарий для пьесы или фильма. В нем указано: "Сцена 1: Двор замка. Входят серверы webservers. Они выполняют базовую настройку, затем устанавливают Nginx, затем разворачивают приложение".
• Роли — это актерские роли с детально прописанными репликами и действиями ("Роль nginx: Установить пакет nginx -> скопировать конфиг из шаблона -> включить сайт -> перезагрузить сервис"). Режиссерский сценарий (playbook) вызывает актеров (роли) на сцену в нужном порядке.

Playbook обладает более высокоуровневым контекстом:

• Он определяет целевую группу хостов (hosts:).
• Он задает параметры подключения и поведение (become:, vars:, environment:).
• Он управляет порядком выполнения: можно запускать роли, затем задачи, затем обработчики (handlers).
• Он контролирует поток выполнения: условные операторы (when:), теги (tags:), блоки обработки ошибок.

Роль, в свою очередь, — это самостоятельный каталог с предопределенной структурой (tasks/, handlers/, templates/, defaults/, vars/, meta/), который инкапсулирует логику для достижения одной цели. Его основная сила — повторное использование. Одну и ту же роль postgresql можно "запустить" из десятков разных playbook'ов, передавая ей разные переменные (версию СУБД, параметры конфигурации).

Исключения и нюансы

Архитектура Ansible гибка, поэтому есть сценарии, где границы слегка размываются:

1. Мета-зависимости ролей (meta/dependencies.yml). Роль может сама объявлять зависимости от других ролей. При запуске такой роли из playbook, Ansible сначала автоматически выполнит все роли-зависимости.

   # roles/app/meta/main.yml
   dependencies:
     - role: common
     - role: java
   

    Здесь, когда playbook запускает роль `app`, она **косвенно запускает** роли `common` и `java`. Но триггером все равно является playbook.

1. Директива import_role vs include_role. Это важное различие:

    *   `import_role` — статический импорт. Роль "встраивается" в playbook на этапе парсинга. Управление тегами и условия (`when:`) применяются ко всей импортированной роли как к единому блоку.
    *   `include_role` — динамическое включение. Роль выполняется в момент достижения задачи во время выполнения. Это позволяет применять условия и теги к самой задаче включения, а также **циклически запускать одну роль несколько раз с разными параметрами**. В этом смысле задача, использующая `include_role`, выступает как более "активный" запускающий механизм.

Практическая рекомендация: что использовать и когда

• Playbook — это ваш entry point, точка входа для ansible-playbook команды. Он должен быть читаемым, как оглавление или техническое задание. Используйте его для:

    *   Организации высокоуровневых этапов развертывания.
    *   Группировки хостов (например, `[web:children]`).
    *   Определения глобальных переменных окружения.

• Роли — это ваши строительные блоки. Их стоит создавать для всего, что имеет шанс быть повторно использованным: настройка системного пакета (nginx, docker), деплой приложения, настройка мониторинга, конфигурация пользователей.

Итог: Директива ansible-playbook site.yml запускает playbook. Playbook, в свою очередь, содержит инструкции, которые запускают роли для выполнения конкретной работы. Роль — это подчиненный, но мощный и самостоятельный модуль, вызываемый вышестоящим оркестратором — Playbook.