Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Gerenciar versões em repositórios

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

Who can use this feature

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

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 "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 "Como publicar uma ação 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 Enterprise Cloud cria para cada versão. Para obter mais informações, confira "Como gerenciar objetos do Git LFS nos arquivos do repositório".

Criando uma versão

  1. No GitHub.com, navegue até a página principal do repositório. 1. À direita da lista de arquivos, clique em Versões. Seção de versões na barra lateral à direita

  2. Clique em Criar rascunho de uma nova versão.

    Botão Releases draft (Rascunho de versões)

  3. Clique em Escolher uma tag, digite um número de versão para o lançamento e pressione Enter. Como alternativa, selecione um tag existente.

    Insira uma tag

  4. Se estiver criando uma marca, clique em Criar marca.

    Captura de tela da confirmação de que você deseja criar uma tag

  5. Se você criou uma nova tag, use o menu suspenso para selecionar o branch que contém o projeto que você deseja liberar.

    Captura de tela da lista suspensa para escolher um branch

  6. Opcionalmente, no canto superior direito da caixa de texto de descrição, selecione o menu suspenso Tag anterior e clique na tag que identifica a versão anterior. Captura de tela mostrando como selecionar uma tag para identificar a versão anterior

  7. Digite um título e uma descrição para a 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.

    Captura de tela da descrição das versões

  8. 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.

    GIF animado do fornecimento de um DMG com a versão

  9. 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.

    Captura de tela da caixa de seleção para marcar uma versão como pré-lançamento

  10. Opcionalmente, você pode selecionar 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.

    Captura de tela da caixa de seleção para marcar uma versão como último lançamento

  11. Opcionalmente, se as GitHub Discussions estiverem habilitadas no repositório, selecione Criar uma discussão para esta versão e selecione o menu suspenso Categoria e clique em uma categoria para ver a discussão sobre a versão.

    Captura de tela da caixa de seleção usada para criar uma discussão sobre a versão e um menu suspenso usado para escolher uma categoria

  12. 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. Botões Publicar versão e Criar rascunho de versão 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 "Captura de tela de versões e tags do repositório".

    Versão publicada com colaboradores mencionados com @mentioned

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

  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 beta release" --prerelease

    Se você mencionar com @mention qualquer usuário do GitHub Enterprise Cloud 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. No GitHub.com, navegue até a página principal do repositório. 1. À direita da lista de arquivos, clique em Versões. Seção de versões na barra lateral à direita
  2. No lado direito da página, ao lado da versão que deseja editar, clique em . Editar uma versão
  3. Edite os detalhes da versão no formulário e clique em Atualizar versão. Se você adicionar ou remover as @mentions de usuários do GitHub na descrição, esses usuários serão adicionados à lista de avatares ou removidos dela na seção Colaboradores da versão. Atualizar uma versão

As versões não podem ser editadas com GitHub CLI.

Excluir uma versão

  1. No GitHub.com, navegue até a página principal do repositório. 1. À direita da lista de arquivos, clique em Versões. Seção de versões na barra lateral à direita
  2. No lado direito da página, ao lado da versão que você deseja excluir, clique em . Excluir uma versão
  3. Clique em Excluir esta versão. Confirmar a exclusão da 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