Просмотр запросов на вытягивание

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

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

Если вы просматриваете PR, попробуйте дать конструктивные отзывы, которые точно и легко понять. Дополнительные сведения о отзыве см. в отзыве о запросе на вытягивание. В этой статье описывается, как просмотреть запросы на вытягивание в Azure DevOps.

Вы можете просматривать только PR Azure DevOps на веб-портале с помощью браузера.

В этой статье раскрываются следующие темы:

• Проверить изменения
• Использование комментариев
• Изменение файлов
• Отслеживание проверенных файлов
• Голосование по изменениям PR
• Завершение pr

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

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

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

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

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

  Примечание.

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

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

Вы можете управлять PR в Azure DevOps Services с помощью интерфейса командной строки Azure DevOps (CLI). Интерфейс командной строки Azure DevOps доступен при установке Azure CLI и расширения Azure DevOps. Список команд CLI для управления PR см. в az repos pr следующих командах.

Проверить изменения

Запросы на вытягивание позволяют назначенным рецензентам проверять, обсуждать и голосовать за предложенные изменения до применения этих изменений к целевой ветви репозитория. Помните, что если разработка выполняется с одинаковыми файлами в разных ветвях, могут возникнуть конфликтующие изменения. В этом случае необходимо тщательно проанализировать и устранить эти конфликты. Для этого может потребоваться вручную изменить файл, чтобы правильно применить изменения из источника, целевого или обоих ветвей. Выполнение всех изменений из источника или целевого объекта (которое можно сделать одним щелчком кнопки) может быть неоптимальным и может привести к потере некоторых необходимых изменений. Это можно сделать с помощью средств ADO или будет удобнее использовать средства разработки (например, Visual Studio).

Дополнительные сведения см. в статье "Разрешение конфликт слияния".

В следующих шагах описывается, как рецензенты PR в Azure Repos могут перемещаться по pr для понимания предлагаемых изменений:

1. В веб-браузере откройте командный проект для организации Azure DevOps. Выберите запросы на > вытягивание репозитория, чтобы вывести список PR. По умолчанию откроется вкладка "Обзор ".

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

   Примечание.

   Каждый файл оценивается для ряда изменений и помечается знаком "+" или меткой "переименовать, изменить" рядом с его именем. Если файл имеет более 50 процентов изменений, он считается переименованным. Это пороговое значение по умолчанию для репозиториев Git, которые нельзя изменить.

   

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

   

   Примечание.

   По соображениям производительности представление сводки не отображает изменения для файла, превышающего 0,5 МБ.

4. В представлении диффа для файла можно выбрать макет параллельного или встроенного диффа.

   

   Совет

   Для любого одного файла, превышающего 5 МБ, представление диффа отображает усеченное содержимое файла. Для представления полного содержимого скачайте и просмотрите такие файлы с помощью локального средства диффа.

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

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

   

   Совет

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

6. Перейдите на вкладку Обновления, чтобы просмотреть все отправленные наборы изменений, чтобы убедиться, что вы не пропустили какие-либо изменения исходной ветви. Наборы изменений нумеруются, а последний набор изменений отображается в верхней части списка. Каждый набор изменений показывает фиксации, которые были отправлены в этой операции принудительной отправки. Принудительно отправленный набор изменений не перезаписывает журнал набора изменений и будет отображаться в списке наборов изменений так же, как и любой другой набор изменений.

   

7. Перейдите на вкладку "Фиксации", чтобы просмотреть историю фиксации исходной ветви после ее расхождения с целевой ветвью. Журнал фиксаций на вкладке "Фиксации" будет перезаписан, если автор принудительно отправляет другую историю фиксаций, поэтому фиксации, отображаемые на вкладке "Фиксации", могут отличаться от фиксаций, отображаемых на вкладке Обновления.

   

Просмотр файлов

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

Примечание.

Различия между запросом на вытягивание Azure DevOps и сравнением ветви Azure DevOps вызваны разными методами сравнения.

Существует два метода сравнения для команды Git diff: двухточие (git diff A..B) и трехточие (git diff A...B). По умолчанию запросы на вытягивание показывают трехточие, а сравнение ветви — двухточие.

Например:

      C---D---E branch
     /
A---B---F---G   master

Запросы на вытягивание: git diff branch...master создают только фиксации C, D, E. Сравнение ветвей: git diff branch..master будет производить фиксации C, D, E, F, G.

Дополнительные сведения см. в трехточии и двух dot-git-diff-сравнениях и git diff

Примечание.

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

Проверка обновлений

Просмотрите предыдущие версии кода из раскрывающегося списка "Все обновления ".

Каждое обновление ветви добавляет новую версию в список и на вкладке Обновления pr. При выборе различных обновлений представление представления diff отображает различия между файлами в каждой версии PR.

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

Просмотрите список изменений из автора на вкладке Обновления.

Просмотрите и выберите изменения, внесенные в фиксации в ветвь на вкладке "Фиксации ".

Использование комментариев

Авторы и рецензенты pr могут взаимодействовать друг с другом, добавляя и отвечая на комментарии pr. При просмотре PR используйте комментарии, чтобы указать проблемы с предлагаемыми изменениями, предложить изменения и ответить на предыдущие комментарии. Цель конструктивных отзывов, которые точно и легко понять. Адрес получателей напрямую с помощью их @username. Ссылки на рабочие элементы с помощью #workitemID и других PR.!pullrequestID Иногда авторы PR сами создают комментарии для целей документации.

Предоставление отзывов в комментариях

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

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

   

2. Введите комментарий в поле комментария и нажмите кнопку "Комментарий".

   

Если ваш отзыв применяется ко всему файлу, добавьте комментарий на уровне файла, нажав кнопку "Добавить комментарий " в меню параметров файла:

Чтобы предоставить общие отзывы, не связанные с определенным файлом, добавьте комментарий на вкладке "Обзор ":

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

Предложение изменений в комментариях

Примечания можно использовать для предложения замены текста для одной или нескольких строк в файле:

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

   

2. Щелкните значок лампочки в поле комментария, чтобы внести предлагаемые изменения в поле комментария в огороженный блок кода, а затем нажмите кнопку "Комментарий". Значок лампочки не отображается, если добавить комментарий в исходный код (слева) параллельного представления диффа.

   

Авторы pr могут принять ваше предложение, выполнив следующие действия:

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

   

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

   

Изменение или удаление комментариев

Вы можете изменить или удалить комментарий, наведите указатель мыши на комментарий и выберите значок редактирования или удаления :

Как и комментарии

Авторы и рецензенты pr могут как свой собственный или чужий комментарий, наведите указатель мыши на комментарий и выбрав значок с большим пальцем:

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

Ответ на комментарии

Авторы PR должны отвечать на комментарии, чтобы сообщить рецензентам, как они отвечают на отзывы и предложения:

1. Чтобы ответить на комментарий, введите ответ в поле "Запись ответа ". Адрес получателей напрямую с помощью их @username. Ссылки на рабочие элементы с помощью #workitemID и других PR.!pullrequestID

   

2. После ввода ответа нажмите кнопку "Ответить" и устраните ее , если ответ будет окончательным. В противном случае нажмите кнопку "Ответ".

   

   Если выбрать "Ответ и разрешить", состояние комментария изменится на "Разрешено". Авторы PR также могут напрямую изменить состояние комментария, как описано в следующем разделе.

Изменение состояния комментария

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

• Активно: состояние по умолчанию для новых комментариев.

• Ожидается: проблема в этом комментарии рассматривается и ожидает что-то другое.

• Устранена проблема, связанная с этим комментарием.

• Не исправится: проблема в этом комментарии отмечается, но не будет исправлена.

• Закрыто: обсуждение в этом комментарии закрыто.

Авторы и рецензенты pr могут отслеживать ход выполнения pr, отфильтровав состояние комментария, как описано в следующем разделе.

Фильтрация комментариев

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

Изменение файлов

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

1. Выберите Repos > Files, выберите исходную ветвь PR, выберите файл и нажмите кнопку "Изменить".

   

2. Внесите изменения в редактор, а затем нажмите кнопку "Зафиксировать ", чтобы открыть диалоговое окно "Фиксация ".

   

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

   

Отслеживание проверенных файлов

Рецензенты pr могут отслеживать проверенные файлы, выбрав Mark в меню параметров файла или выбрав проверка box рядом с файлом или папкой:

Голосование по изменениям PR

Браузер

Рецензенты PR могут голосовать по PR, выбрав вариант голосования в раскрывающемся списке голосов. Значок рецензента на странице pr отобразит указание их голосования.

Варианты голосования:

• Утверждает: утверждает предложенные изменения в PR. Этот вариант является только голосованием и не утверждает PR.

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

• Подождите автора: просит автора просмотреть комментарии рецензента. Автор pr должен сообщить рецензентам повторно просмотреть код после того, как автор PR обратился к комментариям. Если обязательный рецензент задает этот параметр голосования, голосование блокирует утверждение PR.

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

• Сброс отзывов: очищает свой голос. Отсутствие голосования не препятствует завершению PR.

CLI Azure DevOps

Чтобы проголосовать за утверждение PR, используйте az repos pr set-vote команду.

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

Параметры

Параметр	Обязательное поле	Описание:
--id	Да	Идентификатор запроса на вытягивание
--vote	Да	Новое значение голосования для запроса на вытягивание (принятые значения: approve, , approve-with-suggestions, rejectresetили wait-for-author)
--detect	No	Автоматическое обнаружение организации (принятые значения: false, true)
--organization	Да, если организация по умолчанию не задана, а файл конфигурации Git не указывает организацию.	URL-адрес организации Azure DevOps или настройка организации по умолчанию с помощью: az devops configure -d organization=<organization URL>
--subscription	No	Имя или идентификатор подписки Azure или настройка подписки по умолчанию с помощью: az account set -s <name or ID>

Примеры

Следующая команда будет голосовать за утверждение PR #21. Команда возвращает таблицу.

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

Следующая команда удаляет голос. Команда возвращает таблицу.

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Завершение pr

Авторы PR могут выбрать параметр разрешения PR:

• Завершено: завершите pr теперь, если все необходимые рецензенты одобрили его и все необходимые политики ветви выполнены.

• Установите автоматическое завершение: автоматическое завершение запроса при утверждении всех необходимых рецензентов и всех обязательных политик ветви.

• Пометка как черновик: задайте для запроса состояние черновика, указывая, что он не готов к просмотру. Для черновика PR можно выбрать "Опубликовать ", чтобы удалить его состояние черновика и пометить его готовым к просмотру.

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

Дополнительные сведения о завершении запроса на вытягивание см. в разделе "Завершение запроса на вытягивание".

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

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

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

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