Compartilhar via

Usar rótulos para tirar um instantâneo de seus arquivos no Azure Repos

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Os rótulos do Controle de Versão do Team Foundation (TFVC) fornecem uma maneira de criar uma cópia instantânea dos seus arquivos. Posteriormente, você pode consultar esse instantâneo. Usando seu rótulo, você pode exibir, compilar ou até mesmo reverter um grande conjunto de arquivos para o estado em que eles estavam quando você aplicou o rótulo.

Pré-requisitos

  • Para aplicar um rótulo, é preciso ter a permissão para Rótulo definida como Permitir.
  • Para localizar, listar ou exibir rótulos, a permissão Ler deve estar configurada para Permitir.
  • Para modificar ou excluir um rótulo, você deve possuí-lo ou ter as permissões Administrar Rótulos definidas como Permitir.

Usar rótulos

Em muitos projetos de software, quando o código atinge um nível razoável de qualidade e estabilidade, a equipe cria e lança uma nova versão do produto. A equipe precisa marcar a versão atual de cada arquivo. Mesmo que os arquivos continuem a ser alterados, a equipe ainda pode obter e compilar a nova versão de cada arquivo em seu projeto.

Teoricamente, você pode gravar a ID de cada conjunto de alterações para cada arquivo manualmente. Mas esse tipo de processo não é prático. O TFVC facilita o trabalho. Aplique um rótulo à pasta, ao branch ou ao projeto que contém os arquivos. Você pode dar ao rótulo um nome que siga qualquer convenção de nomenclatura que preferir. Alguns exemplos de nomes de rótulo incluem: "Sprint 5", "M1", "Beta2" e "Release Candidate 0".

Depois de aplicar o rótulo, você pode usá-lo para qualificar operações como compilação, ramificação, mesclagem, comparação e obtenção de versões específicas de arquivos e pastas.

Às vezes, depois de aplicar um rótulo, você decide que precisa alterá-lo. O TFVC fornece uma maneira de aplicar um rótulo a arquivos adicionais, remover um rótulo de determinados arquivos e modificar a qual versão de um arquivo específico um rótulo se aplica.

Dica

A aplicação de um rótulo oferece muitos dos mesmos benefícios que a criação de uma ramificação, mas normalmente com menor custo e complexidade. A compensação é que, para bancos de dados grandes, operações como a mesclagem podem levar muito mais tempo do que o normal durante a execução em um rótulo.

Aplicar um rótulo

Nota

Quando você usa o Visual Studio para aplicar um rótulo que já existe, a operação remove o rótulo de todas as versões de arquivo e aplica o rótulo. No prompt de comando, no entanto, a operação de rotulação é aditiva. Consulte Comando Label (Controle de Versão do Team Foundation).

  1. No menu Exibição do Visual Studio, selecione Outras Janelas>Gerenciador de Controle do Código-Fonte.

  2. No Gerenciador de Controle de Origem, clique com o botão direito do mouse na coleção, projeto, branch, pasta ou arquivo ao qual deseja aplicar um rótulo e selecione Advanced>Aplicar Rótulo. A caixa de diálogo Novo Rótulo aparece.

  3. Na caixa Nome, insira um nome para o rótulo.

  4. (Opcional) Na caixa Comentário, insira um comentário.

  5. Na lista Versão, Última Versão é selecionado por padrão. Essa opção é a mais usada. Se você precisar do rótulo para direcionar uma versão específica, selecione uma das seguintes opções:

    • Conjunto de Alterações: especificar o número de conjunto de alterações na caixa Conjunto de alterações. Como alternativa, selecione as reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de Alterações. Para saber mais, consulte Localizar e exibir conjuntos de alterações.

    • Data: Especificar uma data na caixa Data ou selecionar uma data do calendário no menu suspenso.

    • Label: especifique um rótulo existente para basear o novo rótulo. Insira o nome do rótulo na caixa Rótulo ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.

    • Versão do Workspace: criar o rótulo para a versão em seu workspace.

  6. Quando estiver satisfeito com suas configurações, siga uma das seguintes etapas:

    • Para aplicar o rótulo, selecione Criar.

    • Para aplicar o rótulo e modificá-lo depois de aplicado, selecione Criar e Editar. Isso aplica o rótulo e então exibe a janela Rótulo. Para obter mais informações sobre como usar a janela Rótulo para editar um rótulo, consulte Usar a janela Rótulo para trabalhar com rótulos.

Nota

Quando você aplica um rótulo que usa um nome que já existe, o sistema avisa e pergunta se você deseja continuar. Se você selecionar OK continuar, o TFVC removerá esse rótulo de todos os itens que não estão no caminho ao qual você está aplicando o rótulo.

Renomear um rótulo

Você não pode modificar o nome de um rótulo existente. Mas você pode facilmente aplicar um novo rótulo a exatamente os mesmos arquivos e as mesmas versões às quais outro rótulo se aplica.

  1. No Gerenciador de Controle do Código-Fonte, clique com o botão direito do mouse no nó da coleção do projeto (o nó raiz) e selecione Avançado>Aplicar Rótulo. A caixa de diálogo Novo Rótulo aparece.

  2. Na caixa Nome, insira um nome para o rótulo.

  3. (Opcional) Na caixa Comentário, insira um comentário.

  4. Na lista Versão, selecione Rótulo. A caixa Rótulo aparece.

  5. Siga uma das seguintes etapas:

    • Insira o nome do rótulo existente.

    • Se você não tiver certeza do nome do rótulo existente, selecione o botão procurar com as reticências (...) ao lado da caixa Rótulo. A caixa de diálogo Localizar Rótulo é exibida. Use as opções na caixa de diálogo Localizar Rótulo para filtrar a lista de rótulos e localizar o rótulo existente ao qual você deseja aplicar o novo rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.

  6. Selecione Criar.

  7. (Opcional) Depois de criar o novo rótulo, você pode remover o rótulo antigo. Para obter mais informações, consulte Localizar, editar e remover rótulos.

Listar, localizar, exibir, editar e remover rótulos

Há duas maneiras de listar e localizar rótulos: a caixa de diálogo Localizar Rótulo e a guia Rótulo na janela Histórico. Depois de encontrar o rótulo no qual você está interessado, você pode exibi-lo, editá-lo ou removê-lo. Você também pode trabalhar com os arquivos aos quais o rótulo se aplica.

Localizar e trabalhar com rótulos usando a caixa de diálogo Localizar Rótulo

  1. No Gerenciador de Controle do Código-Fonte, na barra de menus, selecione Arquivo>Controle do Código-Fonte>Localizar>Localizar Rótulo. A caixa de diálogo Localizar Rótulo é exibida.

  2. (Opcional) Refinar sua pesquisa executando uma ou mais das seguintes etapas:

    • Na caixa de texto Nome, insira o nome do rótulo.

    • Na lista Project, selecione o projeto que contém o rótulo que você deseja localizar.

    • Na caixa de texto Proprietário, digite o nome ou alias do proprietário do rótulo.

  3. Selecione Localizar. A lista de resultados exibe rótulos que correspondem aos critérios de pesquisa que você inseriu.

  4. (Opcional) Siga uma das seguintes etapas:

    • Para exibir ou editar um rótulo, selecione-o e selecione Editar. A janela Rótulo aparece. Para obter mais informações, consulte Usar a janela Rótulo para trabalhar com rótulos.

    • Para excluir um rótulo, selecione-o e selecione Excluir.

    • Selecione Fechar.

Listar e trabalhar com rótulos que se aplicam a um item específico

Às vezes, talvez você não tenha certeza do nome de um rótulo, mas sabe que o rótulo foi aplicado a um item específico sob controle de versão. O procedimento a seguir explica como localizar e trabalhar com um rótulo nessa situação.

  1. No Gerenciador de Controle do Código-Fonte, clique com o botão direito do mouse em um item ao qual o rótulo foi aplicado e selecione Exibir Histórico. A janela Histórico aparece.

  2. Selecione a guia Rótulos para exibir a lista de rótulos que se aplicam a este item.

  3. (Opcional) Siga uma das seguintes etapas:

    • Para exibir ou editar um rótulo, clique com o botão direito do mouse no rótulo e selecione Editar Rótulo. A janela Rótulo aparece. Para obter informações sobre como usar essa janela, consulte Usar a janela Rótulo para trabalhar com rótulos.

    • Para excluir um rótulo, clique com o botão direito do mouse no rótulo e selecione Excluir Rótulo.

    • Clique com o botão direito do mouse no rótulo e selecione outra ação, como Obter esta Versão ou Comparar.

Para mais informações sobre como usar a guia de rótulos na janela Histórico, consulte Obter o histórico de um item.

Baixar versões rotuladas de arquivos para sua área de trabalho

Rotular um conjunto de arquivos é como tirar um instantâneo de como eles existiam em um determinado momento. Semanas ou meses depois de tirar esse instantâneo, talvez seja necessário exibir ou trabalhar com os arquivos como eles existiam nesse instantâneo. O procedimento a seguir explica como baixar as versões rotuladas de um conjunto de arquivos para seu workspace.

  1. No Source Control Explorer, clique com o botão direito do mouse na coleção de projetos, no projeto, no branch ou na pasta que contém os itens que você deseja baixar e selecione Advanced>Get Specific Version. A caixa de diálogo Obter é exibida.

  2. Na lista Tipo, selecione Rótuloe, em seguida, insira o nome do rótulo na caixa Rótulo ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações sobre como usar essa caixa de diálogo, consulte Localizar, editar e remover rótulos.

  3. Selecione outras opções apropriadas na caixa de diálogo Obter.

  4. Selecione Obter.

Use a janela Rótulo para trabalhar com os rótulos

Depois de abrir a janela Rótulo usando um dos procedimentos anteriores, você estará pronto para começar a trabalhar com o rótulo. Na parte superior da janela, uma caixa exibe o comentário, que você pode editar.

Você pode usar a janela de rótulo para executar as seguintes tarefas:

  • Adicionar um item ao rótulo
  • Remover um item do rótulo
  • Alterar a versão de um arquivo
  • Executar outras ações em um item

Adicionar um item ao rótulo

  1. Na janela Rótulo, selecione Adicionar Item. A caixa de diálogo Escolher Versão do Item é exibida.

  2. Na caixa de diálogo Escolher Versão do Item, navegue até o item que você deseja adicionar e selecione-o.

    Dica

    Você pode selecionar e segurar as teclas Ctrl ou Shift e selecionar vários itens.

  3. (Opcional) Se você precisar do rótulo para direcionar uma versão específica, na lista Versão, selecione uma versão:

    • Última Versão: aplicar o rótulo à versão mais recente que estiver no controle de versão.

    • Conjunto de Alterações: especificar o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, selecione as reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de Alterações. Para saber mais, consulte Localizar e exibir conjuntos de alterações.

    • Data: Especificar uma data na caixa Data ou selecionar uma data do calendário no menu suspenso.

    • Label: especifique um rótulo existente para basear o novo rótulo. Insira o nome do rótulo na caixa Rótulo ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.

    • Versão do Workspace: criar o rótulo para a versão em seu workspace.

  4. Selecione OK.

  5. Selecione Arquivo>Salvar.

Remover um item do rótulo

  1. Na janela Rótulo, localize a coleção, o projeto, o ramo, a pasta ou o arquivo que você deseja remover desse rótulo.

  2. Clique com o botão direito do mouse no item e selecione Remover do Rótulo. O rótulo é removido do item. Se o item for uma coleção de projetos, projeto, ramificação ou pasta, o rótulo também será removido de todos os itens que esta contém.

  3. Selecione Arquivo>Salvar.

Alterar a versão de um arquivo

  1. Na janela de Etiquetas, localize o arquivo que você deseja modificar.

  2. Clique com o botão direito do mouse no arquivo e selecione Alterar Versão Rotulada. A caixa de diálogo Alterar Versão Rotulada aparece.

  3. Selecione um dos seguintes valores:

    • Última Versão: aplicar o rótulo à versão mais recente que estiver no controle de versão.

    • Conjunto de Alterações: especificar o número de conjunto de alterações na caixa Conjunto de alterações. Como alternativa, selecione as reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de Alterações. Para saber mais, consulte Localizar e exibir conjuntos de alterações.

    • Data: Especificar uma data na caixa Data ou selecionar uma data do calendário no menu suspenso.

    • Label: especifique um rótulo existente para basear o novo rótulo. Selecione o nome do rótulo na caixa Rótulo ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.

    • Versão do Workspace: criar o rótulo para a versão em seu workspace.

  4. Selecione Arquivo>Salvar.

Executar outras ações em um item rotulado

Ao clicar com o botão direito do mouse em um item na janela Rótulo, você também pode selecionar um dos seguintes comandos:

Trabalhar no prompt de comando

  • Use o comando labels para listar rótulos. Para obter mais informações, consulte o comando Labels .

  • Use o comando label para aplicar ou remover um rótulo. Para obter mais informações, consulte o comando Rótulo (Controle de Versão do Team Foundation).

    Dica

    Ao usar o comando label para aplicar um rótulo, você pode especificar um escopo diferente do projeto.

Próximas etapas