Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Azure Repos의 Git 리포지토리에서 코드 변경 내용을 검토하고병합하기 위한 끌어오기 요청(PR)을 만듭니다. 팀 구성원과 관련자는 코드를 대상 분기에 병합하기 전에 변경 내용을 검토하고 피드백을 제공할 수 있습니다. 검토자는 변경 내용에 대해 주석을 달고 투표를 통해 코드를 승인하거나 거부할 수도 있습니다.
Teams는 보호된 분기 변경에 대해 PR을 요구하고 특정 PR이 특정 기준을 충족하도록 분기 정책을 설정할 수 있습니다.
Azure DevOps Services에서 확장을 사용하여 Azure CLI(명령줄 인터페이스)에서 PR 및 기타 리소스를 azure-devops 관리할 수 있습니다. 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을 나열할 수 있습니다.
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, allcompleted.
--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 서비스>>보기 끌어오기 요청을 선택합니다.<
작성자, 레이블 또는 기타 특성별로 필터링합니다.
팀 탐색기 끌어오기 요청 보기에서 :
PR 상태 또는 할당별로 PR 목록을 필터링하려면 활성 또는 내 팀에 할당됨을 선택합니다.
또는 여기에 형식을 입력하여 목록 필드를 필터링하여 날짜, 작성자, 분기 또는 기타 특성을 기준으로 PR 목록을 필터링합니다.
여러 az repos pr list 매개 변수를 사용하여 PR 목록(예: --creator,--project, --repository, --reviewer--source-branch, --status--target-branch및 --top)을 필터링할 수 있습니다.
및 --reviewer 값은 --creator 이름 또는 전자 메일 주소를 표시할 수 있습니다. 매개 변수는 --top 나열할 최대 PR 수를 정의합니다.
예를 들어, 해당 상태에 관계없이 마지막으로 만든 PR에 대한 세부 정보를 나열하려면 다음을 사용합니다.
az repos pr list --creator "My Name" --status all --top 1
브라우저에서 PR을 열려면 끌어오기 요청 페이지의 목록에서 PR을 선택합니다. PR이 개요 탭으로 열립니다. 개요 탭에는 PR 제목, 설명, 검토자, 연결된 작업 항목, 기록 및 상태가 표시됩니다. 통과하거나 실패하는 분기 정책의 요약을 볼 수 있으며 검토자가 작성한 의견을 볼 수 있습니다.
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 및 팀 탐색기의 나란히 비교를 참조하세요.
단일 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>기본 구독을 구성할 수 있습니다.