Usar FQCN: namespace.collection.module

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 significa Fully Qualified Collection Name: la dirección completa de un módulo, escrita como namespace.collection.module.

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.

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.

Ahora que los módulos se encuentran en muchas colecciones, el FQCN es el único nombre que garantiza resolver siempre el módulo exacto.

El contenido de otros paquetes sigue el mismo patrón, como community.general.ufw para el módulo de firewall de esa colección.

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.

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.

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.

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.

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.

Identifique las partes de un nombre de módulo completamente cualificado.

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. 🎯