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

Отделения с политиками отображают значок политики. Выберите значок, чтобы перейти непосредственно к параметрам политики ветви.

Вы можете просмотреть список или найти ветвь в поле "Имя ветви поиска ".

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

Используйте интерфейс командной строки Azure DevOps для перечисления существующих политик для ветви или репозитория перед созданием или обновлением политики.

Если часто используется Azure DevOps CLI, задайте значения по умолчанию для организации и проектаaz devops configure --defaults. Если вы хотите применить политику только к одной ветви, используйте --branch-match-type exact. Используйте prefix только в том случае, если политика будет применяться в папке ветви, например release/.

Список политик

Чтобы вывести список всех политик в проекте, используйте список политик az repos.

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--repository-id]
                     [--subscription]

Параметры

Пример

Следующая команда возвращает все правила для ветви, действующие в ветви main репозитория Fabrikam, ID d28cd374-e7f0-4b1f-ad60-f349f155d47c. Получите идентификатор репозитория, выполнив команду az repos list.

В этом примере используется следующая конфигурация по умолчанию: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"

az repos policy list --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --branch main --output table

ID    Name                         Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------------  -------------  ------------  ------------------------------------  ---------------
3     Work item linking            False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
5     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
6     Comment requirements         False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
12    Required reviewers           True           False         d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
13    Required reviewers           False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Отображение сведений о политике

Чтобы отобразить сведения о любой политике, используйте az repos policy show.

az repos policy show --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--subscription]

Параметры

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.

• Выберите "Разрешить инициаторам запросов утверждать свои собственные изменения, чтобы создатель PR мог проголосовать за его утверждение. В противном случае автор по-прежнему может выбрать Одобрить в PR, но его голос не засчитывается в минимально необходимое число проверяющих.

• Выберите Запретить автору последнего push-запроса утверждать собственные изменения, чтобы обеспечить разделение обязанностей. По умолчанию любой пользователь с правом на push в исходной ветви может как добавлять коммиты, так и голосовать за утверждение PR. Выбор этого параметра означает, что последнее голосование вносящего изменения не учитывается, даже если данный пользователь обычно может утверждать свои собственные изменения.

• Выберите «Разрешить завершение, даже если некоторые рецензенты голосуют за ожидание или отклонение», чтобы разрешить завершение PR, даже если некоторые рецензенты голосуют против утверждения. Минимальное число рецензентов все еще должно дать одобрение.

• В разделе " При отправке новых изменений":
  • Выберите Требовать по крайней мере одно утверждение на каждой итерации, чтобы было необходимо как минимум одно одобрение для последнего изменения исходной ветви. Утверждение пользователя не учитывается в отношении предыдущей неутвержденной итерации, отправленной этим пользователем. В результате требуется еще одно утверждение последней итерации другим пользователем. Функция "Требовать минимум одно утверждение для каждой итерации" доступна в Azure DevOps Server 2022.1 и выше.
  • Выберите "Требовать по крайней мере одно одобрение в последней итерации", чтобы потребовать хотя бы одного одобрения за последнее изменение исходной ветви.
  • Выберите "Сброс всех голосов утверждения" (не сбрасывает голоса за отклонение или ожидание), чтобы удалить все голоса утверждения, но сохранить голоса за отклонение или ожидание, как только изменяется исходная ветвь.
  • Выберите «Сброс всех голосов рецензентов кода», чтобы удалить все голоса рецензентов при каждом изменении исходной ветви, включая голоса за утверждение, отклонение или ожидание.

Вы можете управлять количеством необходимых утверждающих для pull-запросов с помощью az repos policy approver-count.

Создать политику подсчета утверждающих.

Чтобы создать политику количества утверждающих, используйте az repos policy approver-count create.

az repos policy approver-count create --allow-downvotes {false, true}
                                      --blocking {false, true}
                                      --branch
                                      --creator-vote-counts {false, true}
                                      --enabled {false, true}
                                      --minimum-approver-count
                                      --repository-id
                                      --reset-on-source-push {false, true}
                                      [--branch-match-type {exact, prefix}]
                                      [--detect {false, true}]
                                      [--org]
                                      [--project]
                                      [--subscription]

Параметры

Пример

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

В этом примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

az repos policy approver-count create --allow-downvotes true --blocking true --branch main --creator-vote-counts true --enabled true --minimum-approver-count 2 --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --reset-on-source-push false --output table

ID    Name                         Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------------  -------------  ------------  ------------------------------------  ---------------
27    Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Обновление политики количества утверждающих

Чтобы обновить политику на количество утверждающих, используйте az repos policy approver-count update.

az repos policy approver-count update --id
                                      [--allow-downvotes {false, true}]
                                      [--blocking {false, true}]
                                      [--branch]
                                      [--branch-match-type {exact, prefix}]
                                      [--creator-vote-counts {false, true}]
                                      [--detect {false, true}]
                                      [--enabled {false, true}]
                                      [--minimum-approver-count]
                                      [--org]
                                      [--project]
                                      [--repository-id]
                                      [--reset-on-source-push {false, true}]
                                      [--subscription]

Параметры

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.

Вы можете использовать Azure CLI az repos policy work-item-connect для создания и обновления политик связывания рабочих элементов для ветви или репозитория.

Создание политики связывания рабочих элементов

Используйте az repos policy work-item-linking create, чтобы создать политику связывания рабочих элементов для репозитория или ветвей.

az repos policy work-item-linking create --blocking {false, true}
                                         --branch
                                         --enabled {false, true}
                                         --repository-id
                                         [--branch-match-type {exact, prefix}]
                                         [--detect {false, true}]
                                         [--org]
                                         [--project]
                                         [--subscription]

Параметры

Обновление политики связывания рабочих элементов

Используйте az repos policy work-item-linking update , чтобы обновить политику связывания рабочих элементов для репозитория или одной или нескольких ветвей.

az repos policy work-item-linking update --id
                                         [--blocking {false, true}]
                                         [--branch]
                                         [--branch-match-type {exact, prefix}]
                                         [--detect {false, true}]
                                         [--enabled {false, true}]
                                         [--org]
                                         [--project]
                                         [--repository-id]
                                         [--subscription]

Параметры

Пример

В следующем примере идентификатор политики 3 для main ветви репозитория Fabrikam обновляется так, чтобы быть включенным, но необязательным. В примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

az repos policy work-item-linking update --id 3 --blocking false --branch main --enabled true --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --output table

ID    Name               Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------  -------------  ------------  ------------------------------------  ---------------
3     Work item linking  False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.

Установите для параметра Проверять разрешение комментариев значение On (Вкл.), чтобы настроить политику разрешения комментариев для вашей ветки. Затем выберите, нужно ли сделать политику обязательной или необязательной.

Дополнительные сведения о работе с комментариями к запросам на включение изменений см. в разделе «Проверка запросов на включение изменений».

Используйте Azure DevOps CLI az repos policy comment-required, чтобы задать и обновить политику разрешения комментариев.

Создание политики разрешения комментариев

Чтобы создать политику разрешения комментариев, используйте команду az repos policy comment-required create.

az repos policy comment-required create --blocking {false, true}
                                        --branch
                                        --enabled {false, true}
                                        --repository-id
                                        [--branch-match-type {exact, prefix}]
                                        [--detect {false, true}]
                                        [--org]
                                        [--project]
                                        [--subscription]

Параметры

Обновление политики разрешения комментариев

Чтобы обновить политику обязательных комментариев, используйте az repos policy comment-required update.

az repos policy comment-required update --id
                                        [--blocking {false, true}]
                                        [--branch]
                                        [--branch-match-type {exact, prefix}]
                                        [--detect {false, true}]
                                        [--enabled {false, true}]
                                        [--org]
                                        [--project]
                                        [--repository-id]
                                        [--subscription]

Параметры

Пример

В следующем примере идентификатор 6 политики разрешения комментариев в ветви main репозитория Fabrikam обновляется, чтобы она была блокирующей. Комментарии необходимо разрешить, прежде чем pull-запросы могут быть объединены. В этом примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

az repos policy comment-required update --id 6 --blocking true --output table

ID    Name                  Is Blocking    Is Enabled    Repository Id                         Branch
----  --------------------  -------------  ------------  ------------------------------------  ---------------
6     Comment requirements  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.

Задайте для параметра Ограничить типы слияния значение Вкл., чтобы ограничить набор типов слияния, разрешённых в репозитории.

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

Используйте Azure DevOps CLI az repos policy merge-strategy, чтобы задать и обновить политику стратегии слияния.

Создание политики стратегии слияния

Используйте az repos policy merge-strategy create для создания политики стратегии слияния.

az repos policy merge-strategy create --blocking {false, true}
                                      --branch
                                      --enabled {false, true}
                                      --repository-id
                                      [--allow-no-fast-forward {false, true}]
                                      [--allow-rebase {false, true}]
                                      [--allow-rebase-merge {false, true}]
                                      [--allow-squash {false, true}]
                                      [--branch-match-type {exact, prefix}]
                                      [--detect {false, true}]
                                      [--org]
                                      [--project]
                                      [--subscription]
                                      [--use-squash-merge {false, true}]

Параметры

Пример

Следующий пример устанавливает требуемую стратегию слияния для запросов на вытягивание в main ветви репозитория Fabrikam для включения сквош-слияния. В этом примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

az repos policy merge-strategy create --allow-squash true --blocking true --branch main --enabled true --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --output table

ID    Name                      Is Blocking    Is Enabled    Repository Id                         Branch
----  ------------------------  -------------  ------------  ------------------------------------  ---------------
29    Require a merge strategy  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Обновление политики стратегии слияния

Используйте az repos policy merge-strategy update для обновления политики стратегии слияния.

az repos policy merge-strategy update --id
                                      [--allow-no-fast-forward {false, true}]
                                      [--allow-rebase {false, true}]
                                      [--allow-rebase-merge {false, true}]
                                      [--allow-squash {false, true}]
                                      [--blocking {false, true}]
                                      [--branch]
                                      [--branch-match-type {exact, prefix}]
                                      [--detect {false, true}]
                                      [--enabled {false, true}]
                                      [--org]
                                      [--project]
                                      [--repository-id]
                                      [--subscription]
                                      [--use-squash-merge {false, true}]

Параметры

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.

Добавить политику проверки сборки

1. Нажмите кнопку + рядом с проверкой сборки.

   

2. Заполните форму Set build policy:

   

   • Выберите конвейер сборки.

• При необходимости задайте фильтр пути. Узнайте больше о путевых фильтрах в политике ветвлений.

• В разделе "Триггер" выберите "Автоматически" (при обновлении исходной ветви) или "Вручную".

• В разделе "Требование политики" выберите "Обязательный" или "Необязательный". Если выбрано Обязательное, сборки должны завершиться успешно, чтобы завершить PR. Выберите "Необязательно" , чтобы предоставить уведомление о сбое сборки, но по-прежнему разрешить выполнение PR.

• Задайте срок действия сборки, чтобы убедиться в том, что обновления в защищенной ветви не прерывают изменения для открытых пул-реквестов.

  • Немедленно при обновлении <имени> ветви: этот параметр задает состояние политики сборки PR на сбой при обновлении ветви и повторно ставит сборку в очередь. Этот параметр гарантирует успешную сборку изменений в pull request'ах, даже если защищенная ветвь изменяется.

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

  • После <n> часов, если <имя> ветви было обновлено: этот параметр завершает действие текущей политики, если защищенная ветвь обновляется, и актуальная сборка старше, чем указанный порог. Этот параметр представляет собой компромисс между необходимостью всегда или никогда не требовать сборку при обновлении защищённой ветви. Этот выбор уменьшает количество сборок, когда защищенная ветвь имеет частые обновления.

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

• Введите необязательное отображаемое имя для этой политики сборки. Это название идентифицирует политику на странице Политики ветви. Если отображаемое имя не указано, политика использует название конвейера сборки.

1. Выберите Сохранить.

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

Если у вас есть политика сборки “немедленно при обновлении< названия ветки>” или “через <n> часов, если <название ветки> обновлено”, состояние политики обновляется при изменении защищенной ветки, если предыдущая сборка больше не действительна.

Используйте Azure DevOps CLI az repos policy build, чтобы задать и обновить политику проверки сборки.

Создание политики проверки сборки

Используйте az repos policy build create для создания политики проверки сборки.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--subscription]

Параметры

Пример

В следующем примере устанавливается требуемая политика сборки для мердж-запросов в ветке main репозитория Fabrikam. Политика требует успешной сборки ID определения сборки 1 и разрешает только ручное добавление в очередь сборки. В этом примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

az repos policy build create --blocking true --branch main --build-definition-id 1 --display-name build-policy --enabled true --manual-queue-only true --queue-on-source-update-only false --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --valid-duration 0 --output table

ID    Name          Is Blocking    Is Enabled    Repository Id                         Branch
----  ------------  -------------  ------------  ------------------------------------  ---------------
31    build-policy  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Обновление политики проверки сборки

Используйте az repos policy build update для обновления политики проверки сборки.

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--subscription]
                             [--valid-duration]

Параметры

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.

1. Нажмите кнопку +, расположенную рядом с автоматически включенными рецензентами.

   

2. Заполните экран «Добавить новое правило для рецензента».

   

   • Добавление пользователей и групп в рецензенты.

   • Выберите "Необязательно", если вы хотите автоматически добавить рецензентов, но не требовать их утверждения для завершения pull request.

     Или выберите "Обязательный", если pull request'ы не могут быть завершены до:

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

   • Укажите файлы и папки, требующие автоматически включенных рецензентов. Оставьте это поле пустым, чтобы вызвать необходимость рецензентов для всех pull requests в ветке.

   • Выберите "Разрешить утверждать собственные изменения", если владельцы запросов на изменение могут голосовать за утверждение своих собственных запросов чтобы удовлетворить эту политику.

   • Вы можете указать сообщение ленты активности, которое отображается в pull request.

3. Выберите Сохранить.

Используйте Azure DevOps CLI az repos policy required-reviewer, чтобы задать и обновить политику обязательного рецензента.

Создание требуемой политики рецензента

Используйте az repos policy required-reviewer create для создания политики обязательных рецензентов.

az repos policy required-reviewer create --blocking {false, true}
                                         --branch
                                         --enabled {false, true}
                                         --message
                                         --repository-id
                                         --required-reviewer-ids
                                         [--branch-match-type {exact, prefix}]
                                         [--detect {false, true}]
                                         [--org]
                                         [--path-filter]
                                         [--project]
                                         [--subscription]

Параметры

Пример

В приведенном ниже примере Джамал Хартнетт назначен необходимым рецензентом для запросов на вытягивание в ветке main репозитория Fabrikam. В этом примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

az repos policy required-reviewer create --blocking true --branch main --enabled true --message "Please review." --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --required-reviewer-ids fabrikamfiber4@hotmail.com --output table

ID    Name                Is Blocking    Is Enabled    Repository Id                         Branch
----  ------------------  -------------  ------------  ------------------------------------  ---------------
35    Required reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Обновление требуемой политики рецензента

Используйте az repos policy required-reviewer update для обновления требуемой политики рецензента.

az repos policy required-reviewer update --id
                                         [--blocking {false, true}]
                                         [--branch]
                                         [--branch-match-type {exact, prefix}]
                                         [--detect {false, true}]
                                         [--enabled {false, true}]
                                         [--message]
                                         [--org]
                                         [--path-filter]
                                         [--project]
                                         [--repository-id]
                                         [--required-reviewer-ids]
                                         [--subscription]

Параметры

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.