Usar rótulos para tirar uma foto 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 de Controle de Versão do Team Foundation (TFVC) fornecem uma maneira de usar uma foto de seus arquivos. Posteriormente, você pode fazer referência a essa foto. Usando seu rótulo, você pode exibir, compilar ou até mesmo reverter um conjunto grande de arquivos para o estado em que estavam quando o rótulo foi aplicado.

Pré-requisitos

  • Para aplicar um rótulo, você deve ter a permissão Rótulo definida como Permitir.
  • Para localizar, listar ou exibir rótulos, você deve ter a permissão Ler definida 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 compilará e liberará 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, à ramificação ou ao projeto que contém os arquivos. Você pode nomear um rótulo seguindo 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 a aquisição de versões específicas de arquivos e pastas.

Às vezes, depois que você aplica um rótulo, você decide 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

Aplicar um rótulo oferece muitos dos mesmos benefícios da criação de uma ramificação, porém com custos e complexidade mais baixos. 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

Observação

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 então o aplica. 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. Em Controle do Código-Fonte Explorer, clique com o botão direito do mouse na coleção, projeto, ramificação, pasta ou arquivo ao qual você deseja aplicar um rótulo e selecioneAvançado>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 normalmente. Se você precisar do rótulo para direcionar uma versão específica, selecione uma das seguintes opções:

    • Conjunto de Alterações: especifica o número do conjunto de alterações na caixa. 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: especifique uma data na caixa Data ou selecione uma data do calendário no menu suspenso.

    • Rótulo: 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: crie 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 então modificá-lo depois de ser 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.

Observação

Quando você aplicar um rótulo que usa um nome que já existe, o sistema avisará e perguntará se deseja continuar. Se você selecionar OK para 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 destas etapas:

    • Digite 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 aparece. 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 que 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 aparece.

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

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

    • Na lista Projeto, selecione o projeto de equipe que contém o nome que você deseja localizar.

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

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

  4. (Opcional) Realize 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 você não tem certeza do nome de um rótulo, mas você 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, em seguida, trabalhar com um rótulo nesta situação.

  1. Em 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. Escolha a guia Rótulos para exibir a lista de rótulos que se aplicam a este item.

  3. (Opcional) Realize 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 obter mais informações sobre como usar a guia rótulo na janela Histórico, consulte Obter o histórico de um item.

Baixar versões rotuladas de arquivos para seu workspace

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 nessa foto. O seguinte procedimento explica como baixar as versões rotuladas de um conjunto de arquivos para seu workspace.

  1. No Gerenciador de Controle de Origem, clique com o botão direito do mouse na coleção de projetos, no projeto, na ramificação ou na pasta que contém os itens que você deseja baixar e selecione Avançado>Obter Versão Específica. A caixa de diálogo Obter aparece.

  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.

Usar a janela Rótulo para trabalhar com 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 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 aparece.

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

    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 especifica, na lista Versão, selecione uma versão:

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

    • Conjunto de Alterações: especifica 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: especifique uma data na caixa Data ou selecione uma data do calendário no menu suspenso.

    • Rótulo: 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: crie 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, projeto de equipe, ramificação, pasta ou arquivo que você deseja remover deste 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 projeto, um projeto de equipe, uma ramificação ou uma pasta, então o rótulo também será removido de todos os itens que o item contém.

  3. Selecione Arquivo>Salvar.

Alterar a versão de um arquivo

  1. Na janela Rótulo, 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 destes valores:

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

    • Conjunto de Alterações: especifica o número do conjunto de alterações na caixa. 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: especifique uma data na caixa Data ou selecione uma data do calendário no menu suspenso.

    • Rótulo: 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: crie 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 Comando Rótulos.

  • 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