Repolode
Enviar
softprops

softprops/action-gh-release

Uma GitHub Action que cria GitHub Releases e envia artefatos de build a partir de runners Linux, Windows e macOS.

Ver no GitHub
Estrelas
5,794
Forks
645
Issues abertas
123
Último commit
há 15 horas

O que é?

action-gh-release é uma GitHub Action que cria uma GitHub Release para uma tag e envia artefatos de build para ela. Ela costuma ser adicionada como uma etapa de um workflow executado após o build, para anexar automaticamente à release os binários, arquivos compactados ou checksums produzidos pelo pipeline.

A action aceita padrões glob delimitados por linhas na entrada `files` e pode obter as notas da release de um arquivo, via `body_path`, ou usar as notas geradas pelo próprio GitHub. Ela oferece suporte às opções de rascunho e pré-release, à reutilização de uma release existente para a mesma tag, à inclusão de conteúdo no corpo existente, à criação de uma discussão vinculada e à definição da base de comparação das notas geradas. Entre as saídas estão a URL e o ID da release, a URL de upload e uma lista JSON dos artefatos enviados.

A action roda em runners Linux, Windows e macOS. A versão v3 tem como destino o Node 24 e exige a permissão `contents: write` no token do workflow.

Recursos principais

  • 01Cria uma GitHub Release para uma tag ou atualiza a release existente para essa tag.
  • 02Envia arquivos correspondentes a padrões glob, com suporte opcional a um diretório de trabalho.
  • 03Lê as notas da release de um arquivo ou usa as notas geradas pelo GitHub.
  • 04Oferece suporte às configurações `draft`, `prerelease` e `make_latest`.
  • 05Roda em runners Linux, Windows e macOS.
  • 06Retorna a URL e o ID da release, a URL de upload e os detalhes dos artefatos enviados.

Casos de uso

  • Publicar binários compilados por um build de CI em uma GitHub Release quando uma tag de versão é enviada.
  • Anexar automaticamente checksums ou arquivos compactados a cada release.
  • Gerar notas da release a partir de um arquivo de changelog ou das notas geradas automaticamente pelo GitHub durante um build com tag.

Início rápido

  1. 1

    Adicione a etapa de release ao seu arquivo de workflow

    uses: softprops/action-gh-release@v3
  2. 2

    Configure a etapa de release para executar apenas em pushes de tags e liste seus arquivos em files

Antes de usar

  • É executado apenas dentro de workflows do GitHub Actions, não como uma ferramenta independente.
  • Para criar releases em outros repositórios, é necessário um token de acesso pessoal com as permissões adequadas.

Em coleções

Frameworks de teste e ferramentas de automação de testes

Tópicos

#github-actions#ci-cd#github-releases#release-automation#continuous-delivery

Perguntas frequentes

O que é action-gh-release?
Uma GitHub Action que cria GitHub Releases e envia artefatos de build a partir de runners Linux, Windows e macOS. action-gh-release é uma GitHub Action que cria uma GitHub Release para uma tag e envia artefatos de build para ela. Ela costuma ser adicionada como uma etapa de um workflow executado após o build, para anexar automaticamente à release os binários, arquivos compactados ou checksums produzidos pelo pipeline.
action-gh-release é gratuito? Qual é a licença?
action-gh-release é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
action-gh-release ainda é mantido?
Manutenção ativa. O último commit de action-gh-release foi em 5 de nov. de 2026.
Para que posso usar action-gh-release?
Publicar binários compilados por um build de CI em uma GitHub Release quando uma tag de versão é enviada. Anexar automaticamente checksums ou arquivos compactados a cada release. Gerar notas da release a partir de um arquivo de changelog ou das notas geradas automaticamente pelo GitHub durante um build com tag.
Como instalar action-gh-release?
Adicione a etapa de release ao seu arquivo de workflow: uses: softprops/action-gh-release@v3 Configure a etapa de release para executar apenas em pushes de tags e liste seus arquivos em files
Onde consigo action-gh-release?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/softprops/action-gh-release

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados