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.
GitHub AE is currently under limited release.

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.

Criando uma versão

  1. No your enterprise, 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. 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.

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

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

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

  9. 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 AE 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 your enterprise, 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 your enterprise, 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