Rivalry2

HTML Diff

2 added 1 removed

Original 2026-01-01

Modified 2026-02-26

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

2 Роли можно изучать на базе существующих, открыв их, например, на Github. А можно создать новую роль с нуля, чтобы увидеть, базовую структуру, которая туда была заложена. Пойдем по второму пути и создадим новую роль с помощью команды ansible-galaxy.

3 Выполнять саму команду генерации можно в любом месте, если планируется эту роль добавлять на Github и публиковать в Ansible Galaxy. Но можно пойти и по другому пути. Если разместить содержимое роли в директорииrolesв корне проекта где запускается Ansible, то появится возможность использовать эту роль напрямую, без необходимости публиковать ее в Galaxy.

4 Команда выше создаст базовую структуру роли, добавив в нее файлы и директории, необходимые для работы роли. Всего 8 директорий.

5 Из всех файлов в структуре выше, обязательными являются толькоmeta/main.ymlиtasks/main.yml. Остальные появляются в зависимости от обстоятельств. Вот их предназначение:

6 <ul><li>defaults: содержит значения переменных по умолчанию. Эти значения могут быть изменены во время использования роли в плейбуке.</li>

7 <li>files: сюда добавляются любые необходимые файлы, которые нужны роли.</li>

8 <li>handlers: обработчики, которые могут быть использованы ролью.</li>

9 <li>meta: содержит метаданные роли. Сюда входит лицензия, информация о платформе зависимости и многое другое.</li>

10 <li>tasks: задачи роли, которые выполняются во время ее запуска.</li>

11 <li>templates: шаблоны роли.</li>

12 <li>tests: тесты роли.</li>

13 <li>vars: переменные роли.</li>

14 <li>README.md: описание, которое будет использоваться как документация.</li>

15 - </ul>Метаданные выполняют несколько задач. Во-первых, они описывают роль и помогают ее найти в Ansible Galaxy. Во-вторых, с их помощью указываются зависимости, другие роли, которые используются внутри этой.

15 + </ul><h2>Метаданные</h2>

16 + Метаданные выполняют несколько задач. Во-первых, они описывают роль и помогают ее найти в Ansible Galaxy. Во-вторых, с их помощью указываются зависимости, другие роли, которые используются внутри этой.

16 <h2>Задачи и обработчики</h2>

17 <h2>Задачи и обработчики</h2>

17 Файлtasks/main.yml, представляет собой playbook, который будет запущен на выполнение при включении роли в playbook проекта или другой роли. По умолчанию этот файл пустой. Ожидается, что мы добавим сюда необходимые задачи.

18 Файлtasks/main.yml, представляет собой playbook, который будет запущен на выполнение при включении роли в playbook проекта или другой роли. По умолчанию этот файл пустой. Ожидается, что мы добавим сюда необходимые задачи.

18 Если задач станет много, то их можно будет разбить на разные файлы внутри директорииtasks.main.ymlбудет точкой входа, которая включает в себя все эти файлы. Принцип разделения по файлам может быть разным, один из классических примеров это разные файлы с задачами под разные платформы.

19 Если задач станет много, то их можно будет разбить на разные файлы внутри директорииtasks.main.ymlбудет точкой входа, которая включает в себя все эти файлы. Принцип разделения по файлам может быть разным, один из классических примеров это разные файлы с задачами под разные платформы.

19 Если задачам роли нужны обработчики, то они добавляются в директориюhandlers/main.yml. Ansible автоматически их найдет и подключит.

20 Если задачам роли нужны обработчики, то они добавляются в директориюhandlers/main.yml. Ansible автоматически их найдет и подключит.

20 <h2>Переменные роли</h2>

21 <h2>Переменные роли</h2>

21 Для определения переменных, Ansible предлагает два разных варианта: директориюdefaultsи директориюvars. И там и там хранятся переменные, которые роль использует для своей работы. Разница между этими директориями заключается в том, что вvarsхранятся переменные, которые нужны роли для ее работы, но пользователю про них знать не нужно, это внутренние переменные.defaultsже содержит переменные, которые пользователь роли может или должен задать при использовании этой роли. Типичный пример параметра по умолчанию, это номер версии устанавливаемой программы. Обычно его можно поменять, без необходимости менять внутренности роли.

22 Для определения переменных, Ansible предлагает два разных варианта: директориюdefaultsи директориюvars. И там и там хранятся переменные, которые роль использует для своей работы. Разница между этими директориями заключается в том, что вvarsхранятся переменные, которые нужны роли для ее работы, но пользователю про них знать не нужно, это внутренние переменные.defaultsже содержит переменные, которые пользователь роли может или должен задать при использовании этой роли. Типичный пример параметра по умолчанию, это номер версии устанавливаемой программы. Обычно его можно поменять, без необходимости менять внутренности роли.

22 <h2>Шаблоны и файлы</h2>

23 <h2>Шаблоны и файлы</h2>

23 Остальные директории могут содержать типовые файлы, которые встречаются в playbook. Структура этих директорий никак не специфицирована. Все файлы внутри них раскладываются так как удобно создателю роли.

24 Остальные директории могут содержать типовые файлы, которые встречаются в playbook. Структура этих директорий никак не специфицирована. Все файлы внутри них раскладываются так как удобно создателю роли.