Zalecany układ katalogów

Wraz z rozwojem projektów rozproszone pliki szybko stają się chaotyczne. Standardowy układ katalogów dokładnie wskazuje zespołowi, gdzie znajduje się każdy element. 📁

Zgodnie z przyjętą konwencją site.yml jest głównym playbookiem, który łączy całą infrastrukturę i dołącza pozostałe elementy.

Plik (lub katalog) inventory znajduje się blisko katalogu głównego, dzięki czemu znajdujące się obok playbooki zawsze wiedzą, którymi hostami zarządzają.

Duże playe należy podzielić na wyspecjalizowane pliki, takie jak webservers.yml i dbservers.yml, a następnie połączyć je z poziomu site.yml.

Katalog group_vars zawiera zmienne dotyczące całych grup hostów. Ansible ładuje je automatycznie na podstawie nazwy grupy.

Katalog host_vars działa tak samo w przypadku pojedynczych maszyn — zawiera po jednym pliku nazwanym od każdego hosta.

Wielokrotnego użytku automatyzacja znajduje się w katalogu roles. Ansible najpierw tutaj szuka, gdy play odwołuje się do roli po nazwie.

Folder library zawiera niestandardowe moduły, a module_utils lub filter_plugins — współdzielony kod pomocniczy, który Ansible wykrywa automatycznie.

Plik ansible.cfg należy umieścić w katalogu głównym projektu. Ansible odczytuje konfigurację z bieżącego katalogu, dzięki czemu ustawienia pozostają lokalne dla projektu.

Dzięki takiemu układowi jedno sklonowanie repozytorium git zapewnia członkowi zespołu playbooki, inventory, zmienne i role w jednolitym układzie. 🎯

Oto zalecany szkielet przedstawiany w oficjalnej dokumentacji. Należy zapamiętać układ, a nie każdy plik.

Jaki plik jest umownym głównym punktem wejścia dla całego projektu?

Poznali Państwo standardowy układ: site.yml oraz inventory, group_vars, host_vars i roles w jednym repozytorium. Przewidywalny układ skaluje się wraz z zespołem. ✅