Usar tags 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 marcas leves e anotadas de dentro do 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

O modo de exibição Marcas no Visual Studio foi introduzido no Visual Studio 2017 Atualização 6. Se você estiver em versões anteriores a esta, poderá exibir e criar marcas a partir das exibições de histórico e detalhes de confirmação a partir do Visual Studio 2015, mas não poderá executar as operações no modo de exibição Marcas , conforme descrito neste artigo.

Ver e filtrar etiquetas

Browser

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 Apresentando o Azure DevOps, Alternar organizações existentes para usar a nova 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 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 exibir tags de uma ramificação específica na visualização Confirmações, navegue até seu repositório no portal da Web, escolha Repositórios, Confirmações e selecione sua ramificação.

Visual Studio

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 versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como 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 tags leves têm apenas o nome da tag 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, você deve ter a permissão Criar tag , que é incluída por padrão no grupo Colaboradores e superior.

Nota

Os nomes de marcas 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.

Browser

Você pode criar tags anotadas usando o portal da Web a partir do modo de exibição Tags e do modo de exibição Confirmações .

Importante

Você só pode criar marcas 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 a partir da qual Marca, insira uma Descrição (necessária já que você está criando uma tag anotada) e selecione Criar.

   

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

   

Criar tags a partir do modo de exibição Confirmações

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.

Visual Studio

Você pode criar marcas anotadas e leves no Visual Studio a partir do modo de exibição Histórico e do modo de exibição Marcas . 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 ramificação para ver o histórico, clique com o botão direito do rato numa confirmação e selecione Nova Etiqueta.

   

3. Na caixa de diálogo Criar uma nova etiqueta, introduza um Nome de etiqueta apenas para uma etiqueta leve ou um Nome da etiqueta e Mensagem de etiqueta para uma etiqueta anotada. Selecione Criar.

Criar etiquetas a partir da vista Etiquetas

Nota

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como 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 a ramificação a partir da qual criar a marca, desmarque a caixa de seleção Criar marca contra a ponta da ramificação atual e selecione uma ramificação na lista suspensa Selecionar uma ramificação .

   

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 marcas por meio de um pipeline do Azure usando o git tag comando. Para obter mais informações, consulte git tag.

Excluir tag

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 excluir uma tag, você deve ter a permissão Force push no nível do repositório ou no nível Todas as tags (que herda suas permissões do nível do repositório se não estiver explicitamente definida). O criador também herda permissões Force push para uma tag.

Browser

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.

   

Visual Studio

Nota

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como 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

Browser

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.

   

Visual Studio

As etapas neste procedimento mostram como criar uma ramificação a partir de uma marca usando o Visual Studio 2019 Team Explorer. Para o Visual Studio 2019 usando o menu Git ou o Visual Studio 2022, use o navegador.

Nota

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como 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

Browser

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.

   

Visual Studio

As etapas neste procedimento mostram como exibir o histórico de marcas usando o Visual Studio 2019 Team Explorer. Para o Visual Studio 2019 usando o menu Git ou o Visual Studio 2022, use o navegador.

Nota

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como 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 .