Zalecany układ katalogów
Dowiedz się, gdzie znajdują się playbooki, inventory i vars.
Zalecany układ katalogów to bezpłatna lekcja Ansible Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Ansible Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Ansible Academy zawiera 4 lekcji w sumie.
Dlaczego układ ma znaczenie
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. 📁
Punkt wejścia site.yml
Zgodnie z przyjętą konwencją site.yml jest głównym playbookiem, który łączy całą infrastrukturę i dołącza pozostałe elementy.
# site.yml
- import_playbook: webservers.yml
- import_playbook: dbservers.ymlInventory w katalogu głównym
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ą.
myproject/
inventory
site.ymlPlaybooki według funkcji
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
Katalog group_vars zawiera zmienne dotyczące całych grup hostów. Ansible ładuje je automatycznie na podstawie nazwy grupy.
group_vars/
webservers.yml
dbservers.ymlKatalog host_vars
Katalog host_vars działa tak samo w przypadku pojedynczych maszyn — zawiera po jednym pliku nazwanym od każdego hosta.
host_vars/
web01.example.com.ymlKatalog roles
Wielokrotnego użytku automatyzacja znajduje się w katalogu roles. Ansible najpierw tutaj szuka, gdy play odwołuje się do roli po nazwie.
roles/
common/
nginx/Niestandardowe biblioteki i wtyczki
Folder library zawiera niestandardowe moduły, a module_utils lub filter_plugins — współdzielony kod pomocniczy, który Ansible wykrywa automatycznie.
Trzymaj ansible.cfg blisko
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.
# ansible.cfg
[defaults]
inventory = ./inventory
roles_path = ./rolesJedno repozytorium, pełny obraz
Dzięki takiemu układowi jedno sklonowanie repozytorium git zapewnia członkowi zespołu playbooki, inventory, zmienne i role w jednolitym układzie. 🎯
Pełny szkielet
Oto zalecany szkielet przedstawiany w oficjalnej dokumentacji. Należy zapamiętać układ, a nie każdy plik.
myproject/
ansible.cfg
inventory
site.yml
group_vars/
host_vars/
roles/Szybkie sprawdzenie
Jaki plik jest umownym głównym punktem wejścia dla całego projektu?
Podsumowanie
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. ✅
Często zadawane pytania
Czy lekcja „Zalecany układ katalogów” jest bezpłatna?
Tak — pełny tekst „Zalecany układ katalogów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Ansible Academy, przejdź na CoddyKit PRO. Kurs Ansible Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Zalecany układ katalogów”?
Dowiedz się, gdzie znajdują się playbooki, inventory i vars. Ćwiczysz Ansible Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Ansible Academy?
Nie wymagamy żadnego doświadczenia. Ansible Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „Zalecany układ katalogów”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Ansible Academy?
Tak. Każda lekcja Ansible Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Zalecany układ katalogów
- Katalogi group_vars i host_vars
- Dzielenie playbooków za pomocą import i include
- Nazewnictwo, komentarze i styl na dużą skalę