Gerenciar versões em repositórios

Você pode criar versões para empacotar e entregar iterações de um projeto para os usuários.

Quem pode usar esse recurso?

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Tool navigation

Neste artigo

Sobre o gerenciamento de lançamentos

Você pode criar novas versões com notas de lançamento, @mentions de colaboradores e links para arquivos binários, além de editar ou excluir as versões existentes. Você também pode criar, modificar e excluir versões usando a API de Versões. Para saber mais, confira Pontos de extremidade da API REST para versões na documentação da API REST.

Criando um release

  1. Em GitHub, acesse a página principal do repositório.

  2. À direita da lista de arquivos, clique em Versões.

    Captura de tela da página principal de um repositório. Um link, rotulado como "Versões", é realçado com um contorno laranja.

  3. Na parte superior da página, clique em Rascunho de uma nova versão.

  4. Para escolher uma tag para a versão, selecione o menu suspenso Escolher uma marca.

    • Para usar uma tag existente, clique na tag.
    • Para criar uma nova tag, digite um número de versão para sua versão e clique em Criar tag.

  5. Se você criou uma nova tag, selecione o menu suspenso Destino e clique no branch que contém o projeto que você deseja liberar.

  6. Opcionalmente, acima do campo de descrição, selecione o menu suspenso Tag anterior e clique na tag que identifica a versão anterior.

    Captura de tela do formulário "Nova versão". Um menu suspenso, rotulado com "Tag anterior: automático" é realçado com um contorno laranja.

  7. No campo "Título da versão", digite um título para sua versão.

  8. No campo "Descrever esta versão", digite uma descrição para sua versão. Se você mencionar alguém com @mention na descrição, a versão publicada incluirá uma seção Colaboradores com uma lista dos avatares de todos os usuários mencionados. Como alternativa, você pode gerar automaticamente as notas de lançamento clicando em Gerar notas de lançamento.

  9. Opcionalmente, para incluir arquivos binários, como programas compilados em sua versão, arraste e solte ou selecione arquivos manualmente na caixa de binários.

  10. Opcionalmente, para notificar os usuários de que a versão não está pronta para produção e pode ser instável, selecione Este é um pré-lançamento.

  11. Opcionalmente, selecione Definir como versão mais recente. Se você não selecionar essa opção, o rótulo de última versão será atribuído automaticamente com base no controle de versão semântico.

  12. Opcionalmente, se GitHub Discussions estiver habilitado para o repositório, crie uma discussão para o lançamento.

    • Selecione Criar uma discussão para esta versão.
    • Selecione o menu suspenso Categoria, depois clique numa categoria para a discussão de lançamento.

  13. Se estiver pronto para tornar sua versão pública, clique em Publicar versão. Para trabalhar na versão posteriormente, clique em Salvar rascunho.

Observação

Para saber mais sobre GitHub CLI, confira Sobre GitHub CLI.

  1. Para criar uma versão, use o subcomando gh release create. Substitua tag pela tag desejada para o release.

    gh release create TAG

  2. Siga as instruções interativas. Como alternativa, você pode especificar argumentos para pular essas instruções. Para obter mais informações sobre os possíveis argumentos, confira o manual da GitHub CLI. Por exemplo, este comando cria uma pré-versão com o título e observações especificadas.

gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a versão prévia pública release" --prerelease

Se você aplicar @mention aos usuários GitHub nas notas, a versão publicada incluirá uma seção Colaboradores com uma lista de avatares de todos os usuários mencionados.

Editar um lançamento

  1. Em GitHub, acesse a página principal do repositório.

  2. À direita da lista de arquivos, clique em Versões.

    Captura de tela da página principal de um repositório. Um link, rotulado como "Versões", é realçado com um contorno laranja.

  3. Ao lado da versão que você deseja editar, clique em .

    Captura de tela de uma versão na lista de versões. Um ícone de lápis é realçado com um contorno laranja.

  4. Edite os detalhes da versão no formulário e clique em Atualizar versão. Se você adicionar ou remover qualquer @mentions de usuários GitHub na descrição, esses usuários serão adicionados ou removidos da lista de avatares na seção Contributors da versão.

  1. Para editar uma versão, use o subcomando gh release edit. Substitua TAG pela tag que representa a versão que você deseja editar. Por exemplo, para editar o título de uma versão, use o seguinte código, substituindo NEW-TITLE pelo título atualizado:

    gh release edit TAG -t "NEW-TITLE"

    Para obter mais informações sobre os possíveis argumentos, confira o manual da GitHub CLI.

Excluir uma versão

  1. Em GitHub, acesse a página principal do repositório.

  2. À direita da lista de arquivos, clique em Versões.

    Captura de tela da página principal de um repositório. Um link, rotulado como "Versões", é realçado com um contorno laranja.

  3. Do lado direito da página, ao lado da versão que você deseja excluir, clique em .

    Captura de tela de uma versão na lista de versões. Um ícone de lixeira é realçado com um contorno laranja.

  4. Clique em Excluir esta versão.

  1. Para excluir uma versão, use o subcomando gh release delete. Substitua tag pela tag da versão a ser excluída. Use o sinalizador -y para ignorar a confirmação.

    gh release delete TAG -y