Настройка политики ветвей для внешней службы
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Политики ветвей — это мощная функция, обеспечивающая высокое качество кода в репозитории, устанавливая требования ко всем запросам на вытягивание. Внешние службы могут использовать API состояния pr для публикации подробных сведений о состоянии на PRs. Политика ветвления для внешних служб позволяет сторонним службам участвовать в рабочем процессе pr и устанавливать требования политики. В этой статье описывается процесс настройки политики ветвей для службы, которая публикует состояние запроса на вытягивание. Дополнительные сведения о состоянии запроса на вытягивание см. в разделе "Настройка и расширение рабочих процессов запроса на вытягивание" с состоянием запроса на вытягивание.
Примечание
Для функции, описанной в этой статье, требуется TFS 2018 с обновлением 2 или более поздней версии.
Предварительные условия
- Организация в Azure DevOps с репозиторием Git. Если у вас нет организации, зарегистрируйтесь , чтобы отправить и поделиться кодом в бесплатных частных репозиториях Git.
- Служба, которая публикует состояние на PR. См . статью "Создание сервера состояния запроса на вытягивание".
Настройка политики ветви
Перейдите к CodeBranches> и найдите ветвь, в которой требуется настроить политику (обычно
main
илиdevelop
). В контекстном меню выберите параметр "Политики ветвей ".Прокрутите вниз, чтобы найти проверки состояния. Нажмите кнопку +.
Выберите службу, для которой вы хотите создать политику из списка. Если состояние было опубликовано ранее, его можно выбрать из списка; Если это новая политика, можно ввести имя политики.
- Требование политики определяет, является ли эта политика необязательной или требуется для выполнения запросов на вытягивание в ветвь.
- Авторизованное удостоверение используется для принудительного применения этого состояния только от указанного удостоверения будет учитываться в отношении выполнения политики.
- Условия сброса используются для определения того, когда состояние публикации больше не является допустимым. Если состояние, размещенное в последней версии кода (т. е. сборка), проверьте состояние сброса при каждом изменении состояния при изменении исходной ветви.
- При необходимости задайте фильтр пути. Дополнительные сведения о фильтрах путей в политиках ветви.
- Применимость политики определяет, применяется ли эта политика сразу после создания запроса на вытягивание или применяется ли политика только после публикации первого состояния в запрос на вытягивание.
- Отображаемое имя по умолчанию позволяет указать необязательное отображаемое имя политики.
Создание нового запроса на вытягивание
Создайте новый запрос на вытягивание в ветвь, в которой определена политика. Дополнительные сведения см. в разделе "Создание запроса на вытягивание".
После создания запроса на вытягивание новая политика появится в разделе "Политики" представления сведений о запросе. Изначально политика будет отображаться как не заданная, пока внешняя служба не опубликовала состояние.
Когда служба опубликовала состояние, политика будет соответствующим образом обновляться. Завершение будет заблокировано до тех пор, пока политика не утвердит запрос на вытягивание.
Когда выполняются критерии политики и служба публикует
succeeded
состояние, запрос на вытягивание будет утвержден, а завершение будет разблокировано.
Сводка
Из этой статьи вы узнали, как настроить политику ветвей для внешней службы.