Usar marcas de Git

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O Azure DevOps dá suporte a marcas anotadas e leves. Marcas leves são um ponteiro para confirmação específica, enquanto as marcas anotadas contêm mais informações, como o marcador, a mensagem e a data. Você pode criar marcas anotadas usando o portal da Web. Você pode criar marcas leves e anotadas de dentro do Visual Studio. Para obter mais informações sobre marcas do Git, consulte 2.6 Noções básicas do Git – Marcação do livro Pro Git.

Este artigo fornece uma visão geral de como trabalhar com marcas de Git no Azure DevOps e no Visual Studio.

Importante

O modo de exibição de 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 do histórico e confirmar exibições de detalhes a partir do Visual Studio 2015, mas não poderá executar as operações no modo de exibição Marcas, conforme descrito neste artigo.

Exibir e filtrar marcas

Navegador

Você pode exibir marcas no modo de exibição Marcas e no modo de exibição Confirmações no portal da Web.

Observação

Com Azure DevOps Services, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, ainda há suporte para o visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Exibir marcas no modo de exibição Marcas

1. Para exibir as marcas no repositório, navegue até o seu projeto no portal da Web, escolha Repositórios, Marcas e selecione o repositório desejado.

   

   As marcas anotadas são exibidas com um nome de marca, mensagem, confirmação, marcador e data de criação. Marcas leves são exibidas com um nome de marca e confirmação.

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

   

Exibir marcas no modo de exibição Confirmações

Para exibir marcas de um branch específico no modo de exibição Confirmações, navegue até o repositório no portal da Web, escolha Repositórios, Confirmações e selecione seu branch.

Visual Studio

Exibir marcas no modo de exibição Histórico

Exibir marcas no modo de exibição Histórico.

1. No menu Git na barra de menus, selecione Gerenciar Branches.

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

   

   As formas vermelhas são branches e as formas verdes são marcas.

Exibir marcas no modo de exibição Marcas

Observação

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações sobre como 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 exibir todas as marcas em um repositório, selecione Marcas no modo de exibição Página Inicial.

   

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

   

   As marcas anotadas exibem uma dica de ferramenta que contém o nome da marca, o marcador, a data da marca e a mensagem. As marcas leves têm apenas o nome da marca na dica de ferramenta.

   

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

   

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

   

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

Criar marca

Para criar uma marca, você deve ter a permissão Criar marca , que é incluída por padrão no grupo Colaboradores e superior.

Observação

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

Navegador

Você pode criar marcas anotadas usando o portal da Web no modo de exibição Marcas e no modo de exibição Confirmações.

Importante

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

Criar marcas no modo de exibição Marcas

1. Selecione Criar marca na exibição Marcas no portal da Web para criar uma nova marca anotada.

   

2. Especifique um Nome, selecione a ramificação da qual a Tag deve ser marcada, insira uma Descrição (necessária, pois você está criando uma tag anotada) e selecione Criar.

   

3. A nova marca é exibida na lista de marcas.

   

Criar marcas no modo de exibição Confirmações

Para criar uma marca diretamente no modo de exibição confirmações, clique com o botão direito do mouse na marca desejada e escolha Criar marca.

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 marca anotada, forneça um nome e uma mensagem ao criar a marca. Para criar uma marca leve, omita a mensagem e forneça apenas um nome.

Criar marcas no modo de exibição Histórico

Exibir marcas no modo de exibição Histórico.

1. No menu Git na barra de menus, selecione Gerenciar Branches.

2. Selecione um branch para exibir o histórico, clique com o botão direito do mouse em uma confirmação e selecione Nova Marca.

   

3. Na caixa de diálogo Criar uma nova marca, insira o Nome da marca somente para uma marca leve ou o Nome da marca e Mensagem da marca para uma marca anotada. Selecione Criar.

Criar marcas no modo de exibição Marcas

Observação

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações sobre como 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 Marca no modo de exibição Marcas para criar uma nova marca.

   

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

   

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

   

3. A nova marca é criada localmente. Clique com o botão direito do mouse na nova marca e escolha Push para enviar por push para o repositório remoto. Selecione Enviar Por Push Tudo para enviar todas as novas marcas 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 marca

Importante

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

Para excluir uma tag, você deve ter a permissão Forçar 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 for definido explicitamente). O criador também herda as permissões de push forçado para uma tag.

Navegador

Excluir uma marca no repositório remoto

As etapas neste procedimento mostram como excluir uma marca no repositório remoto usando o portal da Web Azure DevOps Services.

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

   

2. Selecione Excluir para confirmar.

   

3. A marca é excluída e não será exibida na próxima vez que você navegar até o modo de exibição Marcas.

   

Visual Studio

Observação

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

Clique com o botão direito do mouse na marca a excluir e escolha Excluir Localmente

Importante

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

Criar branch da marca

Navegador

1. Para criar um branch a partir de uma marca, selecione as reticências à direita do nome da marca e escolha Novo branch.

   

2. Especifique um Nome, opcionalmente selecione todos os Itens de trabalho a serem vinculados e escolha Criar branch.

   

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 um branch de uma marca usando o Team Explorer do Visual Studio 2019. Para o Visual Studio 2019 usando o menu Git ou o Visual Studio 2022, use o navegador.

Observação

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações sobre como 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 um branch de uma marca, clique com o botão direito do mouse na marca e escolha Novo Branch Local De. Você também pode escolher Criar Branch da Marca.

   

2. Especifique um nome do branch, verifique a marca desejada e escolha Criar Branch. Para fazer check-out da nova ramificação, escolha Checkout branch.

   

3. Para exibir seu branch recém-criado, selecione Branches no modo de exibição Página Inicial.

   

4. Sua nova ramificação é criada localmente. Para efetuar push do branch, clique com o botão direito do mouse nele e escolha Efetuar push do Branch.

   

Exibir histórico de marca

Navegador

1. Para exibir o histórico de uma marca, selecione as reticências à direita do nome da marca e escolha Exibir 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 Team Explorer do Visual Studio 2019. Para o Visual Studio 2019 usando o menu Git ou o Visual Studio 2022, use o navegador.

Observação

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações sobre como 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 exibir o histórico de uma marca, clique com o botão direito do mouse na marca e escolha Exibir Histórico.

   

2. O histórico é exibido no modo de exibição Histórico.