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

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

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

Необходимые компоненты

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

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

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

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

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

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

Совет

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

  6. Нажмите кнопку создания.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вывод списка и работы с метками, применяемыми к конкретному элементу

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

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

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

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

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

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

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

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

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

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

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

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

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

  4. Щелкните Получить.

Использование окна метки для работы с метками

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

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

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

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

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

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

    Совет

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

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

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

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

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

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

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

  4. Нажмите ОК.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Совет

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

Следующие шаги