Завершение, отказ или возврат запросов на вытягивание

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

Visual Studio 2019 | Visual Studio 2022

После того как все необходимые рецензенты утвердят запрос на вытягивание (PR) и PR соответствуют всем требованиям политики ветви, вы можете объединить изменения в целевую ветвь и завершить pr. Или если вы решили не продолжать изменения в PR, вы можете отказаться от PR.

Чтобы устранить изменения рецензентов, ответить на комментарии и устранить их, см . примечания к адресу.

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

• Репозитории должны быть включены в проекте. Если концентратор Repos и связанные страницы не отображаются, см. раздел "Включение или отключение службы Azure DevOps" для повторного использования репозиториев.

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

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

• Чтобы просмотреть или просмотреть PR, необходимо иметь базовый или более высокий доступ к проекту Azure DevOps.

• Если вы не входите в проект, в который вы хотите внести свой вклад, добавьте его.

  Примечание.

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

• Дополнительные сведения о разрешениях и доступе см. в разделе "Репозиторий Git по умолчанию" и " Разрешения ветви" и "Сведения о уровнях доступа".

• В Azure DevOps Services можно управлять PR и другими ресурсами из интерфейса командной строки Azure с azure-devops помощью расширения. Сведения о работе с интерфейсом командной строки Azure DevOps Services см. в статье "Начало работы с Azure DevOps CLI". Команды Azure Repos CLI для PR используют az repos pr.

Проверка изменений слиянием

После завершения pr Git добавляет новую фиксацию слияния в конец основной ветви. Эта фиксация слияния связывает предыдущие истории основной ветви и исходной ветви PR. Чтобы просмотреть фиксацию слияния предварительного просмотра и проверить наличие конфликт слияния, выберите меню "Дополнительные параметры" в правом верхнем углу на странице обзора pr, а затем выберите "Просмотреть изменения слиянием".

Если вы изменили целевую ветвь после создания pr, выберите "Перезапустить слияние ", чтобы создать новую предварительную фиксацию слияния и обновить представление изменения слияния.

Проверка политик ветви

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

Браузер

На вкладке "Обзор pr" приведены политики ветвей, которые передают или завершаются сбоем для pr. В обзоре перечислены только неудачные политики, но вы можете просмотреть все проверки политики, выбрав "Просмотреть <n>".

На странице обзора pr требования политики ветви имеют значок. Выберите "Дополнительные параметры " рядом с требованием, а затем выберите "Просмотреть политику ", чтобы перейти на страницу "Политики ветви" в параметрах проекта.

Visual Studio

Вы можете открыть PR в Visual Studio, а затем просмотреть политики ветвей, как описано на вкладке "Браузер".

Чтобы открыть pr из Visual Studio, в меню Git выберите< запросы на вытягивание службы>>Git и выберите запрос на вытягивание, чтобы открыть его.

Visual Studio 2019 версии 16.8 и более поздних версий предоставляет интерфейс управления версиями Git при сохранении пользовательского интерфейса Team Explorer Git. Чтобы использовать Team Explorer, снимите флажок ">Параметры>предварительного просмотра возможностей>Git" в строке меню. Вы можете выполнять функции Git из любого интерфейса взаимозаменяемо.

Чтобы получить доступ к PR из Visual Studio Team Explorer, выполните следующее:

1. Подключитесь к проекту из Visual Studio.

2. Выберите "Просмотреть>team Explorer", чтобы открыть Team Explorer. Вы также можете нажать клавиши CTRL+\, CTRL+M.

3. В разделе "Главная" выберите запросы на вытягивание для просмотра списков PR, открытых вами или назначенных вам.

4. Чтобы открыть PR на веб-портале и просмотреть действующие политики, щелкните правой кнопкой мыши PR и выберите "Открыть в браузере".

CLI Azure DevOps

Чтобы просмотреть все политики ветвей, действующие для PR, используйте az repos pr policy list с обязательным id параметром.

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Параметры

Параметр	Описание
--id	Идентификатор запроса на вытягивание. Необходимые.
--detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
--org --organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
--query-examples	Рекомендуемая строка JMESPath. Вы можете скопировать один из запросов и вставить его после --query параметра в двойных кавычках, чтобы просмотреть результаты. Вы можете добавить одно или несколько позиционных ключевых слов, чтобы предложения основывались на этих ключевых словах.
--skip	Количество пропустить политик.
--subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.
--top	Максимальное число политик для списка.

Пример

Например, чтобы просмотреть политики, действующие на PR #28, выполните следующую команду:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

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

После разрешения любых конфликт слияния и pr соответствует всем политикам ветви и имеет все необходимые утверждения, вы можете завершить pr.

Браузер

1. Нажмите кнопку "Завершить" в правом верхнем углу, чтобы завершить pr. Или щелкните стрелку раскрывающегося списка рядом с кнопкой "Завершить " и выберите один из вариантов.

   

   • Завершите работу: завершите pr-запрос и объедините изменения в целевую ветвь.
   • Настройка автоматического завершения. Настройте pr для завершения и слияния после выполнения всех необходимых политик ветви.
   • Помечайте как черновик: верните pr для проекта состояния и удалите все голоса.
   • Отказаться: закройте PR, не объединяя изменения.

2. В области "Полный запрос на вытягивание" в разделе "Тип слияния" выберите один из вариантов слияния.

   

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

   Примечание.

   Существующие политики применяются. Например, если в вашей ветви в настоящее время есть политика "только слияние скваша", необходимо изменить эту политику, если вы хотите использовать другой тип слияния.

3. Выберите любой из следующих вариантов после завершения. Некоторые параметры недоступны для некоторых типов слиянием.

   • Завершите связанные рабочие элементы после объединения: завершите все связанные рабочие элементы.
   • Удалите имя> ветви после объединения: удалите <исходную ветвь PR после объединения.
   • Настройка сообщения фиксации слияния: добавление настраиваемого сообщения фиксации слияния. При выборе этого параметра обновите сообщение фиксации слияния.
   • Переопределите политики ветви и включите слияние. Принудительное слияние, даже если pr не удовлетворяет всем политикам ветви. Этот параметр доступен только в том случае, если у вас есть разрешение на применение политик.

4. Выберите Завершить слияние.

После завершения слияния все связанные рабочие элементы автоматически обновляются, чтобы показать завершение pr.

Visual Studio

Чтобы завершить pr, откройте PR в браузере и на странице обзора нажмите кнопку "Завершить " или задать другие параметры.

Чтобы открыть pr из Visual Studio, в меню Git выберите< запросы на вытягивание службы>>Git и выберите запрос на вытягивание, чтобы открыть его.

Чтобы получить доступ к PR из Visual Studio 2019 Team Explorer, выполните следующее:

1. Подключитесь к проекту из Visual Studio.

2. Выберите "Просмотреть>team Explorer", чтобы открыть Team Explorer. Вы также можете нажать клавиши CTRL+\, CTRL+M.

3. В разделе "Главная" выберите запросы на вытягивание для просмотра списков PR, открытых вами или назначенных вам.

4. Чтобы открыть PR на веб-портале, щелкните правой кнопкой мыши PR и выберите "Открыть в браузере".

CLI Azure DevOps

Чтобы завершить pr-запрос и объединить изменения, используйте az repos pr update для обновления PR --status до completed.

Например, чтобы завершить PR #21, используйте:

az repos pr update --id 21 --status completed

Настройка параметров завершения

Параметры завершения pr можно задать при создании pr с az repos pr createпомощью параметров создания или обновления параметров создания в существующих PR с помощью az repos pr update.

Варианты завершения pr включают:

• bypass-policy {false, true}: следует ли обходить все необходимые политики и завершать запрос на вытягивание после его объединения.
• bypass-policy-reason: причина обхода обязательных политик.
• delete-source-branch {false, true}: следует ли удалить исходную ветвь после завершения и объединения запроса на вытягивание.
• merge-commit-message: настройте сообщение фиксации слияния.
• squash {false, true}: следует ли сквашировать исходные фиксации в одну целевую фиксацию для слияния.
• transition-work-items {false, true}: следует ли разрешать связанные рабочие элементы при слиянии pr.

Чтобы задать параметры завершения и завершить существующий PR, используйте az repos pr update необходимый id параметр.

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Параметры

Параметр	Описание
--id	Идентификатор запроса на вытягивание. Необходимые.
--auto-complete	Настройте запрос на вытягивание автоматически, когда все политики прошли и исходная ветвь может быть объединена в целевую ветвь. Допустимые значения: false, true.
--bypass-policy	Обойдите все необходимые политики и завершите запрос на вытягивание после его объединения. Допустимые значения: false, true.
--bypass-policy-reason	Причина обхода обязательных политик.
--delete-source-branch	Удалите исходную ветвь после завершения запроса на вытягивание и объедините ее в целевую ветвь. Допустимые значения: false, true.
--description -d	Новое описание запроса на вытягивание. Может включать Markdown. Каждое значение — новая строка. Например: --description "First Line" "Second Line".
--detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
--draft	Преобразуйте PR в режим черновика или опубликуйте его. Допустимые значения: false, true.
--merge-commit-message	Сообщение для отображения при слиянии фиксаций.
--org --organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
--squash	Сквашируйте фиксации в исходной ветви при слиянии с целевой ветвью. Допустимые значения: false, true.
--status	Задайте новое состояние запроса на вытягивание. Принятые значения: abandoned, active, completed.
--subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.
--title	Новое название запроса на вытягивание.
--transition-work-items	Перенесите все рабочие элементы, связанные с запросом на вытягивание, в следующее логическое состояние, например "Разрешено". Допустимые значения: false, true.

Пример

Следующий пример завершает pr #21, удаляет исходную ветвь, разрешает связанные рабочие элементы и добавляет сообщение фиксации слияния:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Перебаза во время завершения pr

Существует несколько ситуаций, когда при повторной настройке при завершении PR невозможно:

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

Во всех этих случаях вы по-прежнему можете перебазировать ветвь локально, а затем отправить вверх или объединить изменения при завершении pr.

Базовая проблема, возникающая при нескольких слияниях

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

Устранение конфликтов слияния

Изменения файлов в ветви могут конфликтовить с изменениями в другой ветви. Если не ясно, как объединить изменения, Git отображает файлы, конфликтующие на странице обзора PR. Перед слиянием pr-ветви и целевой ветвью необходимо разрешить любые конфликт слияния, прежде чем можно объединить pr или задать для проверки автозаполнение. Инструкции по решению конфликтов слияния см. в разделе Разрешение конфликтов слияния.

Настройка запроса на вытягивание для автозавершения

Браузер

Выберите "Задать автоматическое завершение " в раскрывающемся списке "Завершено ", чтобы завершить и объединить изменения pr, как только условия соответствуют всем политикам ветви. После завершения pr вы получите уведомление по электронной почте. Если конфликт или ошибка препятствуют завершению pr, сообщение электронной почты уведомляет вас о проблеме.

Примечание.

Параметр автоматического завершения set доступен в Azure Repos и TFS 2017 и более поздних версий при наличии политик ветви. Если вы не видите автоматическое завершение установки, у вас нет политик ветвей. Дополнительные сведения см. в разделе "Политики ветви".

По умолчанию pr, устанавливаемый для автозаполнения, ожидается только в необходимых политиках. На панели "Включить автоматическое завершение " можно также ждать дополнительных политик.

Начиная с TFS 2018 с обновлением 2, на странице обзора pr отображается список невыполненных критериев политики, ожидающих PR. Если в области включения автоматического завершения задана политика, ее можно настроить на необязательной странице обзора.

Нажмите кнопку "Отменить автозавершение ", чтобы отключить автозавершение.

На странице "Запросы на вытягивание" отображается значок автозавершения.

Visual Studio

Откройте запрос на вытягивание на веб-портале. На странице "Обзор" выберите "Задать автоматическое завершение".

Чтобы открыть pr из Visual Studio, в меню Git выберите< запросы на вытягивание службы>>Git и выберите запрос на вытягивание, чтобы открыть его.

Чтобы получить доступ к PR из Visual Studio 2019 Team Explorer, выполните следующее:

1. Подключитесь к проекту из Visual Studio.

2. Выберите "Просмотреть>team Explorer", чтобы открыть Team Explorer. Вы также можете нажать клавиши CTRL+\, CTRL+M.

3. В разделе "Главная" выберите запросы на вытягивание для просмотра списков PR, открытых вами или назначенных вам.

4. Чтобы открыть PR на веб-портале и просмотреть действующие политики, щелкните правой кнопкой мыши PR и выберите "Открыть в браузере".

CLI Azure DevOps

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

• Чтобы задать автозавершение при создании PR, используйте az repos pr create --auto-complete true.
• Чтобы обновить существующий PR до автозавершения, используйте az repos pr update --id <PR Id> --auto-complete true.

Отмена или повторная активация запроса на вытягивание

Браузер

Чтобы отказаться от изменений и pr без объединения, нажмите кнопку "Отказаться " в раскрывающемся списке на кнопке "Завершить ". Вы по-прежнему можете просмотреть заброшенный PR, и он остается связанным с рабочими элементами.

Чтобы повторно активировать заброшенный PR в любое время, откройте pr на вкладке "Отброшенные " в представлении "Запрос на вытягивание" и нажмите кнопку "Повторно активировать " в правом верхнем углу.

Visual Studio

Откройте запрос на вытягивание на веб-портале. На странице обзора нажмите кнопку "Отказаться".

Чтобы открыть pr на веб-портале, используйте процедуру из запроса на вытягивание.

CLI Azure DevOps

Чтобы отказаться от PR, не объединяя изменения, используйте az repos pr update --id <PR Id> –-status abandoned. Вы можете повторно активировать PR, задав для этого состояние active.

Возврат завершенного запроса на вытягивание

Чтобы отменить изменения из PR, выполните следующие действия. Дополнительные сведения см. в разделе "Отмена изменений".

1. Откройте завершенный PR и выберите "Вернуться". Это действие создает новую ветвь с изменениями, которые отменяют pr в существующей целевой ветви в репозитории.

2. В области запроса на восстановление выполните следующие действия.

   1. В разделе "Целевая ветвь" выберите ветвь, в которой требуется отменить изменения pr.
   2. В разделе " Имя ветви раздела" измените имя ветви PR, если вы хотите.
   3. Нажмите кнопку "Вернуть".

3. На экране "Создать запрос на вытягивание" нажмите кнопку "Создать".

4. Объедините новый PR для завершения восстановления.

Примечание.

Ветвь, созданная во время этого восстановления, имеет одну фиксацию, которая отменяет все изменения файла с исходного PR. Ветвь не содержит возвращенную фиксацию для каждой фиксации в исходном PR.

Следующие шаги

Копирование изменений с помощью вишни-выбора

Связанные статьи

• Уведомления об обновлении запросов на вытягивание
• Сведения о запросах и разрешениях на вытягивание