Crie a estrutura de uma role com ansible-galaxy init
Gere o esqueleto padrão de uma role.
Crie a estrutura de uma role com ansible-galaxy init é 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.
Não faça isso manualmente
Você poderia criar manualmente cada pasta de função, mas o Ansible oferece um comando que gera toda a estrutura em uma única etapa.
ansible-galaxy init
O comando ansible-galaxy init gera um esqueleto completo de função, pronto para ser preenchido, com todos os diretórios padrão.
ansible-galaxy init nginxDê um nome claro à função
O argumento que você fornece se torna o nome da pasta da função. Escolha algo descritivo, como webserver ou postgres, para que sua finalidade seja óbvia.
O que é criado
O comando cria as pastas tasks, handlers, templates, files, vars, defaults, meta e tests, cada uma com um main.yml inicial pronto para edição.
nginx/
tasks/main.yml
handlers/main.yml
defaults/main.yml
meta/main.ymlExecute dentro de roles/
Execute o comando no diretório roles do seu projeto, para que a nova função seja criada onde os playbooks esperam encontrá-la.
cd roles
ansible-galaxy init webserverOs arquivos iniciais são apenas modelos vazios
Cada main.yml gerado vem quase vazio, contendo apenas um comentário de cabeçalho. Você mesmo preenche as tarefas e variáveis reais.
meta já vem preenchido
O modelo meta/main.yml inclui espaços reservados para autor, licença e plataformas. Atualize-os antes de compartilhar a função.
Um README é incluído
O esqueleto também inclui um modelo de README.md, incentivando você a documentar o que a função faz e quais variáveis ela aceita.
Use um caminho personalizado
Informe --init-path para criar a função em outro local que não seja a pasta atual, algo útil quando suas funções ficam em um diretório dedicado.
ansible-galaxy init nginx --init-path roles/Consistência em toda a equipe
Como todas as pessoas geram o esqueleto com o mesmo comando, cada função do projeto compartilha uma estrutura idêntica e previsível.
Depois, comece a escrever as tarefas
Com o esqueleto pronto, seu próximo passo é editar tasks/main.yml para definir o que a função realmente instala ou configura.
Verificação rápida
Lembre-se do comando que gera o esqueleto de uma nova função.
Recapitulação
Execute ansible-galaxy init para gerar instantaneamente um esqueleto completo de função e depois preencha os arquivos de modelo com suas tarefas e variáveis reais. 🛠️
Perguntas Frequentes
A aula “Crie a estrutura de uma role com ansible-galaxy init” é grátis?
Sim — o texto completo de “Crie a estrutura de uma role com ansible-galaxy init” é 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 “Crie a estrutura de uma role com ansible-galaxy init”?
Gere o esqueleto padrão de uma role. 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 “Crie a estrutura de uma role com ansible-galaxy init”?
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
- Por que usar roles: do monólito aos módulos
- Anatomia do diretório de uma role
- Crie a estrutura de uma role com ansible-galaxy init
- Aplique roles e passe variáveis para roles