Usare FQCN: namespace.collection.module

Chiamare un modulo semplicemente copy funziona, ma due collection potrebbero includere entrambe un modulo copy. L'FQCN elimina ogni dubbio su quale si intende.

FQCN significa Fully Qualified Collection Name: l'indirizzo completo di un modulo, scritto come namespace.collection.module.

Lo si legge da sinistra a destra: il namespace (proprietario), la collection (pacchetto) e infine il modulo. Ogni parte restringe il riferimento fino a identificare esattamente ciò che verrà eseguito.

I moduli classici che già utilizza si trovano nella collection ansible.builtin. Quindi copy è in realtà ansible.builtin.copy internamente.

Poiché ora i moduli si trovano in molte collection, l'FQCN è l'unico nome che garantisce di risolvere sempre il modulo esatto.

I contenuti di altri pacchetti seguono lo stesso schema, come community.general.ufw per il modulo firewall di quella collection.

I nomi semplici come copy restano validi per i moduli builtin, ma ora i linter mostrano un avviso. Usare l'FQCN completo è lo stile consigliato.

Un FQCN continua a funzionare anche se una versione futura di Ansible riorganizza la risoluzione dei nomi brevi, così i play restano stabili tra un aggiornamento e l'altro.

Le collection includono anche ruoli. Li si richiama con lo stesso indirizzo puntato, ad esempio community.general.role_name nel play.

Elenchi una collection nella chiave collections del play: potrà così usare i nomi brevi dei moduli di quella collection senza il prefisso completo.

Scrivere subito l'FQCN completo rende i playbook non ambigui, privi di avvisi del linter e facili da ricondurre a una fonte per i membri del team.

Identifichi le parti di un nome di modulo completamente qualificato.

Un FQCN è namespace.collection.module, come ansible.builtin.copy. Identifica senza ambiguità un singolo modulo e mantiene i playbook sicuri durante gli aggiornamenti. 🎯