Partilhar via

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

  • Artigo

Serviços de DevOps do Azure | 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 tirar um instantâneo de seus arquivos. Mais tarde, você pode consultar esse instantâneo. Usando seu rótulo, você pode visualizar, criar ou até mesmo reverter um grande conjunto de arquivos para o estado em que estavam quando você aplicou o rótulo.

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 de Leitura definida como Permitir.
  • Para modificar ou excluir um rótulo, você deve ser o proprietário do rótulo ou ter a permissão Administrar Rótulos definida como Permitir.

Utilizar etiquetas

Em muitos projetos de software, quando o código atingiu 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 mudar, a equipe ainda pode obter e construir a nova versão de cada arquivo em seu projeto.

Teoricamente, você poderia registrar o ID de cada conjunto de alterações para cada arquivo manualmente. Mas esse tipo de processo não é prático. TFVC torna o trabalho fácil. Aplique um rótulo à pasta, ramificação ou 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ótulos incluem: "Sprint 5", "M1", "Beta2" e "Release Candidate 0".

Depois de aplicar o rótulo, você pode usá-lo para qualificar operações como criar, ramificar, mesclar, comparar e obter versões específicas de arquivos e pastas.

Por vezes, depois de aplicar um rótulo, decide que precisa de o alterar. 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.

Gorjeta

A aplicação de um rótulo oferece muitos dos mesmos benefícios que a criação de uma filial, mas normalmente com menor custo e complexidade. A contrapartida é que, para grandes bancos de dados, operações como a mesclagem podem levar muito mais tempo do que o normal quando executadas contra 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, em seguida, aplica o rótulo. No entanto, no prompt de comando, a operação de rótulo é aditiva. Consulte Comando Label (Controle de versão do Team Foundation).

  1. No Visual Studio, no menu Exibir, selecione Outro Gerenciador de Controle do Código-Fonte do Windows>.

  2. No Gerenciador de Controle do Código-Fonte, 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 selecione Rótulo Avançado>de Aplicação. A caixa de diálogo Novo rótulo é exibida.

  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, a opção Versão mais recente é selecionada por padrão. Esta opção é a mais utilizada. Se você precisar do rótulo para direcionar uma versão específica, selecione uma das seguintes opções:

    • Conjunto de alterações: especifique 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 obter mais informações, consulte Localizar e exibir conjuntos de alterações.

    • Data: especifique uma data na caixa Data ou selecione uma data no calendário no menu suspenso.

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

    • Versão do espaço de trabalho: crie o rótulo para a versão em seu espaço de trabalho.

  6. Quando estiver satisfeito com as 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. Esta ação aplica o rótulo e, em seguida, 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 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

Não é possível modificar o nome de um rótulo existente. Mas você pode facilmente aplicar um novo rótulo exatamente aos mesmos arquivos e às mesmas versões aos 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 de projetos (o nó raiz) e selecione Rótulo de Aplicação Avançada>. A caixa de diálogo Novo rótulo é exibida.

  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 é exibida.

  5. Siga um dos seguintes passos:

    • 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 a nova etiqueta, pode removê-la. Para obter mais informações, consulte Localizar, editar e remover rótulos.

Listar, localizar, visualizar, editar e remover etiquetas

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 a etiqueta em que está interessado, pode visualizá-la, editá-la ou removê-la. Você também pode trabalhar com os arquivos aos quais o rótulo se aplica.

Localizar e trabalhar com etiquetas utilizando a caixa de diálogo Localizar Etiqueta

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

  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 que contém o rótulo que você deseja localizar.

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

  3. Selecione Localizar. A lista Resultados exibe rótulos que correspondem aos critérios de pesquisa inseridos.

  4. (Opcional) Siga um dos seguintes passos:

    • Para ver ou editar uma etiqueta, selecione-a e selecione Editar. A janela Rótulo é exibida. 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ê pode não ter 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 é exibida.

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

  3. (Opcional) Siga um dos seguintes passos:

    • Para ver ou editar uma etiqueta, clique com o botão direito do rato na etiqueta e, em seguida, selecione Editar Etiqueta. A janela Rótulo é exibida. Para obter informações sobre como usar essa janela, consulte Usar a janela Rótulo para trabalhar com rótulos.

    • Para eliminar uma etiqueta, clique com o botão direito do rato na etiqueta e, em seguida, selecione Eliminar Etiqueta.

    • 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.

Transferir versões rotuladas de ficheiros para a 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 ter tirado esse instantâneo, talvez seja necessário visualizar ou trabalhar com os arquivos tal como eles existiam nesse instantâneo. O procedimento a seguir explica como baixar as versões rotuladas de um conjunto de arquivos para seu espaço de trabalho.

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

  2. Na lista Tipo, selecione Rótulo e digite 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 quaisquer outras opções apropriadas na caixa de diálogo Obter .

  4. Selecione Obter.

Utilizar a janela Etiqueta para trabalhar com etiquetas

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 à etiqueta
  • Remover um item da etiqueta
  • Alterar a versão de um ficheiro
  • Executar outras ações em um item

Adicionar um item à etiqueta

  1. Na janela Rótulo, selecione Adicionar Item. A caixa de diálogo Choose Item Version (Escolher versão do item) é exibida.

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

    Gorjeta

    Você pode selecionar e segurar as teclas Ctrl ou Shift e, em seguida, 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:

    • Versão mais recente: aplique o rótulo à versão mais recente que está no controle de versão.

    • Conjunto de alterações: especifique o número de um 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 obter mais informações, consulte Localizar e exibir conjuntos de alterações.

    • Data: especifique uma data na caixa Data ou selecione uma data no calendário no menu suspenso.

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

    • Versão do espaço de trabalho: crie o rótulo para a versão em seu espaço de trabalho.

  4. Selecione OK.

  5. Selecione Ficheiro>Guardar.

Remover um item da etiqueta

  1. Na janela Rótulo, localize a coleção, projeto, ramificação, pasta ou 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 projeto, projeto, ramificação ou pasta, o rótulo também será removido de todos os itens que ele contém.

  3. Selecione Ficheiro>Guardar.

Alterar a versão de um ficheiro

  1. Na janela Label, localize o ficheiro que pretende 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 é exibida.

  3. Selecione um dos seguintes valores:

    • Versão mais recente: aplique o rótulo à versão mais recente que está no controle de versão.

    • Conjunto de alterações: especifique 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 obter mais informações, consulte Localizar e exibir conjuntos de alterações.

    • Data: especifique uma data na caixa Data ou selecione uma data no calendário no menu suspenso.

    • Rótulo: especifique um rótulo existente no qual 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 espaço de trabalho: crie o rótulo para a versão em seu espaço de trabalho.

  4. Selecione Ficheiro>Guardar.

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 a partir da linha de comandos

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

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

    Gorjeta

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

Próximos passos