끌어오기 요청 검토

Azure DevOps 서비스 | Azure DevOps Server | Azure DevOps Server 2022

pull 요청(PR)을 만들고 필수 및 선택적 검토자를 지정하는 경우 Azure Repos PR을 검토할 준비가 되었다는 것을 검토자에게 알깁니다. 변경 내용이 대상 분기에 병합되기 전에 모든 필수 검토자가 PR의 변경 내용을 승인해야 합니다. 같은 main중요한 분기를 변경하는 PR의 경우 팀에 검토자를 지정하거나 최소 수의 검토자가 필요한 분기 정책이 있을 수 있습니다. 분기 정책이 PR에 선택적 검토자를 추가하는 경우 해당 검토자를 유지하거나 요구하거나 제거할 수 있습니다. 분기 정책이 PR에 필요한 검토자를 추가하는 경우 선택적으로 만들거나 제거할 수 없습니다. 분기 정책을 통해 검토자를 할당하는 방법에 대한 자세한 내용은 자동으로 코드 검토자 포함을 참조 하세요.

PR을 검토할 때 정확하고 이해하기 쉬운 건설적인 피드백을 제공합니다. 자세한 내용은 풀 리퀘스트 피드백을(를) 참조하세요.

브라우저를 사용하여 웹 포털에서 Azure DevOps PR만 검토할 수 있습니다.

필수 조건

변경 내용 검토

끌어오기 요청을 사용하면 지정된 검토자가 해당 변경 내용이 대상 분기로 병합되기 전에 제안된 변경 내용을 검토, 논의 및 투표할 수 있습니다. 소스 브랜치와 대상 브랜치 모두에서 동일한 파일이 변경되면 병합 충돌이 발생할 수 있습니다. 충돌을 신중하게 분석하고 파일을 수동으로 편집하여 각 분기에서 올바른 변경 내용을 적용합니다. 원본에서만 변경하거나 한 번의 클릭으로 대상만 변경하면 필요한 변경 내용이 손실될 수 있습니다. Azure DevOps 또는 Visual Studio 같은 개발 도구에서 충돌을 해결할 수 있습니다.

자세한 내용은 병합 충돌 해결을 참조하세요.

Copilot 코드 검토 요청

GitHub Copilot에게 사람 검토자와 함께 풀 리퀘스트를 검토하도록 요청할 수 있습니다. Copilot 변경된 코드에 직접 의견과 제안을 게시하므로 사용자 검토자가 로그오프하기 전에 일반적인 문제를 해결할 수 있습니다.

검토를 요청하려면 끌어오기 요청을 열고 Reviewers 섹션에서 GitHub Copilot> 옆에 있는 request를 선택합니다. Copilot은 항상 Comment 검토를 남기므로 해당 피드백은 필수 검토자 정책을 충족하지 않으며 병합도 차단하지 않습니다.

이 기능은 제한된 공개 미리 보기로 제공되며 등록이 필요합니다. 설정, 청구 및 제한에 대해서는 끌어오기 요청용 Copilot 코드 검토 시작하기를 참조하세요.

사람 검토자로서 변경 사항 검토

다음 단계에서는 Azure Repos의 PR 검토자가 PR을 탐색하여 제안된 변경 내용을 이해하는 방법을 설명합니다.

1. 웹 브라우저에서 Azure DevOps 조직의 팀 프로젝트를 엽니다. Repos>Pull 요청을 선택하여 PR을 나열합니다. 새로 연 PR은 기본적으로 개요 탭으로 설정됩니다.

2. PR의 개요 탭에는 제목, 설명, 검토자, 연결된 작업 항목, 기록, 상태 및 메모가 표시됩니다. PR 설명을 읽어 제안된 변경 내용을 확인합니다. 다른 검토자가 제기한 문제를 이해하려면 주석을 봅니다.

   참고 항목

   각 파일은 변경 유형을 나타내기 위해 이름 옆에 "+" 기호 또는 "이름 바꾸기, 편집" 레이블로 표시됩니다. 파일이 50% 이상 변경되면 Git은 파일 이름을 변경한 것으로 간주합니다. 이 임계값은 Git 리포지토리의 기본값이며 변경할 수 없습니다.

   

3. 파일 탭을 선택하여 PR 원본 분기의 모든 콘텐츠 변경 내용을 검토합니다. 초기 보기에는 모든 파일 변경 내용에 대한 요약 보기가 표시됩니다. 파일 옆에 있는 보기 단추를 선택하여 해당 파일의 변경 내용만 봅니다. 파일이 수정된 경우 보기 단추가 diff 보기를 엽니다. 파일이 추가되거나 삭제된 경우 보기 단추가 콘텐츠 창을 엽니다.

   

   참고 항목

   성능상의 이유로 요약 보기에는 0.5MB보다 큰 파일에 대한 변경 내용이 표시되지 않습니다.

4. 파일의 차이 보기에서 나란히 또는 인라인 차이 레이아웃을 선택할 수 있습니다.

   

   팁

   5MB보다 큰 단일 파일의 경우 diff 보기에는 잘린 파일 콘텐츠가 표시됩니다. 전체 콘텐츠의 diff 보기를 보려면 로컬 diff 도구를 사용하여 이러한 파일을 다운로드하고 검토합니다.

   왼쪽 파일 트리를 사용하여 다른 파일을 보거나 파일 트리의 루트를 선택하여 모든 파일 변경 내용에 대한 요약 보기를 볼 수 있습니다.

5. 원본 분기에 대한 특정 푸시 에 의해 도입된 변경 집합을 검토하려면 변경 내용 드롭다운 목록에서 하나 이상의 변경 집합을 선택합니다. 하나 이상의 변경 집합을 선택하면 diff 보기가 업데이트되어 선택한 변경 집합의 변경 내용만 표시됩니다. 이 기능은 마지막 검토 이후 변경 내용이 PR에 푸시되고 새 변경 내용만 보려는 경우에 유용합니다. 변경 내용 드롭다운 목록은 각 푸시 작업의 최종 커밋에서 커밋 메시지 각 변경 집합의 이름을 지정합니다.

   

   팁

   변경 내용 드롭다운 목록에서 여러 변경 집합을 선택할 때 Shift 키를 누릅니다.

6. 업데이트 탭 을 선택하여 푸시된 모든 변경 집합을 보고 원본 분기 변경 내용을 놓치지 않았는지 확인합니다. 변경 집합 번호가 매겨지고 가장 최근의 변경 집합이 목록 맨 위에 표시됩니다. 각 변경 집합은 해당 푸시 작업에서 푸시된 커밋을 보여 줍니다. 강제 푸시된 변경 집합은 변경 집합 기록을 덮어쓰지 않으며 다른 변경 집합과 마찬가지로 변경 집합 목록에 표시됩니다.

   

7. 대상 분기에서 분기된 후 원본 분기의 커밋 기록을 보려면 커밋 탭을 선택합니다. PR 작성자가 다른 커밋 히스토리를 강제 푸시하면 Commits 탭의 커밋 기록이 덮어써지므로, Commits 탭에 표시된 커밋이 Updates 탭에 표시된 커밋과 다를 수 있습니다.

   

메모 사용

PR 작성자와 검토자는 PR 주석을 추가하고 응답하여 서로 통신할 수 있습니다. PR을 검토할 때 주석을 사용하여 제안된 변경 내용의 문제를 지적하고 , 변경 내용을 제안하고, 이전 의견에 응답합니다. 정확하고 이해하기 쉬운 건설적인 피드백을 목표로 합니다. @username를 사용하여 수신자를 직접 주소 지정합니다. #workitemID 및 !pullrequestID을 사용하여 작업 항목과 기타 PR을 참조합니다. 경우에 따라 PR 작성자는 설명서를 위해 직접 주석을 만듭니다.

의견에 피드백 제공

피드백이 파일의 특정 줄 또는 줄 범위에 적용되는 경우 파일 내의 해당 위치에 주석을 추가합니다.

1. PR의 파일 탭에서 댓글을 달려는 줄을 마우스로 가리키고 메모 단추를 선택하여 줄 주석 상자를 엽니다. 여러 줄을 선택한 다음 해당 줄을 마우스로 가리키면 나타나는 메모 단추를 선택할 수도 있습니다.

   

2. 댓글 상자에 댓글을 입력하고 댓글을 선택하세요.

   

피드백이 전체 파일에 적용되는 경우 파일 옵션 메뉴에서 메모 추가를 선택하여 파일 수준 주석을 추가합니다.

특정 파일과 관련이 없는 일반적인 피드백을 제공하려면 개요 탭에 메모를 추가합니다.

PR 검토자는 다음 섹션에 설명된 대로 주석을 사용하여 특정 파일 줄에 대한 변경 내용을 제안할 수도 있습니다.

메모의 변경 내용 제안

주석을 사용하여 파일에서 하나 이상의 줄에 대한 대체 텍스트를 제안합니다.

1. PR의 파일 탭에서 댓글을 달려는 줄을 마우스로 가리키고 메모 단추를 선택하여 줄 주석 상자를 엽니다. 여러 줄을 선택한 다음 해당 줄을 마우스로 가리키면 나타나는 메모 단추를 선택할 수도 있습니다. 허용되는 경우 제안된 콘텐츠는 메모가 추가된 줄 또는 줄을 바꿉니다.

   

2. 메모 상자에서 전구 아이콘을 선택하여 울타리친 코드 블록 내의 메모 상자에서 제안된 변경 내용을 적용한 다음 메모를 선택합니다. 나란히 표시되는 diff 보기의 원본 코드(왼쪽)에 주석을 추가하면 전구 아이콘이 표시되지 않습니다.

   

PR 작성자는 다음을 통해 제안을 수락할 수 있습니다.

1. 변경 내용을 커밋할 준비로 준비하기 위해 변경 사항 적용을 선택합니다.

   

2. `모든 변경 내용 커밋을 선택하여 단계에 있는 모든 변경 내용을 커밋합니다.` PR 작성자는 변경 취소를 선택하여 제안의 단계를 해제할 수 있습니다.

   

메모 편집 또는 삭제

메모를 마우스로 가리키고 편집 또는 삭제 아이콘을 선택하여 메모를 편집 하거나 삭제 합니다.

댓글 좋아요

PR 작성자와 검토자는 댓글 위에 마우스를 놓고 엄지 손가락 위로 아이콘을 선택하여 자신의 의견이나 다른 사람의 의견을 좋아할 수 있습니다.

좋아요가 있는 댓글은 채워진 엄지손가락 아이콘과 좋아요 수를 표시합니다. 댓글을 좋아하는 사람들의 목록을 보려면 엄지 손가락 위로 마우스를 가져 주세요.

메모에 회신

PR 작성자는 의견에 회신하여 검토자가 피드백 및 제안을 처리하는 방법을 알려야 합니다.

1. 메모에 회신하려면 회신 작성 필드에 응답을 입력합니다. @username를 사용하여 수신자를 직접 주소 지정합니다. #workitemID 및 !pullrequestID을 사용하여 작업 항목과 기타 PR을 참조합니다.

   

2. 응답을 입력한 후 회신을 선택하고 응답이 최종적인 경우 확인 합니다. 그렇지 않으면 회신을 선택합니다.

   

   회신 및 해결을 선택하면 메모 상태가 해결됨으로 변경됩니다. PR 작성자는 다음 섹션에 설명된 대로 주석의 상태를 직접 변경할 수도 있습니다.

메모 상태 변경

새 주석은 활성 상태로 시작합니다. PR 작성자는 검토자 피드백 및 제안을 처리하는 방법을 나타내기 위해 검토 프로세스 중에 상태를 업데이트합니다. PR 작성자는 상태 드롭다운 목록에서 주석 상태를 선택할 수 있습니다.

• 활성: 새 메모의 기본 상태입니다.
• 보류 중: 이 주석의 문제가 검토 중이며 다른 것을 기다리고 있습니다.
• 해결됨: 이 주석의 문제가 해결되었습니다.
• 해결되지 않음: 이 주석의 문제는 언급되었지만 수정되지 않습니다.
• 닫힘: 이 주석의 토론이 닫힙니다.

PR 작성자 및 검토자는 다음 섹션에 설명된 대로 주석 상태를 필터링하여 PR 진행률을 추적할 수 있습니다.

메모 필터링

메모 필터 드롭다운 목록에서 필터 옵션을 선택하여 개요 탭에 표시되는 메모 또는 업데이트를 선택할 수 있습니다. 예를 들어, PR을 마지막으로 연 이후의 새 메모와 업데이트를 보려면 새 소식 필터 옵션을 선택하세요. 각 필터 옵션은 해당 범주에 대한 항목 수를 표시합니다.

파일 편집

편의를 위해 PR 작성자는 Azure Repos에서 직접 파일을 편집할 수 있습니다. 예를 들어 검토자의 제안된 코드 변경을 수락하고 다른 곳에서도 비슷한 변경을 수행할 수 있습니다.

1. Repos > 파일을 선택하고 PR 원본 분기를 선택하고 파일을 선택한 다음 Edit 선택합니다.

   

2. 편집기에서 변경한 다음 커밋을 선택하여 커밋 대화 상자를 엽니다.

   

3. 커밋 대화 상자에서 필요한 경우 커밋 메시지를 편집한 다음, 커밋을 선택하여 변경 내용을 푸시하고 커밋합니다.

   

검토된 파일을 추적하기

PR 검토자는 파일 옵션 메뉴에서 검토됨으로 표시를 선택하거나 파일 또는 폴더 옆에 있는 확인란을 선택하여 확인된 파일을 추적할 수 있습니다.

PR 변경에 투표

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

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의 경우 게시 를 선택하여 초안 상태를 제거하고 검토할 준비가 되도록 표시합니다.
• 포기: PR을 닫습니다. 중단된 PR의 경우 다시 활성화 를 선택하여 복원합니다.

자세한 내용은 끌어오기 요청 완료를 참조하세요.

다음 단계:

관련된 문서

• 끌어오기 요청에 대한 Copilot 코드 검토로 시작했습니다
• 풀 리퀘스트 업데이트 알림
• 끌어오기 요청 및 권한 정보