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

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

Visual Studio 2019 | Visual Studio 2022

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

Рекомендации по pr и управлению см. в разделе "Сведения о запросах на вытягивание".

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

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

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

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

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

    Примечание.

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

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

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

Вы можете создать новый PR на веб-сайте проекта Azure DevOps, из Visual Studio или из Интерфейса командной строки Azure DevOps.

На веб-сайте проекта Azure DevOps вы можете создать новый pr из:

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

Вы можете создать PR для любой ветви на странице запросов на вытягивание проекта в Интернете.

  1. На странице запросов на вытягивание repos>выберите новый запрос на вытягивание в правом верхнем углу.

    Снимок экрана: кнопка

  2. Выберите ветвь с изменениями и ветвью, в которую необходимо объединить изменения, например основную ветвь.

    Снимок экрана: исходные и целевые ветви для P R в Azure Repos.

  3. Введите сведения о pr и создайте pr.

Создание PR из принудительной ветви

После отправки или обновления ветвь компонента Azure Repos отображает запрос на создание pr.

  • На странице запросов на вытягивание:

    Снимок экрана: запрос на создание P R на вкладке

  • На странице "Файлы":

    Снимок экрана: запрос на создание P R на вкладке

Выберите " Создать запрос на вытягивание", чтобы перейти на страницу, в которой можно ввести сведения о PR и создать pr.

Создание PR из связанного рабочего элемента

Вы можете создать PR непосредственно из рабочего элемента Azure Boards, связанного с ветвью.

  1. В Azure Boards из невыполненных работ или запросов в режиме работы откройте рабочий элемент, связанный с ветвью.

  2. В области разработки рабочего элемента выберите "Создать запрос на вытягивание".

    Снимок экрана: создание pr из области разработки рабочего элемента с связанной ветвью.

Ссылка позволяет перейти на страницу, в которой можно ввести сведения о PR и создать pr.

Добавление обновлений с помощью выбора вишни

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

Чтобы выбрать изменения из завершенного PR, выберите вишни выбрать на странице обзора PR. Чтобы скопировать изменения из активного PR, выберите "Вишни- выбрать" в меню "Дополнительные параметры pr". Это действие создает новую ветвь с скопированными изменениями. Затем вы можете создать новый PR из новой ветви. Подробные инструкции см. в разделе "Копирование изменений с помощью вишни-выбора".

Переключение исходных и целевых ветвей запроса на вытягивание

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

Снимок экрана: значок источника коммутатора и целевых ветвей.

Использование шаблонов запросов на вытягивание

Шаблон запроса на вытягивание — это файл, содержащий текст Markdown, который заполняет описание PR при создании PR. Хорошие описания PR сообщают рецензентам о том, что ожидать, и могут помочь отслеживать задачи, такие как добавление модульных тестов и обновление документации. Ваша команда может создать шаблон PR по умолчанию, который добавляет текст во все новые описания PR в репозитории. Кроме того, вы можете выбрать шаблоны, относящиеся к ветви, или другие шаблоны, которые определяет команда. Дополнительные сведения о создании и использовании шаблонов PR см. в разделе "Улучшение описания запросов на вытягивание" с помощью шаблонов.

Если репозиторий имеет шаблон по умолчанию, все PR в репозитории имеют текст описания шаблона по умолчанию при создании. Чтобы добавить другие шаблоны, выберите " Добавить шаблон " и выберите шаблон из раскрывающегося списка. Вы можете изменить текст шаблона в описании, удалить его или добавить другой текст.

Снимок экрана: добавление шаблона при создании P R.

Создание черновика PR

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

Проекты PR имеют следующие отличия от опубликованных PR:

  • Политики проверки сборки не выполняются автоматически. Вы можете выполнить проверку сборки вручную, выбрав меню дополнительных параметров в PR.

  • Голосование отключено в режиме черновика.

  • Обязательные рецензенты не добавляются автоматически. Уведомления отправляются только рецензентам, которые вы явно добавляете в черновик PR.

  • Черновик PR отображается в списке PR с значком "Черновик ".

    Снимок экрана: черновик P R в списке P R.

Примечание.

Для создания проектов PR требуется обновление или более поздняя версия Azure DevOps Server 2019.1.

Чтобы создать черновик PR, щелкните стрелку рядом с элементом "Создать " и нажмите кнопку "Создать как черновик " при создании PR. Вам не нужно использовать префиксы заголовков, например WIP или DO NOT MERGE.

Снимок экрана: создание в виде черновика P R.

Когда вы будете готовы проверить и завершить pr, нажмите кнопку "Опубликовать " в правом верхнем углу в pr. Публикация pr назначает необходимых рецензентов, оценивает политики и запускает голосование.

Снимок экрана: публикация для P R.

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

Снимок экрана: Mark as черновик.

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

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

Когда вы будете готовы проверить изменения, нажмите кнопку "Создать ", чтобы создать pr.

Снимок экрана: создание нового P R.

Добавление сведений в новый P R.

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

Изменение заголовка и описания PR

Следите за заголовком и описанием PR, чтобы рецензенты могли понять изменения в pr.

Вы можете обновить название существующего PR, выбрав текущее название и обновив текст. Щелкните значок "Сохранить", чтобы сохранить изменения, или щелкните значок отмены карта изменения.

Измените описание PR, выбрав значок "Изменить " в разделе "Описание ".

Снимок экрана: изменение заголовка P R и нажатие кнопки

Добавление рецензентов в запрос на вытягивание

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

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

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

Снимок экрана, на котором показана политика просмотра для рецензента, который автоматически включается политикой ветви.

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

Чтобы добавить рецензентов в новый PR:

  1. На странице "Новый запрос на вытягивание" в разделе "Рецензенты" выберите "Поиск пользователей и групп", чтобы добавить в качестве рецензентов.
  2. При вводе имени или адреса электронной почты раскрывающийся список отображает список соответствующих пользователей и групп. Выберите имена из списка, чтобы добавить в качестве необязательных рецензентов.
  3. Чтобы добавить необходимых рецензентов, выберите "Добавить обязательных рецензентов", а затем выберите "Поиск", чтобы добавить необходимых рецензентов для поиска и выбора имен.

Снимок экрана: добавление рецензента в новый P R.

Чтобы добавить рецензентов в существующий PR:

  1. В разделе "Рецензенты" на странице "Обзор" выберите "Добавить", а затем выберите "Обязательный рецензент" или "Необязательный рецензент".

    Обзор запроса на вытягивание

  2. При вводе имени или адреса электронной почты появится список соответствующих пользователей или групп. Выберите имена для добавления в качестве рецензентов.

    Добавление рецензента P R.

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

Чтобы связать рабочие элементы с новым pr, выполните приведенные ниже действия.

  1. На странице "Новый запрос на вытягивание" в разделе "Рабочие элементы" выберите "Поиск рабочих элементов" по идентификатору или названию.
  2. Начните вводить идентификатор рабочего элемента или заголовок, а затем выберите рабочий элемент, чтобы связаться со списком, который появится. Поиск по названию возвращает рабочие элементы, отфильтрованные по состоянию; Все рабочие элементы с состояниями с категориями состояний завершены и удалены , исключены. Эти рабочие элементы также фильтруются по дате и пользователю, только созданные или обновленные в течение последних 30 дней, и они должны быть созданы, назначены или авторизованы в качестве текущего пользователя.

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

  1. На вкладке "Обзор pr" в области "Рабочие элементы" выберите +.

    Снимок экрана: выбор вкладки

  2. Введите идентификатор рабочего элемента или найдите название рабочего элемента. Выберите рабочий элемент в появившемся списке.

Удалите ссылку на рабочий элемент, выбрав значок x рядом с рабочим элементом. При удалении ссылки удаляется только ссылка между рабочим элементом и PR. Ссылки, созданные в ветви или из фиксаций, остаются в рабочем элементе.

Чтобы связать рабочие элементы с вашим PR, выполните приведенные ниже действия.

  1. Перейдите на вкладку "Обзор " в pr.

    Снимок экрана: вкладка

  2. Нажмите кнопку "Добавить" в области "Рабочие элементы ". Значок добавления в PR

  3. Введите идентификатор рабочего элемента или найдите рабочие элементы с заголовками, соответствующими тексту. Выберите рабочий элемент в появившемся списке. Поиск по названию возвращает рабочие элементы, отфильтрованные по состоянию; Все рабочие элементы с состояниями с категориями состояний завершены и удалены , исключены. Эти рабочие элементы также фильтруются по дате и пользователю, только созданные или обновленные в течение последних 30 дней, и они должны быть созданы, назначены или авторизованы в качестве текущего пользователя.

Удалите ссылки на рабочий элемент, нажав кнопку удаления, которая отображается при наведении указателя мыши на рабочий элемент. Кнопка При удалении ссылки удаляется только ссылка между рабочим элементом и pr. Ссылки, созданные в ветви или из фиксаций, остаются в рабочем элементе.

Добавление тегов в запрос на вытягивание

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

Снимок экрана: P Rs с тегами.

Чтобы добавить тег при создании PR, введите имя тега в разделе "Теги ". После создания pr вы можете управлять тегами в разделе "Теги ".

Снимок экрана: выделенный раздел

Добавление вложений в запросы на вытягивание

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

Снимок экрана: присоединение файлов к описанию P R во время создания.

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

Для большинства команд почти все PR предназначены для ветвь по умолчанию, например main или develop. Если иногда вам нужно выбрать другую ветвь, при создании PR легко забыть изменить целевую ветвь. В этом случае можно изменить целевую ветвь активного PR:

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

Уведомления по запросу на вытягивание электронной почты заинтересованным лицам

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

  1. Выберите "Дополнительные параметры" на странице обзора pr и нажмите кнопку "Поделиться запросом на вытягивание".

    Снимок экрана: выбор запроса на вытягивание общего доступа на странице обзора P R.

  2. На экране запроса на вытягивание общего доступа добавьте получателей, введя их имена в поле "To" и выбрав из отображаемых имен пользователей. Вы также можете удалить получателей.

  3. Добавьте необязательное сообщение в поле Примечание (необязательно) и нажмите кнопку "Отправить". Получатели получают сообщение электронной почты, запрашивающее их внимание и связывание с PR.

Примечание.

Если вы используете встроенную функцию электронной почты, вы можете отправлять только электронное письмо отдельным адресам участников проекта. Добавление группы группы или группы безопасности в строку To: не поддерживается. Если вы добавите учетную запись электронной почты, которую система не распознает, вы получите сообщение о том, что один или несколько получателей электронной почты не имеют разрешений на чтение почтового запроса на вытягивание.

Чтобы функция электронной почты работала, администратор Azure DevOps Server должен настроить SMTP-сервер.

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