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

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

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

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

• Организация в Azure DevOps с репозиторием Git. Если у вас нет организации, зарегистрируйтесь для отправки и совместного использования кода в бесплатных частных репозиториях Git.
• Служба, которая публикует состояние на PR. См. статью "Создание сервера состояния запроса на вытягивание".

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

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

   

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

   

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

   

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

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

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

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

   

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

   

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

   

Итоги

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