Usando FQCN: namespace.collection.module
Faça referência ao conteúdo da maneira moderna.
Usando FQCN: namespace.collection.module é uma aula grátis de Ansible Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Ansible Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Ansible Academy inclui 4 aulas no total.
Nomes curtos são ambíguos
Chamar um módulo simplesmente de copy funciona, mas duas coleções podem fornecer um módulo copy cada uma. O FQCN elimina qualquer dúvida sobre qual deles você quer dizer.
FQCN por extenso
FQCN significa Nome completo da coleção: o endereço completo de um módulo, escrito como namespace.collection.module.
Três partes, um caminho pontuado
Leia da esquerda para a direita: o espaço de nomes (proprietário), a coleção (pacote) e, por fim, o módulo. Cada parte restringe exatamente o que será executado.
ansible.builtin.copy
# namespace.collection.moduleO núcleo fica em ansible.builtin
Os módulos clássicos que você já usa ficam na coleção ansible.builtin. Portanto, copy é, nos bastidores, ansible.builtin.copy.
- ansible.builtin.copy:
src: app.conf
dest: /etc/app.confPor que se tornou o padrão
Como agora os módulos ficam em muitas coleções, o FQCN é o único nome que sempre garante a resolução exata do módulo.
Os módulos da comunidade seguem o mesmo padrão
O conteúdo de outros pacotes segue o mesmo padrão, como community.general.ufw para o módulo de firewall dessa coleção.
- community.general.ufw:
rule: allow
port: "22"Os nomes curtos ainda funcionam
Nomes simples como copy continuam válidos para módulos integrados, mas as ferramentas de análise estática agora emitem avisos. Usar o FQCN completo é o estilo recomendado.
Prepara seus roteiros para o futuro
Um FQCN continua funcionando mesmo que uma versão futura do Ansible reorganize o destino dos nomes curtos, mantendo seus roteiros estáveis durante as atualizações.
FQCN também se aplica a funções
As coleções também fornecem funções. Você faz referência a elas usando o mesmo endereço pontuado, como community.general.role_name no seu roteiro.
roles:
- role: geerlingguy.nginxReduza a digitação com collections
Liste uma coleção na chave collections do roteiro e você poderá usar os nomes curtos dos módulos dela, sem o prefixo completo.
collections:
- community.generalFaça do FQCN um hábito
Escrever o FQCN completo desde o início torna os roteiros inequívocos, livres de alertas do analisador e fáceis de rastrear até a origem pelos colegas de equipe.
Verificação rápida
Identifique as partes de um nome de módulo totalmente qualificado.
Recapitulação
Um FQCN tem o formato namespace.collection.module, como ansible.builtin.copy. Ele aponta sem ambiguidade para um único módulo e mantém os roteiros seguros durante as atualizações. 🎯
Perguntas Frequentes
A aula “Usando FQCN: namespace.collection.module” é grátis?
Sim — o texto completo de “Usando FQCN: namespace.collection.module” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Ansible Academy, atualize para CoddyKit PRO. O curso de Ansible Academy inclui 4 aulas no total.
O que vou aprender em “Usando FQCN: namespace.collection.module”?
Faça referência ao conteúdo da maneira moderna. Você pratica Ansible Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Ansible Academy?
Nenhuma experiência prévia é necessária. Ansible Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Usando FQCN: namespace.collection.module”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Ansible Academy?
Sim. Cada aula de Ansible Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Roles versus collections no Galaxy
- Instale roles com requirements.yml
- Usando FQCN: namespace.collection.module
- Publique sua própria role no Galaxy