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

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

| Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 Visual Studio 2015

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

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

Предварительные требования

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

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

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

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

    Примечание

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

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

Создание запроса на включение изменений

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После отправки или обновления ветви компонента Azure Repos предлагает создать запрос на вытягивание в представлении кода в Интернете. Этот запрос отображается в запросах на вытягивание и файлы.

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

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

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

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

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

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

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

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

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

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

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

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

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

Перед первым сохранением запроса на вытягивание можно переключить исходные и целевые ветви ЗАПРОСА, щелкнув значок "Переключить исходные и целевые ветви" рядом с именами ветвей . Когда запрос на вытягивание активен, этот значок исчезнет, но вы по-прежнему можете изменить целевую ветвь запроса на вытягивание.

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

Снимок экрана: пометка как черновик.

Примечание

Для этой функции требуется Azure DevOps Server обновления 2019.1 или более поздней версии.

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

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

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

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

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

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

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

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

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

Измените описание запроса на вытягивание, щелкнув значок "Изменить " в разделе "Описание ".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Перейдите на вкладку "Обзор " в запросе на вытягивание.

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

  2. Нажмите кнопку "Добавить" в области "Рецензенты ".

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

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

    Добавление рецензента pr

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

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

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

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

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

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

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

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

  1. Перейдите на вкладку "Обзор " в запросе на вытягивание.

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

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

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

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

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

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

    Выберите

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

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

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

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

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

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

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

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

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

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

Примечание

Для использования меток PR требуется TFS 2018.2 или более поздней версии.

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

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

Добавление метки P R

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

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

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

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

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

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

Email уведомления о запросах на вытягивание заинтересованным лицам

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

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

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

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

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

Примечание

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

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

Дальнейшие действия