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 da versão

Você pode criar versões com notas sobre a versão, @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 obter mais informações, confira "Pontos de extremidade da API REST para versões" na documentação da API REST.

Você também pode publicar uma ação de uma versão específica no GitHub Marketplace. Para obter mais informações, confira "Publicar ações no GitHub Marketplace".

Você pode escolher se objetos Git Large File Storage (Git LFS) estão incluídos nos arquivos ZIP e tarballs que GitHub cria para cada versão. Para obter mais informações, confira "Gerenciando objetos LFS do Git em arquivos do seu repositório".

Criando 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. 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 sobre a versão clicando em Gerar notas sobre a versão.

  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 a versão.

    • Selecione Criar uma discussão para esta versão.
    • Selecione o menu suspenso Categoria e clique em uma categoria para a discussão sobre a versão.

  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. Depois, você poderá ver as versões publicadas ou de rascunho no feed de versões do repositório. Para obter mais informações, confira "Visualizando versões e tags do seu repositório".

Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".

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

    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ê mencionar com @mention qualquer usuário do GitHub nas notas, a versão publicada no GitHub.com incluirá uma seção Colaboradores com uma lista de avatares de todos os usuários mencionados.

Editar 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. 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ário do GitHub na descrição, tais usuários serão adicionados ou removidos da lista de avatares na seção Colaboradores 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 marca da versão a ser excluída. Use o sinalizador -y para ignorar a confirmação.

    gh release delete TAG -y