0Pricing
Ansible Academy · Aula

Publique sua própria role no Galaxy

Compartilhe automação com o mundo.

Publique sua própria role no Galaxy é uma aula grátis de Ansible Academy no CoddyKit. Esta é a aula 4 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.

Contribua com o Hub

Quando uma função resolve um problema de forma limpa, você pode compartilhá-la. A publicação no Galaxy permite que qualquer pessoa instale seu trabalho com um único comando.

O Galaxy lê do GitHub

O Galaxy não hospeda o código por conta própria. Ele importa uma função diretamente de um repositório público do GitHub que pertence a você.

Um repositório, uma função

A configuração mais simples coloca uma única função na raiz do repositório, usando a estrutura padrão criada por ansible-galaxy init.

ansible-galaxy init my_role

meta/main.yml é obrigatório

O Galaxy lê meta/main.yml para obter os metadados. Preencha o autor, uma descrição clara, a licença e as plataformas compatíveis antes da importação.

galaxy_info:
  author: yourname
  description: Configure nginx
  license: MIT

Escreva um README de verdade

Seu README.md é a página inicial da função. Documente o que ela faz e liste todas as variáveis aceitas, com exemplos úteis.

Conecte sua conta do GitHub

Faça login em galaxy.ansible.com usando o GitHub. Isso vincula sua conta para que o Galaxy possa visualizar e importar seus repositórios.

Importe o repositório

No painel do Galaxy, selecione o repositório e inicie uma importação. Em seguida, o Galaxy lê os metadados e publica a função.

Importe pela CLI

Você também pode importar sem usar o site, com um token de API e o subcomando import, informando seu usuário e repositório do GitHub.

ansible-galaxy role import yourname my_role

Os rótulos se tornam versões

O Galaxy transforma os rótulos do Git em versões da função. Envie um rótulo como 1.0.0 para que os usuários possam fixar uma versão específica e estável.

git tag 1.0.0
git push --tags

O nome vem do seu repositório

O nome da função publicada é github_user.repo_name, exatamente a forma como outras pessoas farão referência a ela em requirements.yml.

roles:
  - name: yourname.my_role

Mantenha-a atualizada

Publicar é assumir um compromisso. Responda às questões e envie novos rótulos com correções para que a comunidade continue confiando na sua função.

Verificação rápida

Recapitule de onde o Galaxy obtém o código que publica.

Recapitulação

Crie a estrutura da função, preencha meta/main.yml e o README, envie-os para o GitHub e depois importe a função para o Galaxy. Os rótulos do Git se tornam versões instaláveis. 🚀

Perguntas Frequentes

A aula “Publique sua própria role no Galaxy” é grátis?

Sim — o texto completo de “Publique sua própria role no Galaxy” é 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 “Publique sua própria role no Galaxy”?

Compartilhe automação com o mundo. 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 4 de 4.

Quanto tempo leva a aula “Publique sua própria role no Galaxy”?

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

  1. Roles versus collections no Galaxy
  2. Instale roles com requirements.yml
  3. Usando FQCN: namespace.collection.module
  4. Publique sua própria role no Galaxy
← Voltar para Ansible Academy