Поделиться через

Использование меток для создания моментального снимка файлов в Azure Repos

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Метки управления версиями Team Foundation (TFVC) предоставляют способ создания моментального снимка файлов. Позже вы можете вернуться к тому снимку. Используя метку, можно просматривать, создавать или даже откатывать большой набор файлов в состояние, в которое они находились при применении метки.

Необходимые условия

  • Чтобы применить метку, установите разрешение Label на Allow.
  • Чтобы найти, перечислить или просмотреть метки, укажите разрешение "Чтение" на "Разрешить".
  • Чтобы изменить или удалить метку, необходимо владеть меткой или иметь разрешение администрирования меток значение Allow.

Использование меток

Во многих проектах программного обеспечения, когда код достиг разумного уровня качества и стабильности, команда создает и выпускает новую версию продукта. Команда должна пометить текущую версию каждого файла. Несмотря на то, что файлы продолжают изменяться, команда по-прежнему может получить и создать новую версию каждого файла в своем проекте.

Теоретически можно записать идентификатор каждого набора изменений для каждого файла вручную. Но такой процесс не является практическим. TFVC упрощает задание. Примените метку к папке, ветви или проекту, содержащей файлы. Вы можете присвоить метку имени, которая соответствует выбранному соглашению об именовании. Ниже приведены некоторые примеры имен меток: "Sprint 5", "M1", "Beta2" и "Release Candidate 0".

После применения метки его можно использовать для квалификации таких операций, как сборка, ветвление, слияние, сравнение и получение определенных версий файлов и папок.

Иногда после применения метки необходимо изменить ее. TFVC позволяет применять метку к дополнительным файлам, удалять метку из определенных файлов и изменять версию определенного файла, к которой применяется метка.

Совет

Применение метки обеспечивает множество одинаковых преимуществ, что и создание ветви, но обычно с более низкой стоимостью и сложностью. Компромисс заключается в том, что для больших баз данных такие операции, как слияние, могут занять значительно больше времени, чем обычно при выполнении с учетом метки.

Применение метки

Заметка

При использовании Visual Studio для применения метки, уже существующей, операция удаляет метку из всех версий файлов, а затем применяет метку. Однако из командной строки операция метки является аддитивной. См. команду Label (Team Foundation Version Control) .

  1. В Visual Studio в меню представления выберите Другиеобозревателя системы управления версиями Windows.

  2. В обозревателе управления версиями щелкните правой кнопкой мыши коллекцию, проект, ветвь, папку или файл, к которому нужно применить метку, а затем выберите пункт Advanced>Apply Label. Появится диалоговое окно "Новая метка".

  3. В поле Название введите имя для метки.

  4. (Необязательно) В поле "Комментарий" введите комментарий.

  5. В списке версия по умолчанию выбрана последняя версия . Этот параметр является наиболее часто используемым. Если для конкретной версии требуется метка, выберите один из следующих вариантов:

    • набор изменений: укажите номер набора изменений в поле Changeset. Кроме того, выберите многоточие (...), чтобы открыть диалоговое окно "Найти наборы изменений". Дополнительные сведения см. в разделе Поиск и просмотр наборов изменений.

    • дата: укажите дату в поле даты или выберите дату в календаре в выпадающем меню.

    • Метка: укажите существующую метку, чтобы создать новую метку. Введите имя метки в поле Метка или выберите многоточие (...), чтобы открыть диалоговое окно Поиска меток. Дополнительные сведения см. в разделе Поиск, изменение и удаление меток.

    • версия рабочей области: создайте метку для версии в вашей рабочей области.

  6. Если вы удовлетворены параметрами, выполните одно из следующих действий:

    • Чтобы применить метку, выберите Создать.

    • Чтобы применить метку, а затем изменить ее после применения, выберите Создать и изменить. Это действие применяет метку, а затем отображает окно Метка. Дополнительные сведения о том, как использовать окно метки для редактирования метки, см. в разделе Использование окна метки для работы с метками.

Заметка

При применении метки с именем, которое уже существует, система предупреждает вас и спрашивает, хотите ли вы продолжить. Если выбрать ОК, чтобы продолжить, TFVC удаляет метку из любых элементов, которые не находятся в пути, к которому вы применяете метку.

Переименование метки

Невозможно изменить имя существующей метки. Но вы можете легко применить новую метку к точно тем же файлам и тем же версиям, к которым применяется другая метка.

  1. В обозревателе управления версиями щелкните правой кнопкой мыши на узле коллекции проектов (корневой узел), а затем выберите Дополнительно>Применить метку. Появится диалоговое окно "Новая метка".

  2. В поле "Имя" введите имя метки.

  3. (Необязательно) В поле для комментариев введите комментарий.

  4. В версии списке выберите Метка. Появится поле для метки .

  5. Выполните одно из следующих действий.

    • Введите имя существующей метки.

    • Если вы не уверены в имени существующей метки, нажмите кнопку 'Обзор' с многоточием (...) рядом с полем Метка. Откроется диалоговое окно Найти метку. Используйте параметры в диалоговом окне Поиск меток, чтобы отфильтровать список меток и найти существующую метку, к которой нужно применить новую метку. Дополнительные сведения см. в разделе Поиск, изменение и удаление меток.

  6. Выберите Создать.

  7. (Необязательно) После создания новой метки можно удалить старую метку. Дополнительные сведения см. в разделе Поиск, изменение и удаление меток.

Список, поиск, просмотр, изменение и удаление меток

Существует два способа найти и перечислить метки: диалоговое окно Поиск меток и вкладка Метка в окне История. После того как вы найдете интересующую вас метку, вы можете просмотреть, изменить или удалить ее. Вы также можете работать с файлами, к которым применяется метка.

Поиск и работа с метками с помощью диалогового окна "Поиск меток"

  1. В обозревателе управления исходным кодом в строке меню выберите "Файл>Управление исходным кодом">"Найти>Найти метку". Откроется диалоговое окно Найти метку.

  2. (Необязательно) Уточните поиск, выполнив одно или несколько следующих шагов:

    • В текстовом поле Имя введите имя метки.

    • В списке Project выберите проект, содержащий метку, которую нужно найти.

    • В текстовом поле владелец введите имя или псевдоним владельца метки.

  3. Выберите Найти. В списке результатов отображаются метки, соответствующие введенным условиям поиска.

  4. (Необязательно) Выполните одно из следующих действий.

    • Чтобы просмотреть или изменить метку, выберите ее и выберите Изменить. Откроется окно метки. Дополнительные сведения см. в разделе Использование окна меток для работы с метками.

    • Чтобы удалить метку, выберите ее и выберите Удалить.

    • Выберите Закрыть.

Перечисление и работа с метками, применяемыми к конкретному элементу

Иногда вы не уверены в имени метки, но знаете, что метка была применена к конкретному элементу управления версиями. В следующей процедуре объясняется, как найти и работать с меткой в этой ситуации.

  1. В Проводнике управления исходным кодом щелкните правой кнопкой мыши элемент, к которому была применена метка, а затем выберите Просмотр истории. Окно истории появится.

  2. Выберите вкладку метки, чтобы отобразить список меток, применяемых к этому элементу.

  3. (Необязательно) Выполните одно из следующих действий.

    • Чтобы просмотреть или изменить метку, щелкните ее правой кнопкой мыши и выберите Изменить Метку. Появится окно метки. Сведения об использовании этого окна см. в разделе Использование окна меток для работы с метками.

    • Чтобы удалить метку, щелкните метку правой кнопкой мыши и выберите Удалить метку.

    • Щелкните метку правой кнопкой мыши и выберите одно из следующих действий, например Получить эту версию или Сравнить.

Дополнительные сведения об использовании вкладки 'История' в окне История см. в разделе Получение истории элемента.

Скачайте помеченные версии файлов в рабочую область

Метка набора файлов похожа на моментальный снимок того, как они существовали в определенный момент времени. Спустя недели или месяцы после создания этого моментального снимка, возможно, вам потребуется просмотреть или работать с файлами в том виде, в котором они находились в этом моментальном снимке. В следующей процедуре объясняется, как скачать помеченные версии набора файлов в вашу рабочую область.

  1. В Проводнике управления версиями щелкните правой кнопкой мыши на коллекции проектов, проекте, ветке или папке, содержащих элементы, которые вы хотите скачать, затем выберите Advanced>Get Specific Version. Диалоговое окно "Получить" появляется.

  2. В списке типа выберите Метка, а затем введите имя метки в поле Метка или выберите многоточие (...), чтобы открыть диалоговое окно Найти метку. Дополнительные сведения об использовании этого диалогового окна см. в разделе Поиск, изменение и удаление меток.

  3. Выберите любые другие подходящие параметры в диалоговом окне Получение данных.

  4. Выберите Получить.

Используйте окно «Метка» для работы с метками

После открытия окна метки с помощью одной из предыдущих процедур можно начать работу с меткой. В верхней части окна отображается комментарий, который можно изменить.

Для выполнения следующих задач можно использовать окно метки .

  • Добавление элемента в метку
  • Удаление элемента из метки
  • Изменение версии файла
  • Выполнение других действий в элементе

Добавление элемента в метку

  1. В окне Метка выберите Добавить элемент. Откроется диалоговое окно Выбор варианта элемента.

  2. В диалоговом окне Выбор версии элемента перейдите к элементу, который нужно добавить, а затем выберите его.

    Подсказка

    Вы можете выбрать и удерживать клавиш и CTRL или SHIFT, а затем выбрать несколько элементов.

  3. (Необязательно) Если для конкретной версии требуется метка, в списке версии выберите версию:

    • последней версии: примените метку к последней версии, которая находится в системе управления версиями.

    • Changeset: укажите номер Changeset в поле Changeset. Кроме того, выберите многоточие (...), чтобы открыть диалоговое окно "Найти наборы изменений". Дополнительные сведения см. в разделе Поиск и просмотр наборов изменений.

    • дата: укажите дату в поле даты или выберите дату в выпадающем меню.

    • Метка: укажите существующую метку, чтобы создать новую метку. Введите имя метки в поле Метка или выберите многоточие (...), чтобы открыть диалоговое окно Поиска меток. Дополнительные сведения см. в разделе Поиск, изменение и удаление меток.

    • Рабочая область Версия: создайте ярлык для версии в вашей рабочей области.

  4. Выберите ОК.

  5. Выберите файл>Сохранить.

Удаление элемента из метки

  1. В окне метки найдите коллекцию, проект, ветвь, папку или файл, который нужно удалить из этой метки.

  2. Щелкните элемент правой кнопкой мыши и выберите Удалить из метки. Метка удаляется из элемента. Если элемент является коллекцией проектов, проектом, ветвью или папкой, метка также удаляется из всех элементов, содержащихся в ней.

  3. Выберите файл>сохранить.

Изменение версии файла

  1. В окне метки найдите файл, который требуется изменить.

  2. Щелкните файл правой кнопкой мыши и выберите Изменить версию. Появится диалоговое окно измененной версии, обозначенной как.

  3. Выберите одно из следующих значений:

    • последняя версия: примените метку к последней версии, которая находится в системе контроля версий.

    • Набор изменений: укажите номер набора изменений в поле Набор изменений. Кроме того, выберите многоточие (...), чтобы открыть диалоговое окно "Найти наборы изменений". Дополнительные сведения см. в разделе Поиск и просмотр наборов изменений.

    • дата: укажите дату в поле даты или выберите дату в раскрывающемся меню.

    • Метка: укажите существующую метку, чтобы создать новую метку. Выберите имя метки в поле метки или выберите многоточие (...) для открытия диалогового окна Поиска меток. Дополнительные сведения см. в разделе Поиск, изменение и удаление меток.

    • версия рабочей области: создайте ярлык для версии в вашей рабочей области.

  4. Выберите файл>Сохранить.

Выполните другие действия с помеченным элементом

Щелкнув элемент правой кнопкой мыши в окне метки, можно также выбрать одну из следующих команд:

Работа из командной строки

  • Используйте команду labels для перечисления меток. Дополнительные сведения см. в команде меток .

  • Используйте команду label для применения или удаления метки. Дополнительные сведения см. в команде Label (Team Foundation Version Control).

    Совет

    При использовании команды label для применения метки можно указать область, отличной от проекта.

Дальнейшие действия