Просмотр, фильтрация и открытие запросов на вытягивание
Статья
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Вы создаете запросы на вытягивание (PR) для проверки и слияния изменений кода в репозитории Git в Azure Repos. Участники группы и заинтересованные лица могут просматривать изменения и давать отзывы перед слиянием кода в целевую ветвь. Рецензенты также могут комментировать изменения и голосовать за утверждение или отклонение кода.
Teams может требовать PR для любых изменений в защищенная ветвь и задать политики ветви, чтобы определенные PR соответствовали определенным критериям.
Существует несколько способов перечисления, фильтрации, просмотра и открытия PR для проекта.
Необходимые компоненты
Репозитории должны быть включены в проекте. Если концентратор Repos и связанные страницы не отображаются, см. раздел "Включение или отключение службы Azure DevOps" для повторного использования репозиториев.
Чтобы просмотреть PR, необходимо быть членом проекта Azure DevOps, в который входит pr, с базовым доступом или выше. Если вы не член проекта, добавьте его.
Примечание.
Для общедоступных проектов пользователи, которым предоставлен доступ заинтересованных лиц , имеют полный доступ к Azure Repos.
Репозитории должны быть включены в проекте. Если концентратор Repos и связанные страницы не отображаются, см. раздел "Включение или отключение службы Azure DevOps" для повторного использования репозиториев.
Чтобы просмотреть PR, необходимо быть членом проекта Azure DevOps с базовым доступом или выше. Если вы не член проекта, добавьте его.
В представлении по умолчанию отображаются PR на вкладке "Шахта ". Выберите "Активный ", чтобы отобразить все активные PR для текущего репозитория. Выберите "Завершено" или "Отменено", чтобы открыть списки закрытых PR.
Выберите любой pr-запрос в списке, чтобы перейти на страницу обзора этого PR.
Вы можете перечислить все PR в разных проектах в организации, выбрав запросы на вытягивание в представлении "Моя работа ".
Чтобы вывести список запросов на вытягивание из Visual Studio, в меню Git выберите< запросы на вытягивание службы>>Git.
Visual Studio 2019 версии 16.8 и более поздних версий предоставляет интерфейс управления версиями Git при сохранении пользовательского интерфейса Team Explorer Git. Чтобы использовать Team Explorer, снимите флажок ">Параметры>предварительного просмотра возможностей>Git" в строке меню. Вы можете выполнять функции Git из любого интерфейса взаимозаменяемо.
Чтобы получить доступ к PR из Visual Studio Team Explorer, выполните следующее:
Выберите "Просмотреть>team Explorer", чтобы открыть Team Explorer. Вы также можете нажать клавиши CTRL+\, CTRL+M.
В разделе "Главная" выберите запросы на вытягивание для просмотра списков PR, открытых вами или назначенных вам.
Чтобы просмотреть список PR на веб-портале Azure DevOps, выберите "Действия " и выберите " Открыть в браузере".
Чтобы вывести список активных PR в проекте со своими сведениями, используйте az repos pr list.
az repos pr list [--creator]
[--detect {false, true}]
[--include-links]
[--org]
[--project]
[--query-examples]
[--repository]
[--reviewer]
[--skip]
[--source-branch]
[--status {abandoned, active, all, completed}]
[--subscription]
[--target-branch]
[--top]
Параметры
Параметр
Описание
--creator
Ограничить результаты запросами на вытягивание, созданные этим пользователем.
--detect
Автоматическое обнаружение организации. Допустимые значения: false, true.
--include-links
Включите _links для каждого запроса на вытягивание.
--org--organization
URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
--project-p
Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
--query-examples
Рекомендуемая строка JMESPath. Вы можете скопировать один из запросов и вставить его после --query параметра в двойных кавычках, чтобы просмотреть результаты. Вы можете добавить одно или несколько позиционных ключевых слов, чтобы предложения основывались на этих ключевых словах.
--repository-r
Имя или идентификатор репозитория.
--reviewer
Ограничить результаты запросами на вытягивание, в которых этот пользователь является рецензентом.
--skip
Количество пропустить запросы на вытягивание.
--source-branch-s
Ограничить результаты для запросов на вытягивание, поступающие из этой исходной ветви.
--status
Ограничить результаты для запросов на вытягивание с таким состоянием. Принятые значения: abandoned, active, allcompleted.
--subscription
Имя или идентификатор подписки Azure. Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.
--target-branch-t
Ограничить результаты для запросов на вытягивание, предназначенные для этой ветви.
--top
Максимальное количество запросов на вытягивание списка.
Пример
Следующая команда содержит список всех PR в репозитории, независимо от состояния, и отображает выходные данные в таблице. В примере используется конфигурация az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.
Определение пользовательского представления запроса на вытягивание
Фильтрация списка PR помогает находить и упорядочивать PR, чтобы определить приоритеты наиболее важных файлов в рабочем процессе.
Чтобы отфильтровать список PR, на странице "Запросы на вытягивание" щелкните значок фильтра в правом верхнем углу. Затем выберите "Целевая ветвь" или другой заголовок столбца и выберите ветвь или другое значение, на которое вы хотите отфильтровать.
Чтобы дополнительно настроить представление списка PR, выберите "Настроить представление " в правом верхнем углу на странице запросов на вытягивание.
На странице "Настройка представления" можно изменить порядок текущих разделов представления, изменить их или удалить. Чтобы создать новый раздел, нажмите кнопку "Добавить".
На странице "Настройка" введите и выберите значения, чтобы отфильтровать раздел по параметрам, таким как состояние черновика или обновленная дата. Вы можете выбрать, следует ли отображать запросы на вытягивание, утвержденные или отклоненные на отдельной вкладке, или исключить запросы на вытягивание (дубликаты), включенные в предыдущие разделы. Завершив настройку представления, нажмите кнопку "Сохранить".
Эти настраиваемые представления создают отдельные сворачиваемые разделы на странице запроса на вытягивание. Эти настраиваемые запросы также работают между репозиториями на вкладке "Мои запросы на вытягивание" домашней страницы организации.
Чтобы изменить параметры настраиваемых представлений, нажмите кнопку "Настроить " рядом с представлением. Или выберите "Настроить представление" и на экране "Настройка" выберите представление, которое нужно изменить. Некоторые представления, например Назначенные мне, не могут быть настроены, но их можно изменить или удалить.
На вкладке PR-файлов можно использовать несколько фильтров для выбора файлов и комментариев для более быстрых проверок. Выберите " Фильтр", а затем выберите один из параметров.
Ключевое слово: введите ключевое слово.
Просмотр/отмена : все (по умолчанию), ожидание, проверка.
Закомментированные файлы: все файлы (по умолчанию), файлы с комментариями.
Примечания: показать (по умолчанию), новые возможности, скрыть.
Состояние примечания: активный (по умолчанию), ожидание, разрешение, как разработано, не исправляется, закрывается.
Примечания: все комментарии (по умолчанию) или конкретный человек.
Можно также ввести строку в поле поиска, чтобы отобразить соответствующие результаты из предыдущих параметров.
Фильтрация запросов на вытягивание из Visual Studio:
В меню Git выберите< запросы на вытягивание службы>>Git.
Фильтрация по автору, метки или другим атрибутам.
В представлении запросов на вытягивание Team Explorer:
Выберите "Активный" или "Назначено мне" или моей команде, чтобы отфильтровать списки PR по состоянию или назначению pr.
Или введите в поле "Тип", чтобы отфильтровать поля списка, чтобы отфильтровать списки PR по дате, автору, ветви или другим атрибутам.
Для фильтрации списка PR можно использовать несколько параметров az repos pr для фильтрации списка PR, таких как --creator, , --repository--project, --status--target-branch--reviewer--source-branchи --top.
Имена --creator и --reviewer значения могут отображаться или адреса электронной почты. Параметр --top определяет максимальное количество PR для списка.
Например, чтобы получить список сведений о последнем созданном pr, независимо от его состояния, используйте следующую команду:
az repos pr list --creator "My Name" --status all --top 1
Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.
Открытие запроса на вытягивание
При открытии pr из браузера из Visual Studio или из Azure CLI откроется страница обзора pr в браузере.
Чтобы открыть PR в браузере, выберите pr из списка на странице запросов на вытягивание. Откроется вкладка "Обзор ". На вкладке "Обзор" отображается название pr, описание, рецензенты, связанные рабочие элементы, журнал и состояние. Вы можете просмотреть сводку политик ветвей, которые передают или завершаются сбоем, и просмотреть комментарии рецензентов.
На вкладке "Файлы PR" можно просмотреть фактические изменения в PR-файлах. На вкладках "Обновления и фиксации" вы увидите изменения, внесенные автором, чтобы обновить ветвь PR.
Чтобы открыть запрос на вытягивание из Visual Studio, в меню Git выберите <запросы на вытягивание службы>> Git, а затем выберите запрос на вытягивание, чтобы открыть его.
Или в представлении запросов на вытягивание Team Explorer щелкните правой кнопкой мыши pr и выберите "Открыть в браузере", чтобы открыть pr на веб-портале.
Ознакомьтесь с ветвью
В Visual Studio 2019 можно извлечь исходную ветвь PR непосредственно из представления "Запросы на вытягивание". Щелкните правой кнопкой мыши pr и выберите "Извлечь исходную ветвь".
Примечание.
Visual Studio 2019 версии 16.8 и более поздних версий предоставляют новое меню Git для управления рабочим процессом Git с меньшим переключением контекста, чем Team Explorer. Процедуры, предоставляемые в этой статье на вкладке Visual Studio, предоставляют сведения об использовании интерфейса Git, а также Team Explorer. Дополнительные сведения см . в параллельном сравнении Git и Team Explorer.
Чтобы отобразить сведения для одного pr, используйте az repos pr show с обязательным --id параметром. Чтобы открыть PR в браузере, используйте --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
Параметры
Параметр
Описание
--id
Идентификатор запроса на вытягивание. Необходимые.
--detect
Автоматическое обнаружение организации. Допустимые значения: false, true.
--open
Откройте запрос на вытягивание в веб-браузере.
--org--organization
URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
--query-examples
Рекомендуемая строка JMESPath. Вы можете скопировать один из запросов и вставить его после --query параметра в двойных кавычках, чтобы просмотреть результаты. Вы можете добавить одно или несколько позиционных ключевых слов, чтобы предложения основывались на этих ключевых словах.
--subscription
Имя или идентификатор подписки Azure. Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.
Пример
В следующем примере показаны сведения о PR #21, показаны выходные данные команды в виде таблицы и открывается pr в браузере:
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Ознакомьтесь с ветвью
Используйте az repos pr checkout с обязательным --id параметром для локальной проверки ветви PR, если локальные изменения отсутствуют.
az repos pr checkout --id
[--remote-name]
[--subscription]
Параметры
Параметр
Описание
--id
Идентификатор запроса на вытягивание.
--remote-name
Имя удаленного git, в отношении которого вызывается PR. Значение по умолчанию: origin.
--subscription
Имя или идентификатор подписки Azure. Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.
Пример
Например, чтобы проверить ветвь для PR #21 локально, используйте следующую команду:
az repos pr checkout --id 21
Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server.
Чтобы просмотреть изменения, внести комментарии или предложения, или утвердить или проголосовать по pr, см. статью "Просмотр запросов на вытягивание".
Просмотр и обновление запросов на вытягивание с мобильного устройства
Вы можете использовать мобильные устройства для просмотра всех экранов PR Azure Repos и выполнения действий.
