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

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

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

Предпосылки

Категория	Требования
доступ к проекту	Член проекта .
Разрешения	— Просмотр кода в частных проектах: по крайней мере базовый доступ. — Клонирование или внесение вклада в код в частных проектах: Участник группы безопасности для участников или наличие соответствующих разрешений в проекте. — Задайте разрешения ветви или репозитория: управление разрешениями для ветви или репозитория. — Измените ветвь по умолчанию: . Измените политики и разрешения для репозитория. — Импорт репозитория: член группы безопасности администраторов проекта или разрешение уровня проекта Git на создание репозитория установлено в «Разрешить» . Дополнительные сведения см. в разделе "Настройка разрешений репозитория Git".
услуги	Repos включено.
Инструменты	Необязательно. Используйте команды az repos: Azure DevOps CLI.

Примечание.

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

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

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

   

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

   

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

   

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

Создать новый пул-реквест

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

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

   Состояние политики

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

   

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

   

Сводка

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