Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
검토하고 Azure ReposGit 리포지토리에서 코드 변경 내용을 병합할 끌어오기 요청(PR)을 만듭니다. 팀 구성원과 관련자는 코드를 대상 분기에 병합하기 전에 변경 내용을 검토하고 피드백을 제공할 수 있습니다. 검토자는 변경 내용에 대해 주석을 달고 투표를 통해 코드를 승인하거나 거부할 수도 있습니다.
팀은 보호된 브랜치에서의 변경 사항에 PR을 요구할 수 있으며, 특정 PR이 특정 조건을 충족하도록 브랜치 정책를 설정할 수 있습니다.
프로젝트에 대한 PR을 나열, 필터링, 보기 및 여는 방법에는 여러 가지가 있습니다.
필수 구성 요소
리포 프로젝트에서 활성화되어야 합니다.
리포지토리 허브 및 관련 페이지가 표시되지 않는 경우, Azure DevOps 서비스 설정 또는 해제를 참조하여 저장소를 다시 활성화하세요.
PR을 보려면, PR이 포함된 Azure DevOps 프로젝트의 구성원이 되어야 하며 최소한 Basic 액세스 권한이 필요합니다. 프로젝트 멤버가 아닌 경우, 가에 추가됩니다.
메모
퍼블릭 프로젝트의 경우 이해 관계자 액세스 권한이 부여된 사용자는 Azure Repos에 대한 모든 권한을 가 갖습니다.
Azure DevOps Services에서 azure-devops 확장을 사용하여 Azure CLI(명령줄 인터페이스) PR 및 기타 리소스를 관리할 수 있습니다. Azure DevOps Services CLI를 사용하는 방법을 알아보려면 Azure DevOps CLI 시작하기를 참조하세요. PR용 Azure Repos CLI 명령은 az repos pr사용합니다.
끌어오기 요청 나열
Azure DevOps 프로젝트 웹 사이트, Visual Studio 또는 Azure DevOps 명령줄을 사용하여 PR을 나열할 수 있습니다.
프로젝트의 특정 리포지토리에서 PR을 나열하려면, 웹 포털에서 해당 프로젝트 으로 이동하여, 리포지토리>에서끌어오기 요청을 선택합니다.
올바른 리포지토리를 선택했는지 확인합니다.
기본 보기는 마이닝 탭 아래에 있는 PR을 표시합니다. 활성 선택하여 현재 리포지토리에 대한 모든 활성 PR을 표시합니다.
완료된 또는 중단된을 선택하여 닫힌 PR 목록을 표시합니다.
목록에서 PR을 선택하여 해당 PR의 개요 페이지로 이동합니다.
내 작업 보기에서 PR(끌어오기 요청)을 선택하여 조직의 여러 프로젝트에 대한 모든 PR을 나열할 수 있습니다.
Visual Studio의 끌어오기 요청을 나열하려면 Git 메뉴에서 Git 서비스 <>>끌어오기 요청봅니다.
Visual Studio 2019 버전 16.8 이상 버전은 팀 탐색기 Git 사용자 인터페이스를 유지하면서 Git 버전 제어 환경을 제공합니다.
팀 탐색기사용하려면 메뉴 모음에서 도구>옵션>미리 보기 기능>새 Git 사용자 환경을 선택 취소합니다. 두 인터페이스에서 Git 기능을 서로 교환하여 연습할 수 있습니다.
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
Azure DevOps 조직 URL입니다.
az devops configure -d organization=<ORG_URL>사용하여 기본 조직을 구성할 수 있습니다.
기본값으로 구성되거나 git 구성을 통해 선택되지 않은 경우 필수. 예: https://dev.azure.com/MyOrganizationName/.
--project-p
프로젝트의 이름 또는 ID입니다.
az devops configure -d project=<NAME_OR_ID>사용하여 기본 프로젝트를 구성할 수 있습니다.
기본값으로 구성되거나 git 구성을 통해 선택되지 않은 경우 필수입니다.
--query-examples
권장되는 JMESPath 문자열입니다. 쿼리 중 하나를 복사하고 --query 매개 변수 뒤를 큰따옴표로 붙여넣어 결과를 볼 수 있습니다. 이러한 키워드를 기반으로 제안할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.
--repository-r
리포지토리의 이름 또는 ID입니다.
--reviewer
이 사용자가 검토자인 풀 리퀘스트로 결과를 제한합니다.
--skip
건너뛸 끌어오기 요청 수입니다.
--source-branch-s
이 소스 브랜치에서 시작된 끌어오기 요청으로 결과를 한정합니다.
--status
이 상태의 끌어오기 요청으로 결과를 제한합니다. 허용되는 값: abandoned, active, all, completed.
--subscription
Azure 구독의 이름 또는 ID입니다.
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
PR 목록을 필터링하려면 풀 리퀘스트 페이지에서 오른쪽 위에 있는 필터 아이콘을 선택합니다. 그런 다음 대상 분기 또는 다른 열 머리글을 선택하고 필터링할 분기 또는 기타 값을 선택합니다.
PR 목록 보기를 추가로 사용자 지정하려면 풀 리퀘스트 페이지에서 오른쪽 위에 있는 보기 사용자 지정을 선택합니다.
사용자 지정 보기 페이지에서 현재 보기 섹션을 다시 정렬하거나 편집하거나 제거할 수 있습니다. 새 섹션을 만들려면 섹션추가를 선택합니다.
사용자 지정 섹션 페이지에서 값을 입력하고 선택하여 초안 상태 또는 업데이트된 날짜와 같은 매개 변수별로 섹션을 필터링합니다. 별도의 탭승인하거나 거부한 끌어오기 요청을 표시할지,이전 섹션에 포함된 끌어오기 요청(중복)을 제외할지 선택할 수 있습니다. 보기 사용자 지정을 마치면 저장을 선택합니다.
이러한 사용자 지정 보기는 끌어오기 요청 페이지에 축소 가능한 별도의 섹션을 만듭니다. 조직 홈페이지의 내 끌어오기 요청 탭에서 이러한 사용자 지정 쿼리는 여러 리포지토리에서도 작동합니다.
사용자 지정된 보기의 매개 변수를 변경하려면 보기 옆에 있는 사용자 지정 단추를 선택합니다. 또는 사용자 지정 보기을 선택하고, 사용자 지정 보기 화면에서 변경할 보기를 선택합니다. 할당된 같은 일부 보기는 사용자 지정할 수 없지만 다시 정렬하거나 제거할 수 있습니다.
PR 파일 탭에서 여러 필터를 사용하여 빠른 검토를 위해 파일 및 메모를 선택할 수 있습니다.
필터선택한 다음 옵션 중에서 선택합니다.
키워드: 키워드를 입력합니다.
검토됨/검토되지 않은 경우: 모두(기본값), 보류 중인, 검토된.
주석이 추가된 파일: 모든 파일 (기본값), 주석이 있는 파일 .
설명: 표시(기본값), 새로운 것, 숨기기.
주석 상태: 활성(기본값), 보류 중인, 해결된, 디자인된, 수정하지 않음, 닫힌.
댓글 작성자: 모든 댓글(기본값) 또는 특정 사용자.
검색 필드에 문자열을 입력하여 이전 옵션에서 일치하는 결과를 표시할 수도 있습니다.
Visual Studio에서 끌어오기 요청을 필터링하려면 다음을 수행합니다.
Git 메뉴에서 Git 서비스 <>>끌어오기 요청 보기선택합니다.
Author, Label또는 기타 특성에 따라 필터링하세요.
팀 탐색기 끌어오기 요청 보기에서:
PR 목록을 PR 상태별로 필터링하려면 활성을 선택하거나, 할당별로 필터링하려면 나에게 또는 내 팀에게할당됨을 선택합니다.
또는 여기에 형식을 입력하여 목록 필드를 필터링하여 날짜, 작성자, 분기 또는 기타 특성을 기준으로 PR 목록을 필터링합니다.
여러 az repos pr list 매개 변수를 사용하여 --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branch및 --top등의 PR 목록을 필터링할 수 있습니다.
--creator 및 --reviewer 값은 이름 또는 전자 메일 주소를 표시할 수 있습니다.
--top 매개 변수는 나열할 최대 PR 수를 정의합니다.
예를 들어, 해당 상태에 관계없이 마지막으로 만든 PR에 대한 세부 정보를 나열하려면 다음을 사용합니다.
az repos pr list --creator "My Name" --status all --top 1
브라우저에서 PR을 열기 위해서는 끌어오기 요청 페이지의 목록에서 PR을 선택합니다. PR이 개요 탭으로 열립니다. 개요 탭에는 PR 제목, 설명, 검토자, 연결된 작업 항목, 기록 및 상태가 표시됩니다. 브랜치 정책이 통과 중인지 실패 중인지 요약을 볼 수 있으며, 검토자가 남긴 의견도 확인할 수 있습니다.
P R 개요 탭을 보여 주는
PR 파일 탭에서 PR 파일의 실제 변경 내용을 검토할 수 있습니다.
업데이트 및 커밋 탭에서 작성자가 PR 분기를 업데이트하기 위해 변경한 내용을 볼 수 있습니다.
Visual Studio에서 끌어오기 요청을 열려면 Git 메뉴에서 Git 서비스끌어오기 요청선택한 다음 끌어오기 요청을 선택하여 엽니다.
또는 팀 탐색기 의 끌어오기 요청 보기에서 PR을 마우스 오른쪽 버튼으로 클릭하고 브라우저에서 열기를 선택하여 웹 포털에서 PR을 엽니다.
지점을 둘러보세요
Visual Studio 2019에서는 끌어오기 요청 보기에서 PR의 원본 분기를 직접 확인할 수 있습니다. PR을 마우스 오른쪽 단추로 클릭하고 체크 아웃 원본 분기선택합니다.
체크아웃 소스 분기를 보여주는 스크린샷
메모
Visual Studio 2019 버전 16.8 이상 버전에서는 팀 탐색기보다 컨텍스트 전환이 적은 Git 워크플로를 관리하기 위한 새 Git 메뉴를 제공합니다. Visual Studio 탭 아래의 이 문서에 제공된 절차는 팀 탐색기뿐만 아니라 Git 환경을 사용하기 위한 정보를 제공합니다. 자세한 내용은 Git 및 Team Explorer의 나란히 비교를참조하세요.
단일 PR에 대한 세부 정보를 표시하려면 필요한 --id 매개 변수와 함께 az repos pr show 사용합니다. 브라우저에서 PR을 열려면 --open을 사용하십시오.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
매개 변수
매개 변수
묘사
--id
끌어오기 요청의 ID입니다.
필수.
--detect
조직을 자동으로 검색합니다. 허용되는 값: false, true.
--open
웹 브라우저에서 끌어오기 요청을 엽니다.
--org--organization
Azure DevOps 조직 URL입니다.
az devops configure -d organization=<ORG_URL>사용하여 기본 조직을 구성할 수 있습니다.
기본값으로 구성하지 않았거나 git 구성을 통해 선택되지 않은 경우 필수입니다. 예: https://dev.azure.com/MyOrganizationName/.
--query-examples
추천된 JMESPath 문자열입니다. 쿼리 중 하나를 복사하고 --query 매개 변수 뒤를 큰따옴표로 붙여넣어 결과를 볼 수 있습니다. 이러한 키워드를 기반으로 제안할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.
--subscription
Azure 구독의 이름 또는 ID입니다.
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
지점 확인
로컬에 변경 사항이 없는 경우 필요한 매개 변수 --id와 함께 az repos pr checkout 명령을 사용하여 PR 분기를 로컬에 체크아웃하십시오.
az repos pr checkout --id
[--remote-name]
[--subscription]
매개 변수
매개 변수
설명
--id
끌어오기 요청의 ID입니다.
--remote-name
PR이 제출되는 git 원격의 이름입니다. 기본값: origin.
--subscription
Azure 구독의 이름 또는 ID입니다.
az account set -s <NAME_OR_ID>사용하여 기본 구독을 구성할 수 있습니다.
