Jinja2 шаблоны

Jinja2 — это мощный движок шаблонизации, который Ansible использует для вычисления выражений, интерполяции переменных и рендеринга динамических конфигурационных файлов. Этот инструмент позволяет создавать гибкие и адаптивные конфигурации, которые могут быть легко изменены и расширены. Значения переменных вставляются с двойными фигурными скобками — {{ variable }} — и могут преобразовываться фильтрами через конвейер, например {{ env | default('production') }} или {{ path | basename }}. Управляющие конструкции вида {% if ansible_os_family == 'Debian' %} и {% for item in packages %} доступны как в файлах шаблонов .j2, так и непосредственно в аргументах задач playbook. Фильтры Jinja2 — один из наиболее важных инструментов для написания переиспользуемой, независимой от среды автоматизации на Ansible; необходимо понимать, как Jinja2 вычисляет значения во время выполнения задачи, а не во время разбора.

Как это работает

Jinja2 шаблоны покрывают приоритет переменных (CLI > playbook > role defaults > inventory) — в документации упоминается 22 уровня приоритета, но на практике достаточно нескольких уровней для эффективного управления конфигурациями. Шаблоны Jinja2 используются для вставки переменных, управления логическими условиями и применения фильтров, например {{ var }}, {% if %}, фильтры default, to_json, regex_replace. Модуль template Ansible рендерит Jinja2-файл с переменными и копирует результат на целевой узел. lookup-плагины Ansible позволяют читать данные из внешних источников, таких как файлы, переменные окружения, пароли, CSV-файлы и Redis.

Когда применять

Для организации переменных рекомендуется использовать структуру Ansible: group_vars/all.yml — для cross-environment дефолтных значений, group_vars/<env>.yml — для перезаписи значений в зависимости от окружения, и host_vars/<host>.yml — для хост-специфических переменных. Jinja2-шаблоны особенно полезны для создания конфигурационных файлов (например, nginx.conf, application.yml), поскольку они позволяют создавать более чистые и управляемые конфигурации, по сравнению с использованием цепочек lineinfile. Фильтр default(value) обеспечивает безопасные fallback значения, что помогает избегать ошибок при отсутствии переменных. Избегайте глубокого вложенного precedence, так как отладка "какое значение выиграло" может быть болезненной.

Типичные ошибки

Типичные ловушки при использовании Jinja2 шаблонов включают в себя применение переменных в нескольких местах без явного победителя ("я же поставил в inventory!"); ошибки Jinja2 в шаблонах, которые работают в среде разработки, но падают в среде производства из-за неопределенных переменных (strict undefined помогает ловить такие ошибки); коммит рендеренных шаблонов в git (следует писать Jinja-источник, а не рендеринг); не знание о возможности использования hostvars для cross-host ссылок.

Связанные понятия

• Переменные и шаблоны
• Приоритет переменных
• Ansible facts
• Фильтры Jinja2