Używanie FQCN: namespace.collection.module
Odwoływanie się do zawartości w nowoczesny sposób.
Używanie FQCN: namespace.collection.module to bezpłatna lekcja DevOps Bootcamp na CoddyKit. To lekcja 3 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 DevOps Bootcamp, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs DevOps Bootcamp zawiera 4 lekcji w sumie.
Krótkie nazwy są niejednoznaczne
Wywołanie modułu po prostu jako copy działa, ale dwie kolekcje mogą zawierać moduł copy. FQCN usuwa wszelkie wątpliwości co do tego, którego modułu używasz.
FQCN w pełnym brzmieniu
FQCN oznacza Fully Qualified Collection Name: pełny adres modułu zapisany jako namespace.collection.module.
Trzy części, jedna ścieżka rozdzielana kropkami
Czytaj ją od lewej do prawej: przestrzeń nazw (właściciel), kolekcja (pakiet), a następnie moduł. Każda część dokładniej określa to, co zostanie uruchomione.
ansible.builtin.copy
# namespace.collection.moduleRdzeń znajduje się w ansible.builtin
Klasyczne moduły, których już używasz, znajdują się w kolekcji ansible.builtin. Dlatego copy to w rzeczywistości ansible.builtin.copy.
- ansible.builtin.copy:
src: app.conf
dest: /etc/app.confDlaczego stała się domyślnym wyborem
Ponieważ moduły znajdują się teraz w wielu kolekcjach, FQCN jest jedyną nazwą, która za każdym razem gwarantuje wskazanie dokładnie tego samego modułu.
Moduły społeczności mają taki sam format
Zawartość innych pakietów jest zapisywana według tego samego schematu, na przykład community.general.ufw oznacza moduł zapory sieciowej z tej kolekcji.
- community.general.ufw:
rule: allow
port: "22"Krótkie nazwy nadal działają
Zwykłe nazwy, takie jak copy, pozostają prawidłowe dla wbudowanych modułów, ale lintery już Cię o nich ostrzegają. Zalecanym stylem jest używanie pełnego FQCN.
Zabezpiecz playbooki na przyszłość
FQCN nadal działa, nawet jeśli w przyszłości Ansible zmieni sposób wskazywania modułów za pomocą krótkich nazw, dzięki czemu playbooki pozostaną stabilne po aktualizacjach.
FQCN dotyczy także ról
Kolekcje zawierają również role. Odwołujesz się do nich za pomocą tego samego adresu rozdzielanego kropkami, na przykład community.general.role_name w playbooku.
roles:
- role: geerlingguy.nginxMniej pisania dzięki collections
Wymień kolekcję w kluczu collections playbooka, a następnie możesz używać pochodzących z niej krótkich nazw modułów bez pełnego prefiksu.
collections:
- community.generalWyrób sobie nawyk używania FQCN
Zapisywanie pełnego FQCN od początku sprawia, że playbooki są jednoznaczne, przechodzą kontrolę lintera i ułatwiają zespołowi znalezienie źródła modułu.
Szybki test
Wskaż części w pełnej nazwie modułu.
Podsumowanie
FQCN ma postać namespace.collection.module, na przykład ansible.builtin.copy. Jednoznacznie wskazuje pojedynczy moduł i zapewnia bezpieczeństwo playbooków podczas aktualizacji. 🎯
Często zadawane pytania
Czy lekcja „Używanie FQCN: namespace.collection.module” jest bezpłatna?
Tak — pełny tekst „Używanie FQCN: namespace.collection.module” 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 DevOps Bootcamp, przejdź na CoddyKit PRO. Kurs DevOps Bootcamp zawiera 4 lekcji w sumie.
Co nauczysz się w „Używanie FQCN: namespace.collection.module”?
Odwoływanie się do zawartości w nowoczesny sposób. Ćwiczysz DevOps Bootcamp 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ąć DevOps Bootcamp?
Nie wymagamy żadnego doświadczenia. DevOps Bootcamp 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 3 z 4.
Ile czasu zajmuje lekcja „Używanie FQCN: namespace.collection.module”?
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 DevOps Bootcamp?
Tak. Każda lekcja DevOps Bootcamp 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
- Role a Collections w Galaxy
- Instalowanie ról za pomocą requirements.yml
- Używanie FQCN: namespace.collection.module
- Publikowanie własnej roli w Galaxy