Рекомендуемая структура каталогов

По мере роста проектов разрозненные файлы превращаются в хаос. Стандартная структура каталогов точно показывает Вашей команде, где что находится. 📁

По соглашению site.yml — это плейбук верхнего уровня, который связывает всю инфраструктуру и подключает остальные компоненты.

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

Разделяйте большие плейбуки на целевые файлы, например webservers.yml и dbservers.yml, а затем объединяйте их из site.yml.

Каталог group_vars содержит переменные, применяемые ко всем группам хостов; они автоматически загружаются по имени группы.

Каталог host_vars делает то же самое для отдельных машин: для каждого хоста используется один файл с его именем.

Повторно используемая автоматизация хранится в каталоге roles. Ansible сначала ищет роли здесь, когда плейбук ссылается на роль по имени.

Папка library содержит пользовательские модули, а module_utils и filter_plugins — общий вспомогательный код, который Ansible обнаруживает автоматически.

Разместите ansible.cfg в корне проекта. Ansible подхватит конфигурацию из текущего каталога, сохраняя настройки локальными для проекта.

При такой структуре одного клонирования git достаточно, чтобы товарищ по команде получил плейбуки, инвентарь, переменные и роли в одной согласованной структуре. 🎯

Вот рекомендуемый каркас, который предлагают официальные документы. Запомните структуру, а не каждый файл.

Какой файл по соглашению является точкой входа верхнего уровня для всего проекта?

Вы изучили стандартную структуру: site.yml, инвентарь, group_vars, host_vars и roles в одном репозитории. Предсказуемая структура масштабируется вместе с Вашей командой. ✅