Utilizar etiquetas Git

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O Azure DevOps dá suporte a tags anotadas e leves. As tags leves são um ponteiro para uma confirmação específica, enquanto as tags anotadas contêm mais informações, como o tagger, a mensagem e a data. Você pode criar tags anotadas usando o portal da Web. Você pode criar tanto tags leves quanto anotadas diretamente no Visual Studio. Para obter mais informações sobre tags Git, consulte 2.6 Git Basics - Tagging from the Pro Git book.

Este artigo fornece uma visão geral do trabalho com marcas Git no Azure DevOps e no Visual Studio.

Importante

A vista de Tags no Visual Studio foi introduzida na atualização 6 do Visual Studio 2017. Se estiver em versões anteriores a esta, poderá visualizar e criar tags a partir das visualizações de histórico e detalhes de commit a partir do Visual Studio 2015, mas não poderá executar as operações na vista Tags, conforme descrito neste artigo.

Ver e filtrar etiquetas

Navegador

Pode ver etiquetas na vista Etiquetas e na vista Confirmações no portal Web.

Nota

Com os Serviços de DevOps do Azure, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, o formato anterior que faz referência ao visualstudio.com formato ainda é suportado. Para obter mais informações, consulte Apresentação do Azure DevOps, Mudar organizações existentes para usar o novo URL de nome de domínio.

Ver etiquetas na vista Etiquetas

1. Para visualizar as tags em seu repo, navegue até seu projeto no portal da web, escolha Repos, Tags, e selecione o repositório desejado.

   

   As tags anotadas são exibidas com um nome de tag, mensagem, confirmação, tagger e data de criação. As tags leves são exibidas com um nome de tag e um commit.

2. Para filtrar a lista de tags, digite um termo de pesquisa na caixa Pesquisar nome da tag e pressione Enter.

   

Ver etiquetas na vista Confirmações

Para visualizar as tags de uma ramificação específica na vista Confirmações, navegue até o seu repositório no portal web, escolha Repositórios, Confirmações e selecione a sua ramificação.

Estúdio Visual

Ver etiquetas na vista Histórico

Pode ver etiquetas na vista Histórico.

1. No menu Git na barra de menus, selecione Gerenciar ramificações.

2. Para ver o histórico, selecione uma ramificação.

   

   As formas vermelhas são ramificações e as formas verdes são tags.

Ver etiquetas na vista Etiquetas

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

1. Para ver todas as etiquetas num repositório, selecione Etiquetas na vista Página inicial.

   

2. As tags são exibidas sob o nome do repositório conectado no momento.

   

   As tags anotadas exibem uma dica de ferramenta que contém o nome da tag, o tagger, a data da tag e a mensagem. As etiquetas leves têm apenas o nome da etiqueta na dica de ferramenta.

   

   Para obter mais informações sobre a confirmação marcada, clique com o botão direito do mouse na tag e selecione Exibir detalhes de confirmação.

   

3. Para filtrar a lista de tags, digite um termo de pesquisa na caixa Digite aqui para filtrar a listagem .

   

Para recuperar a lista atual de tags do repositório de origem, execute uma operação de busca .

Criar tag

Para criar uma tag, tenha a permissão Criar tag, que está incluída por padrão no grupo Colaboradores e nos níveis superiores.

Nota

Os nomes de etiquetas não podem conter caracteres de controle ASCII, como espaços, tils e dois pontos. É prática comum usar caracteres minúsculos e separar palavras com hífen. O comprimento do nome da tag não deve exceder 250 caracteres ASCII. Para evitar ambiguidade entre nomes de tags e hashes de confirmação, não use nomes de tags que consistam em 40 caracteres hexadecimais. Para obter mais informações sobre nomenclatura de tags, consulte git-check-ref-format.

Navegador

Você pode criar tags anotadas usando o portal da Web tanto na vista de Tags quanto na vista de Commits.

Importante

Você só pode criar etiquetas anotadas no portal da Web ou no Visual Studio. Para criar uma tag leve, você pode usar a linha de comando do Git.

Criar etiquetas a partir da vista Etiquetas

1. Selecione Criar tag na visualização Tags no portal da Web para criar uma nova tag anotada.

   

2. Especifique um Nome, selecione a ramificação de onde marcar, insira uma Descrição (necessária já que está a criar uma tag anotada) e selecione Criar.

   

3. A nova tag é exibida na lista de tags.

   

Criar tags a partir da vista de Commits

Para criar uma tag diretamente da visualização de confirmações, clique com o botão direito do mouse na tag desejada e escolha Create tag.

Estúdio Visual

Você pode criar tanto tags anotadas como tags leves no Visual Studio a partir da vista de Histórico e da vista de Tags. Para criar uma tag anotada, forneça um nome e uma mensagem ao criar a tag. Para criar uma tag leve, omita a mensagem e forneça apenas um nome.

Criar etiquetas a partir da vista Histórico

Pode ver etiquetas na vista Histórico.

1. No menu Git na barra de menus, selecione Gerenciar ramificações.

2. Selecione uma branch para ver o histórico, clique com o botão direito do rato num commit e selecione Nova Etiqueta.

   

3. Na caixa de diálogo Criar uma nova tag, insira um Nome de tag apenas para um tag leve ou um Nome de tag e Mensagem de tag para um tag anotado. Selecione Criar.

Criar etiquetas a partir da vista Etiquetas

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

1. Selecione Nova etiqueta na vista Etiquetas para criar uma nova etiqueta.

   

2. Para criar uma tag na ponta da ramificação atual, especifique um nome na caixa Digite um nome de tag, opcionalmente forneça uma mensagem de tag e selecione Criar tag.

   

   Para selecionar o ramo a partir do qual criar a etiqueta, desmarque a caixa de seleção Criar etiqueta contra a ponta do ramo atual e selecione um ramo na lista suspensa Selecionar um ramo.

   

3. A nova tag é criada localmente. Clique com o botão direito do mouse na nova tag e escolha Push para enviá-la para o repositório remoto. Selecione Enviar tudo para enviar todas as novas tags locais para o repositório remoto.

   

Você pode criar marcas anotadas programaticamente por meio da API REST do Azure DevOps. Para criar tags através de um pipeline do Azure usando o comando git tag. Para obter mais informações, consulte git tag.

Eliminar etiqueta

Importante

Tenha cuidado ao excluir tags do seu repositório. Se o repositório tiver sido puxado, bifurcado ou clonado por outro usuário, a tag ainda existirá em sua cópia do repositório. Você só deve excluir tags locais ou se tiver certeza de que o repositório não foi puxado, clonado ou bifurcado desde que você criou sua tag.

Para eliminar uma tag, tenha a permissão Force push ao nível do Repositório ou ao nível Todas as tags (que herda as suas permissões do nível do repositório, se não estiver explicitamente definido). O criador também herda permissões Force push para uma tag.

Navegador

Excluir uma tag no repositório remoto

As etapas neste procedimento mostram como excluir uma marca no repositório remoto usando o portal da Web dos Serviços de DevOps do Azure.

1. Para excluir uma tag, selecione as reticências à direita do nome da tag e escolha Excluir tag.

   

2. Selecione Eliminar para confirmar.

   

3. A etiqueta é eliminada e não será apresentada da próxima vez que navegar para a vista Etiquetas.

   

Estúdio Visual

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

As etapas neste procedimento mostram como excluir uma marca no repositório local usando o Visual Studio 2019 Team Explorer.

Clique com o botão direito do mouse na tag a ser excluída e escolha Excluir localmente

Importante

Se sua tag já tiver sido enviada para o repositório remoto, você não deve excluí-la. Se o repositório tiver sido puxado, bifurcado ou clonado por outro usuário, a tag ainda existirá em sua cópia do repositório. Você só deve excluir tags locais.

Criar ramificação a partir de uma tag

Navegador

1. Para criar uma ramificação a partir de uma tag, selecione as reticências à direita do nome da tag e escolha Nova ramificação.

   

2. Especifique um Nome, selecione opcionalmente quaisquer itens de Trabalho a serem vinculados e escolha Criar ramificação.

   

3. A ramificação é criada e você é levado para a nova ramificação no portal da Web.

   

Estúdio Visual

Os passos deste procedimento mostram como criar um ramo a partir de uma tag usando o Visual Studio 2019 Team Explorer. Para o Visual Studio 2019, use o menu do Git, ou para o Visual Studio 2022, use o navegador.

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

1. Para criar uma ramificação a partir de uma tag, clique com o botão direito do mouse na tag e escolha New Local Branch From. Você também pode escolher Criar ramificação a partir da tag.

   

2. Especifique um nome de ramo, verifique a tag desejada e escolha Criar ramificação. Para fazer check-out da nova filial, escolha Checkout branch.

   

3. Para ver a ramificação recém-criada, selecione Ramificações na visualização Página inicial .

   

4. Sua nova ramificação é criada localmente. Para empurrar a ramificação, clique com o botão direito do mouse nela e escolha Push Branch.

   

Ver histórico de tags

Navegador

1. Para visualizar o histórico de uma etiqueta, selecione as reticências à direita do nome da etiqueta e selecione Ver histórico.

   

2. Você é levado para a visualização de confirmações da tag.

   

Estúdio Visual

Os passos deste procedimento mostram como visualizar o histórico de tags usando o Visual Studio 2019 Team Explorer. Para o Visual Studio 2019, use o menu do Git, ou para o Visual Studio 2022, use o navegador.

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

1. Para ver o histórico de uma etiqueta, clique com o botão direito do rato na etiqueta e selecione Ver Histórico.

   

2. O histórico é exibido na visualização Histórico .