Utiliser FQCN : namespace.collection.module
Référencez le contenu de manière moderne.
Utiliser FQCN : namespace.collection.module est une leçon Ansible Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Ansible Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Ansible Academy comprend 4 leçons au total.
Les noms courts sont ambigus
Appeler un module simplement copy fonctionne, mais deux collections peuvent chacune fournir un module copy. Le FQCN élimine tout doute sur celui que vous désignez.
Le FQCN en toutes lettres
FQCN signifie Nom de collection entièrement qualifié : l’adresse complète d’un module, écrite sous la forme namespace.collection.module.
Trois parties, un chemin séparé par des points
Lisez-le de gauche à droite : l’espace de noms (le propriétaire), la collection (le paquet), puis le module. Chaque élément précise exactement ce qui sera exécuté.
ansible.builtin.copy
# namespace.collection.moduleLe cœur d’Ansible se trouve dans ansible.builtin
Les modules classiques que vous utilisez déjà se trouvent dans la collection ansible.builtin. Ainsi, copy correspond en réalité à ansible.builtin.copy en interne.
- ansible.builtin.copy:
src: app.conf
dest: /etc/app.confPourquoi il est devenu la valeur par défaut
Puisque les modules résident désormais dans de nombreuses collections, le FQCN est le seul nom garanti pour désigner exactement le même module à chaque fois.
Les modules communautaires ont la même forme
Le contenu des autres paquets suit le même modèle, comme community.general.ufw pour le module de pare-feu de cette collection.
- community.general.ufw:
rule: allow
port: "22"Les noms courts fonctionnent toujours
Les noms simples comme copy restent valides pour les modules intégrés, mais les outils d’analyse statique vous avertissent désormais. Utiliser le FQCN complet est le style recommandé.
Rendez vos playbooks compatibles avec l’avenir
Un FQCN continue de fonctionner même si une future version d’Ansible modifie la destination des noms courts. Vos scénarios restent ainsi stables lors des mises à niveau.
Les FQCN s’appliquent aussi aux rôles
Les collections fournissent également des rôles. Vous les référencez avec la même adresse à points, par exemple community.general.role_name dans votre scénario.
roles:
- role: geerlingguy.nginxRéduire la saisie grâce aux collections
Répertoriez une collection sous la clé collections du scénario, puis vous pourrez utiliser ses noms courts de modules sans le préfixe complet.
collections:
- community.generalFaites du FQCN une habitude
Écrire le FQCN complet dès le départ rend les scénarios non ambigus, conformes aux outils d’analyse et faciles à relier à leur source par vos collègues.
Vérification rapide
Identifiez les éléments d’un nom de module entièrement qualifié.
Récapitulatif
Un FQCN se présente sous la forme namespace.collection.module, comme ansible.builtin.copy. Il désigne sans ambiguïté un seul module et protège les scénarios contre les problèmes lors des mises à niveau. 🎯
Questions Fréquemment Posées
La leçon « Utiliser FQCN : namespace.collection.module » est-elle gratuite ?
Oui — le texte complet de « Utiliser FQCN : namespace.collection.module » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Ansible Academy, passe à CoddyKit PRO. Le cours Ansible Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Utiliser FQCN : namespace.collection.module » ?
Référencez le contenu de manière moderne. Tu pratiques Ansible Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Ansible Academy ?
Aucune expérience préalable n'est requise. Ansible Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.
Combien de temps prend la leçon « Utiliser FQCN : namespace.collection.module » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Ansible Academy ?
Oui. Chaque leçon Ansible Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Rôles ou collections sur Galaxy
- Installer des rôles avec requirements.yml
- Utiliser FQCN : namespace.collection.module
- Publier votre propre rôle sur Galaxy