Создание многократно используемых Playbook

• Включение и импорт
• Роли

Хотя можно написать playbook в одном очень большом файле (и вы, возможно, начнете изучение playbooks именно так), в конечном итоге вам захочется повторно использовать файлы и начать организовывать вещи. В Ansible есть три способа сделать это: включение, импорт и роли.

Включение и импорт (добавлены в Ansible версии 2.4) позволяют пользователям разбивать большие playbooks на более мелкие файлы, которые могут использоваться в нескольких родительских playbooks или даже несколько раз в одном и том же Playbook.

Роли позволяют упаковывать вместе больше, чем просто задачи, и могут включать переменные, обработчики или даже модули и другие плагины. В отличие от включения и импорта, роли также могут быть загружены и распространены через Ansible Galaxy.

Динамические и статические

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

В Ansible 2.0 был представлен концепт динамического включения. Из-за некоторых ограничений в создании всех включений динамическими таким образом, в Ansible 2.1 была добавлена возможность принудительного использования статических включений. Поскольку задача include стала перегруженной, охватывая как статический, так и динамический синтаксисы, и поскольку поведение по умолчанию включения может меняться в зависимости от других параметров, установленных в задаче, Ansible 2.4 вводит концепцию include против import.

Если вы используете любую задачу import* (import_playbook, import_tasks, и т. д.), она будет статической. Если вы используете любую задачу include* (include_tasks, include_role, и т. д.), она будет динамической.

Задача include (которая использовалась как для файлов задач, так и для включений на уровне Playbook) по-прежнему доступна, однако теперь она считается устаревшей.

Различия между статическими и динамическими

Два режима работы довольно просты:

• Ansible предварительно обрабатывает все статические импорты во время анализа Playbook.
• Динамические включения обрабатываются во время выполнения в тот момент, когда эта задача встречается.

Что касается опций задачи Ansible, таких как tags и условные операторы (when:) :

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

Взвешивание преимуществ и недостатков между включениями и импортами

Использование include* против import* имеет некоторые преимущества и недостатки, которые пользователи должны учитывать при выборе каждого из них.

Основным преимуществом использования include* заявлений является циклическое повторение. При использовании цикла с включением включенные задачи или роли будут выполняться один раз для каждого элемента в цикле.

Использование include* имеет некоторые ограничения по сравнению с import* заявлениями:

• Теги, которые существуют только внутри динамического включения, не будут отображаться в --list-tags выводе.
• Задачи, которые существуют только внутри динамического включения, не будут отображаться в --list-tasks выводе.
• Вы не можете использовать notify для запуска имени обработчика, который получен изнутри динамического включения (см. примечание ниже).
• Вы не можете использовать --start-at-task для начала выполнения в задаче внутри динамического включения.

Использование import* также может иметь некоторые ограничения по сравнению с динамическими включениями:

• Как указано выше, циклы вообще не могут использоваться с импортами.
• При использовании переменных для имени целевого файла или роли переменные из источников инвентаризации (переменные хоста/группы и т. д.) не могут использоваться.