Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
              비주얼 스튜디오 2019 | 비주얼 스튜디오 2022
Azure Repos의 Git 리포지토리에서 코드 변경 내용을 검토하고 병합하기 위해 끌어오기 요청(PR)을 만듭니다. 팀 구성원과 관련자는 코드를 대상 분기에 병합하기 전에 변경 내용을 검토하고 피드백을 제공할 수 있습니다. 검토자는 변경 내용에 대해 주석을 달고 투표를 통해 코드를 승인하거나 거부할 수도 있습니다.
팀은 보호된 브랜치에서의 변경 사항에 PR을 요구할 수 있으며, 특정 PR이 특정 조건을 충족하도록 브랜치 정책를 설정할 수 있습니다.
프로젝트에 대한 PR을 나열, 필터링, 보기 및 여는 방법에는 여러 가지가 있습니다.
필수 구성 요소
| 범주 | 요구 사항 | 
| 프로젝트 액세스 | 프로젝트멤버입니다. | 
| 권한 | - 프라이빗 프로젝트에서 코드 보기: 최소 기본 액세스. - 프라이빗 프로젝트의 코드 복제 또는 기여: 기여자 보안 그룹 또는 프로젝트의 해당 사용 권한의 구성원입니다.
 - 분기 또는 리포지토리 사용 권한 설정: 분기 또는 리포지토리에 대한 사용 권한 사용 권한 관리
 - 기본 분기 변경: 리포지토리의 권한을 편집할 정책
 - 리포지토리 가져오기: 프로젝트 관리자 보안 그룹의 구성원이나 Git 프로젝트 수준에서 '리포지토리 생성' 권한이 '허용'으로 설정된 경우. 자세한 내용은 Git 리포지토리 권한 설정을 참조 하세요.
 | 
| 서비스 | 리포지토리 활성화. | 
| 도구 | 선택 사항. 
              az repos 명령을 사용합니다. Azure DevOps CLI. | 
메모
퍼블릭 프로젝트에서 이해 관계자 액세스 권한이 있는 사용자는 코드 보기, 복제 및 기여를 포함하여 Azure Repos에 대한 모든 권한을 갖습니다.
 
 
| 범주 | 요구 사항 | 
| 프로젝트 액세스 | 프로젝트멤버입니다. | 
| 권한 | - 코드 보기: 최소 기본 액세스. - 코드 복제 또는 기여: 기여자 보안 그룹의 구성원이거나 프로젝트에서 해당 권한을 가진 경우.
 | 
| 서비스 | 리포지토리 활성화. | 
 
끌어오기 요청 나열
Azure DevOps 프로젝트 웹 사이트, Visual Studio 또는 Azure DevOps 명령줄을 사용하여 PR을 나열할 수 있습니다.
- 프로젝트의 특정 리포지토리에서 PR을 나열하려면, 웹 포털에서 해당 프로젝트  으로 이동하여, 리포지토리>에서끌어오기 요청을 선택합니다. - 
                
 
- 올바른 리포지토리를 선택했는지 확인합니다. - 
                
 
- 기본 보기는 마이닝 탭 아래에 있는 PR을 표시합니다. 활성 선택하여 현재 리포지토리에 대한 모든 활성 PR을 표시합니다. 
              완료된 또는 중단된을 선택하여 닫힌 PR 목록을 표시합니다. - 목록에서 PR을 선택하여 해당 PR의 개요 페이지로 이동합니다. - 
                
 
- 
              내 작업 보기에서 PR(끌어오기 요청)을 선택하여 조직의 여러 프로젝트에 대한 모든 PR을 나열할 수 있습니다. - 
                
 
 
Visual Studio에서 끌어오기 요청을 나열하려면 Git 메뉴에서 <를 선택하고 >를 클릭하십시오.
Visual Studio 2019 버전 16.8 이상 버전은 팀 탐색기 Git 사용자 인터페이스를 유지하면서 Git 버전 제어 환경을 제공합니다. 
              팀 탐색기사용하려면 메뉴 모음에서 도구>옵션>미리 보기 기능>새 Git 사용자 환경을 선택 취소합니다. 두 인터페이스에서 Git 기능을 서로 교환하여 연습할 수 있습니다.
Visual Studio 팀 탐색기에서 PR에 액세스하려면 다음을 수행합니다.
- 
              Visual Studio에서 프로젝트에 연결합니다. 
- 
              보기>팀 탐색기을 선택하여 팀 탐색기를 엽니다. 
              Ctrl+\을 누르거나, Ctrl+M을 누를 수도 있습니다. 
- 
              홈에서 풀 리퀘스트을 선택하여 사용자가 열거나 할당된 PR 목록을 봅니다. 
- Azure DevOps 웹 포털에서 PR 목록을 보려면 작업을 선택한 다음 브라우저에서 열기를 선택합니다. - 
                
 
프로젝트의 활성 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 | 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
 
Azure DevOps CLI 명령은 Azure DevOps Server에서 지원되지 않습니다.
 
 
사용자 지정 끌어오기 요청 뷰 정의
PR 목록을 필터링하면 워크플로에서 가장 중요한 파일의 우선 순위를 지정하는 PR을 찾고 구성할 수 있습니다.
PR 목록을 필터링하려면 풀 리퀘스트 페이지에서 오른쪽 위에 있는 필터 아이콘을 선택합니다. 그런 다음 대상 분기 또는 다른 열 머리글을 선택하고 필터링할 분기 또는 기타 값을 선택합니다.
PR 목록 보기를 추가로 사용자 지정하려면 풀 리퀘스트 페이지에서 오른쪽 위에 있는 보기 사용자 지정을 선택합니다.
               
              
            
              사용자 지정 보기 페이지에서 현재 보기 섹션을 다시 정렬하거나 편집하거나 제거할 수 있습니다. 새 섹션을 만들려면 섹션추가를 선택합니다.
               
              
            
              사용자 지정 섹션 페이지에서 값을 입력하고 선택하여 초안 상태 또는 업데이트된 날짜와 같은 매개 변수별로 섹션을 필터링합니다. 별도의 탭승인하거나 거부한 끌어오기 요청을 표시할지,이전 섹션에 포함된 끌어오기 요청(중복)을 제외할지 선택할 수 있습니다. 보기 사용자 지정을 마치면 저장을 선택합니다.
               
              
            
이러한 사용자 지정 보기는 끌어오기 요청 페이지에 축소 가능한 별도의 섹션을 만듭니다. 조직 홈페이지의 내 끌어오기 요청 탭에서 이러한 사용자 지정 쿼리는 여러 리포지토리에서도 작동합니다.
               
              
            
사용자 지정된 보기의 매개 변수를 변경하려면 보기 옆에 있는  사용자 지정 단추를 선택합니다. 또는 사용자 지정 보기을 선택하고, 사용자 지정 보기 화면에서 변경할 보기를 선택합니다. "일부 보기는 할당됨과 같이 사용자 지정할 수 없지만, 다시 정렬하거나 제거할 수 있습니다."
 
PR 파일 탭에서 여러 필터를 사용하여 빠른 검토를 위해 파일 및 메모를 선택할 수 있습니다. 
              필터선택한 다음 옵션 중에서 선택합니다.
               
              
            
- 키워드: 키워드를 입력합니다.
- 검토됨/검토되지 않은 경우: 모두(기본값), 보류 중인, 검토된.
- 주석이 추가된 파일: 모든 파일 (기본값), 주석이 있는 파일 .
- 설명:  표시(기본값), 새로운 것, 숨기기.
- 주석 상태: 활성(기본값), 보류 중인, 해결된, 디자인된, 수정하지 않음, 닫힌.
- 댓글 작성자: 모든 댓글(기본값) 또는 특정 사용자.
검색 필드에 문자열을 입력하여 이전 옵션에서 일치하는 결과를 표시할 수도 있습니다.
 
Visual Studio에서 끌어오기 요청을 필터링하려면 다음을 수행합니다.
- 
              Git 메뉴에서 Git 서비스 <>>끌어오기 요청 보기선택합니다. 
- 
              Author, Label또는 기타 특성에 따라 필터링하세요. 
Team Explorer 끌어오기 요청 보기에서:
- 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
 
Azure DevOps CLI 명령은 Azure DevOps Server에서 지원되지 않습니다.
 
 
끌어오기 요청 열기
브라우저, Visual Studio 또는 Azure CLI에서 PR을 열면 PR 개요 페이지가 브라우저에서 열립니다.
브라우저에서 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 사용합니다. 브라우저에서 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 명령을 사용하여 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>사용하여 기본 구독을 구성할 수 있습니다. | 
예시
예를 들어 PR #21에 대한 브랜치를 로컬로 확인하려면 다음을 사용하세요.
az repos pr checkout --id 21
 
Azure DevOps CLI 명령은 Azure DevOps Server에서 지원되지 않습니다.
 
 
변경 내용을 검토하거나 의견 또는 제안을 남기고, PR을 승인하거나 투표하려면 끌어오기 요청 검토을 참조하세요.
모바일 디바이스에서 끌어오기 요청 보기 및 업데이트
모바일 디바이스를 사용하여 모든 Azure Repos PR 화면을 보고 작업을 수행할 수 있습니다.
               
              
            
다음 단계
관련 문서