Типовой проект#
Использование типовой структуры проектов Ansible позволяет упростить их создание, использование и поддержку.
Файлы и каталоги#
Структура типового проекта Ansible, для запуска которого используется Automation Cotnroller или Ansible Navigator имеет следующий вид:
Указанные файлы и каталоги используются для следующих целей:
playbooks/
.Каталог с файлами playbook. Если проект содержит только один файл playbook, допускается разместить его в корневом каталоге проекта.
inventory/
.Каталог с файлами инвентаря. Рекомендуемый формат файлов – YAML.
Если инвентарь состоит из одного файла, допускается разместить его в корневом каталоге проекта. Рекомендуемое имя файла в этом случае –
inventory.yml
.files/
.Каталог с файлами, используемыми при сборке образа среды исполнения.
vars/
.Каталог с файлами с переменными, используемыми в playbook.
Если все переменные хранятся в одном файле, допускается разместить его в корневом каталоге проекта. Рекомендуемое имя файла в этом случае –
vars.yml
.execution-environment.yml
.Файл определения среды исполнения, используемой для запуска playbook. Подробности см. в инструкции по созданию собственных образов среды исполнения.
Рекомендуемый порядок действий#
При работе над проектом рекомендуется следующий порядок действий:
Определите список используемых сторонних коллекций, изучите особенности их использования.
Напишите код и отладьте его с помощью Ansible Navigator.
Если проект зависит от сторонних коллекций, выполните следующие действия:
Создайте собственный образ среды исполнения, включающий все необходимые коллекции. Для этого следуйте инструкции.
Опубликуйте созданный образ в Private Automation Hub согласно инструкции.
Загрузите выбранный образ среды исполнения из Private Automation Hub в Automation Controller согласно инструкции.
Для создания проекта следуйте инструкции.
Для создания шаблона задания на основе проекта следуйте инструкции.
Для запуска задания на основе созданного шаблона следуйте инструкции.