Настройка политики ветвей для внешней службы

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Политики ветвей — это мощная функция, обеспечивающая высокое качество кода в репозитории, устанавливая требования ко всем запросам на вытягивание. Внешние службы могут использовать API состояния pr для публикации подробных сведений о состоянии на PRs. Политика ветвления для внешних служб позволяет сторонним службам участвовать в рабочем процессе pr и устанавливать требования политики. В этой статье описывается процесс настройки политики ветвей для службы, которая публикует состояние запроса на вытягивание. Дополнительные сведения о состоянии запроса на вытягивание см. в разделе "Настройка и расширение рабочих процессов запроса на вытягивание" с состоянием запроса на вытягивание.

Примечание

Для функции, описанной в этой статье, требуется TFS 2018 с обновлением 2 или более поздней версии.

Предварительные условия

Настройка политики ветви

  1. Перейдите к CodeBranches> и найдите ветвь, в которой требуется настроить политику (обычно main илиdevelop). В контекстном меню выберите параметр "Политики ветвей ".

    Select Branch policies from the context menu

  2. Прокрутите вниз, чтобы найти проверки состояния. Нажмите кнопку +.

    Select the Add policy button

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

    Select the policy from the list

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

Создание нового запроса на вытягивание

  1. Создайте новый запрос на вытягивание в ветвь, в которой определена политика. Дополнительные сведения см. в разделе "Создание запроса на вытягивание".

  2. После создания запроса на вытягивание новая политика появится в разделе "Политики" представления сведений о запросе. Изначально политика будет отображаться как не заданная, пока внешняя служба не опубликовала состояние.

    Policy status is visible in the Policies section

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

    Policy status updates

    Когда выполняются критерии политики и служба публикует succeeded состояние, запрос на вытягивание будет утвержден, а завершение будет разблокировано.

    Policy status approved and completion unblocked

Сводка

Из этой статьи вы узнали, как настроить политику ветвей для внешней службы.