DevOps Bootcamp · Aula

Ações compostas e publicação no Marketplace

Crie ações compostas que reúnam várias etapas, versione-as corretamente e publique sua ação personalizada no GitHub Marketplace para reutilização.

Ações compostas e publicação no Marketplace é uma aula grátis de DevOps Bootcamp 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 DevOps Bootcamp, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de DevOps Bootcamp inclui 4 aulas no total.

Três tipos de ações personalizadas

O GitHub oferece três maneiras de criar uma action personalizada:

Ações de JavaScript — executam código do Node
Ações do Docker — são executadas dentro de um contêiner
Ações compostas — agrupam várias etapas do fluxo de trabalho

Esta lição se concentra em ações compostas e publicação.

O que é uma ação composta

Uma ação composta empacota várias etapas de execução e chamadas a outras ações em uma unidade reutilizável, sem escrever JavaScript ou criar uma imagem do Docker.

Ela é ideal para encapsular uma sequência repetida de comandos do shell.

O arquivo action.yml

Cada ação é definida por um arquivo action.yml na raiz. Para uma ação composta, defina runs.using como composite.

name: Setup Project
description: Install deps and build
runs:
  using: composite
  steps:
    - run: npm ci
      shell: bash
    - run: npm run build
      shell: bash

O shell é obrigatório

Uma regra sutil: nas ações compostas, toda etapa run deve declarar um shell. Esquecê-lo é o erro mais comum ao criar ações compostas.

    - run: echo 'hello'
      shell: bash

Definição das entradas

Deixe a ação configurável com inputs. Os chamadores passam valores por meio de with, e você faz referência a eles como inputs.<name>.

inputs:
  node-version:
    description: Node version
    required: false
    default: '20'
runs:
  using: composite
  steps:
    - run: echo Using ${{ inputs.node-version }}
      shell: bash

Definindo saídas

Uma ação composta pode retornar saídas. Uma etapa grava em GITHUB_OUTPUT, e a ação mapeia esse valor para uma saída nomeada.

outputs:
  build-id:
    value: ${{ steps.gen.outputs.id }}
runs:
  using: composite
  steps:
    - id: gen
      run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
      shell: bash

Usando uma ação local

É possível referenciar por caminho uma ação armazenada no mesmo repositório, o que é ótimo durante o desenvolvimento, antes da publicação.

    steps:
      - uses: actions/checkout@v4
      - uses: ./.github/actions/setup-project
        with:
          node-version: '20'

Versionamento com tags

As ações publicadas são referenciadas por uma referência do git. Uma boa prática é marcar as versões com v1.0.0 e também manter uma tag v1 móvel.

Quem chama a ação usando @v1 recebe automaticamente atualizações que não quebram a compatibilidade.

git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --force

Preparando-se para o Marketplace

Para publicar no Marketplace do GitHub, a ação deve estar em um repositório público com um action.yml contendo name, description e, idealmente, branding (ícone e cor).

branding:
  icon: package
  color: blue

Publicando a versão

Na página Releases do repositório, crie um rascunho de versão para sua tag. O GitHub exibe uma caixa de seleção Publicar esta ação no Marketplace.

Aceite o contrato, escolha as categorias e publique. A ação poderá ser encontrada por qualquer pessoa.

Documentando o uso

Uma boa ação é distribuída com um README claro, que mostra um exemplo de uso, as entradas e as saídas.

As empresas que avaliam sua ação dependem muito dessa documentação; portanto, mantenha-a correta e completa.

Verificação rápida

Teste sua compreensão sobre ações compostas.

Recapitulação

Você aprendeu a criar e publicar ações compostas.

Ações compostas agrupam etapas por meio de runs.using: composite
Toda etapa de execução precisa de um shell explícito
Exponha entradas e saídas para permitir a reutilização
Use versões semânticas e uma tag principal móvel; depois, publique no Marketplace

Ações reutilizáveis são a forma de as equipes ampliarem a lógica compartilhada de CI/CD.

Perguntas Frequentes

A aula “Ações compostas e publicação no Marketplace” é grátis?

Sim — o texto completo de “Ações compostas e publicação no Marketplace” é 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 DevOps Bootcamp, atualize para CoddyKit PRO. O curso de DevOps Bootcamp inclui 4 aulas no total.

O que vou aprender em “Ações compostas e publicação no Marketplace”?

Crie ações compostas que reúnam várias etapas, versione-as corretamente e publique sua ação personalizada no GitHub Marketplace para reutilização. Você pratica DevOps Bootcamp 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 DevOps Bootcamp?

Nenhuma experiência prévia é necessária. DevOps Bootcamp 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 “Ações compostas e publicação no Marketplace”?

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 DevOps Bootcamp?

Sim. Cada aula de DevOps Bootcamp 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

Desenvolvimento de ações personalizadas do GitHub
Executores autogerenciados para ambientes locais
Integração com sistemas corporativos
Ações compostas e publicação no Marketplace

← Voltar para DevOps Bootcamp