ação lançamentos automáticos

Lançamentos automáticos do GitHub

Esta ação simplifica o processo de lançamento do GitHub, carregando automaticamente ativos, gerando changelogs, lidando com pré-lançamentos e assim por diante.

Conteúdo

1. Exemplos de uso
2. Parâmetros suportados
3. Gatilhos de eventos
4. Versionamento
5. Como obter ajuda
6. Licença

NOTA : O repositório marvinpinto/action-automatic-releases é um espelho gerado automaticamente do monorepo marvinpinto/actions contendo esta e outras ações. Por favor, registre problemas e envie solicitações para lá.

Exemplos de uso

Gere automaticamente um pré-lançamento quando as alterações chegarem ao master

Este exemplo de fluxo de trabalho entrará em ação assim que as alterações chegarem master . Depois de executar as etapas para construir e testar seu projeto:

1. Ele criará (ou substituirá) uma tag git chamada latest .
2. Gere um changelog de todos os commits entre este e a latest tag anterior.
3. Gere uma nova versão associada à tag latest (removendo quaisquer versões anteriores associadas).
4. Atualize esta nova versão com o título especificado (por exemplo, Development Build ).
5. Carregue LICENSE.txt e quaisquer arquivos jar como ativos de lançamento.
6. Marque este lançamento como um pre-release .

Você pode ver um exemplo prático desse fluxo de trabalho em marvinpinto/actions.

---
name : " pre-release "

on :
  push :
    branches :
      - " master "

jobs :
  pre-release :
    name : " Pre Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          automatic_release_tag : " latest "
          prerelease : true
          title : " Development Build "
          files : |
            LICENSE.txt
            *.jar

Crie uma nova versão do GitHub quando as tags forem enviadas para o repositório

Semelhante ao exemplo anterior, esse fluxo de trabalho entrará em ação assim que novas tags forem enviadas ao GitHub. Depois de construir e testar seu projeto:

1. Gere um changelog de todos os commits entre esta e a tag semver-looking anterior.
2. Gere uma nova versão e associe-a a esta tag.
3. Carregue LICENSE.txt e quaisquer arquivos jar como ativos de lançamento.

Mais uma vez há um exemplo disso em marvinpinto/actions.

---
name : " tagged-release "

on :
  push :
    tags :
      - " v* "

jobs :
  tagged-release :
    name : " Tagged Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          prerelease : false
          files : |
            LICENSE.txt
            *.jar 

Parâmetros suportados

Parâmetro	Descrição	Padrão
repo_token **	Token de ação do GitHub, por exemplo, "${{ secrets.GITHUB_TOKEN }}" .	null
draft	Marcar este lançamento como rascunho?	false
prerelease	Marcar este lançamento como um pré-lançamento?	true
automatic_release_tag	Nome da tag a ser usada para lançamentos automáticos, por exemplo, latest .	null
title	Título do lançamento; o padrão é o nome da tag se nenhum for especificado.	Nome da etiqueta
files	Arquivos para upload como parte dos ativos de lançamento.	null

Resultados

Os seguintes valores de saída podem ser acessados ​​por meio de ${{ steps..outputs. }} :

Nome	Descrição	Tipo
automatic_releases_tag	A tag de lançamento que esta ação acabou de processar	corda
upload_url	O URL para fazer upload de recursos adicionais para a versão	corda

Notas:

• Os parâmetros indicados com ** são obrigatórios.
• O parâmetro files suporta padrões glob multilinhas, veja exemplos de repositórios.

Gatilhos de eventos

A estrutura GitHub Actions permite acionar esta (e outras) ações em muitas combinações de eventos. Por exemplo, você pode criar pré-lançamentos específicos para tags de candidato a lançamento (por exemplo, *-rc* ), gerar lançamentos conforme as alterações chegam ao master (exemplo acima), lançamentos noturnos e muito mais. Leia a sintaxe do fluxo de trabalho para GitHub Actions para obter ideias e exemplos avançados.

Versionamento

Cada commit que chega ao master para este projeto aciona uma compilação automática, bem como uma versão marcada chamada latest . Se você não deseja viver no limite, você pode usar uma versão estável. Veja lançamentos para as versões disponíveis.

"">

- uses : " marvinpinto/action-automatic-releases@ " 

Como obter ajuda

O README principal deste projeto contém um monte de informações relacionadas à depuração e envio de problemas. Se você ainda estiver preso, tente entrar em contato comigo no keybase e farei o meu melhor para ajudá-lo.

Licença

O código-fonte deste projeto é lançado sob a licença MIT. Este projeto não está associado ao GitHub.