Usar FQCN: namespace.collection.module
Haga referencia al contenido de la forma moderna
Usar FQCN: namespace.collection.module es una lección gratuita de Ansible Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Ansible Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Ansible Academy incluye 4 lecciones en total.
Los nombres cortos son ambiguos
Llamar a un módulo simplemente copy funciona, pero dos colecciones podrían incluir cada una su propio copy. El FQCN elimina cualquier duda sobre cuál quiere decir.
FQCN explicado
FQCN significa Fully Qualified Collection Name: la dirección completa de un módulo, escrita como namespace.collection.module.
Tres partes, una ruta con puntos
Léalo de izquierda a derecha: el namespace (propietario), la colección (paquete) y, después, el módulo. Cada parte determina con mayor precisión qué se ejecuta.
ansible.builtin.copy
# namespace.collection.moduleCore vive en ansible.builtin
Los módulos clásicos que ya utiliza se encuentran en la colección ansible.builtin. Por eso, internamente, copy es realmente ansible.builtin.copy.
- ansible.builtin.copy:
src: app.conf
dest: /etc/app.confPor qué se convirtió en el valor predeterminado
Ahora que los módulos se encuentran en muchas colecciones, el FQCN es el único nombre que garantiza resolver siempre el módulo exacto.
Los módulos de la comunidad tienen el mismo formato
El contenido de otros paquetes sigue el mismo patrón, como community.general.ufw para el módulo de firewall de esa colección.
- community.general.ufw:
rule: allow
port: "22"Los nombres cortos siguen funcionando
Los nombres simples, como copy, siguen siendo válidos para los módulos integrados, pero los linters ahora le advierten. Usar el FQCN completo es el estilo recomendado.
Proteja sus playbooks frente al futuro
Un FQCN sigue funcionando aunque una versión futura de Ansible reorganice el destino de los nombres cortos, por lo que sus plays permanecen estables entre actualizaciones.
Los FQCN también se aplican a los roles
Las colecciones también incluyen roles. Puede hacer referencia a ellos con la misma dirección separada por puntos, como community.general.role_name en su play.
roles:
- role: geerlingguy.nginxEscriba menos con collections
Enumere una colección bajo la clave collections del play y, a partir de entonces, podrá usar los nombres cortos de sus módulos sin el prefijo completo.
collections:
- community.generalConvierta FQCN en un hábito
Escribir el FQCN completo desde el principio hace que los playbooks sean inequívocos, estén limpios para el linter y sean fáciles de rastrear hasta su origen por parte del equipo.
Comprobación rápida
Identifique las partes de un nombre de módulo completamente cualificado.
Resumen
Un FQCN tiene el formato namespace.collection.module, como ansible.builtin.copy. Apunta sin ambigüedades a un único módulo y mantiene los playbooks preparados para las actualizaciones. 🎯
Preguntas frecuentes
¿La lección «Usar FQCN: namespace.collection.module» es gratis?
Sí — el texto completo de «Usar FQCN: namespace.collection.module» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Ansible Academy, actualiza a CoddyKit PRO. El curso de Ansible Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Usar FQCN: namespace.collection.module»?
Haga referencia al contenido de la forma moderna Practicas Ansible Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Ansible Academy?
No se requiere experiencia previa. Ansible Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Usar FQCN: namespace.collection.module»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Ansible Academy?
Sí. Cada lección de Ansible Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Roles frente a collections en Galaxy
- Instalar roles con requirements.yml
- Usar FQCN: namespace.collection.module
- Publicar su propio role en Galaxy