Gerenciar versões com os repositórios do GitHub

Concluído

Parte do processo de lançamento começa com o controle de versão. Você entenderá como gerenciar versões no repositório usando o GitHub.

Nos módulos a seguir, você verá detalhes sobre como implantar um software depois de empacotar o código, os arquivos binários, as notas sobre a versão e as tarefas relacionadas.

As versões no GitHub são baseadas em marcas Git. Você pode considerar uma tag como uma foto do estado atual do seu repositório. Se você precisar marcar uma fase essencial do código ou se o seu código de entrega subsequente for concluído, você poderá criar uma tag e usá-la durante o processo de build e lançamento para empacotar e implantar essa versão específica. Para obter mais informações, confira Visualizando versões e tags do seu repositório.

Ao criar versões com notas sobre a versão, é possível fazer @mentions do colaboradores, adicionar links a arquivos binários e editar ou excluir versões existentes.

Referência de imagem: Releases · Microsoft/azure-pipelines-agent (github.com)

Além disso, você pode:

• Publicar uma ação de uma versão específica no GitHub Marketplace.
• Escolher se os objetos LFS do Git são incluídos nos arquivos ZIP e se os tarballs do GitHub são criados para cada versão.
• Receber notificações quando novas versões são publicadas em um repositório.

Criando uma versão

Para criar uma versão, use o comando gh release create. Substitua a tag pelo nome de tag desejado para a versão e siga os prompts interativos.

gh release create tag

Para criar um pré-lançamento com título e notas específicos.

gh release create v1.2.1 --title

Se você aplicar @mention aos usuários 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.

Você pode conferir outros comandos e argumentos no manual da CLI do GitHub.

Editar uma versão

Não é possível editar versões com a CLI do GitHub.

Para editar, use o navegador da Web:

1. Navegue até a página principal do repositório em GitHub.com.
2. À direita da lista de arquivos, clique em Versões.
3. Clique no ícone de edição no lado direito da página, ao lado da versão que você deseja editar.
4. Edite os detalhes da versão e clique em Atualizar versão.

Excluir uma versão

Para excluir uma versão, use o comando a seguir, substitua a tag pela tag da versão a ser excluída e use o sinalizador -y para ignorar a confirmação.

gh release delete tag -y

Para obter mais informações, consulte:

• Gerenciar versões em repositórios – GitHub Docs – Se você quiser executar as mesmas etapas no navegador da Web em vez da CLI do GitHub.
• Publicar ações no GitHub Marketplace.
• Gerenciando objetos LFS do Git em arquivos do seu repositório.
• Visualizando suas assinaturas.