머지 리퀘스트 리뷰 프로세스는 제안된 변경 사항이 머지되기 전에 주제 전문가들이 검토하도록 합니다. 리뷰어는 머지 리퀘스트에 리뷰 댓글을 추가하고, 작성자가 GitLab UI에서 직접 적용할 수 있는 변경 제안을 할 수 있습니다.

리뷰어는 다음 도구 중 하나를 사용하여 머지 리퀘스트를 검토할 수 있습니다:

• GitLab 인터페이스.
• GitLab for VS Code 확장이 설치된 Visual Studio Code.
• GitLab CLI가 설치된 터미널 창.

승인은 머지 리퀘스트가 진정으로 준비되었을 때만 머지되도록 하는 여러 머지 검사 중 하나입니다. 프로젝트 구성에 따라 리뷰어는 Request changes를 설정하여 머지 리퀘스트 머지를 차단할 수도 있습니다.

GitLab Premium 및 Ultimate는 승인 규칙을 충족하는 리뷰어를 찾는 데 도움이 되는 추가 정보가 포함된 Assign reviewers 드로어를 제공합니다:

정의된 리뷰 흐름을 따르면 각 리뷰어는 머지 리퀘스트를 수락 또는 거부할지 결정합니다. 오른쪽 사이드바는 리뷰어 목록과 (리뷰 흐름을 따르는 경우) 리뷰 상태를 표시합니다:

• [dash-circle] 아직 리뷰가 시작되지 않음.
• [status_running] 리뷰 진행 중.
• [check-circle] 검토하고 승인함.
• [comment-lines] 검토하고 변경 요청을 하였으며 변경 사항이 이루어질 때까지 이 머지 리퀘스트를 차단함. 이 차단은 우회할 수 있습니다.

개요는 머지 리퀘스트 리뷰 비디오를 참조하세요.

검토할 머지 리퀘스트 찾기#

머지 리퀘스트 홈페이지에는 진행 중인 머지 리퀘스트와 리뷰를 기다리는 머지 리퀘스트가 표시됩니다. 리뷰해야 할 머지 리퀘스트는 Review requested 범주에 있습니다. 주의가 필요한 모든 머지 리퀘스트를 보려면 다음 방법 중 하나를 사용합니다:

• Shift+m 키보드 단축키를 누릅니다.
• 왼쪽 사이드바에서 Merge requests ([merge-request])를 선택합니다.
• 상단 표시줄에서 Search or go to를 선택하고 드롭다운 목록에서 Merge requests I'm working on을 선택합니다.

머지 리퀘스트의 리뷰 상태 보기#

다음을 수행하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 왼쪽 사이드바에서 Code > Merge requests를 선택하고 머지 리퀘스트를 찾습니다.

3. 머지 리퀘스트 제목을 선택하여 봅니다.

4. 머지 리퀘스트 위젯으로 스크롤하여 머지 리퀘스트의 머지 가능성 및 승인 상태를 봅니다. 예를 들어 필요한 승인의 부재가 이 머지 리퀘스트를 차단합니다:

   

리뷰 요청#

히스토리

• Assign reviewers 드로어가 GitLab 17.5에서 reviewer_assign_drawer라는 플래그를 사용하여 도입됨.
• 드로어가 GitLab 17.5에서 GitLab.com 및 GitLab Self-Managed에서 활성화됨.
• 기능 플래그 reviewer_assign_drawer가 GitLab 17.8에서 제거됨.

변경 사항 준비가 완료되면 리뷰를 요청할 시간입니다. 머지 리퀘스트에 리뷰어를 할당하려면 텍스트 필드에서 /assign_reviewer 빠른 액션을 사용하거나 다음을 수행합니다:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Code > Merge requests를 선택하고 머지 리퀘스트를 찾습니다.
3. 머지 리퀘스트 제목을 선택하여 봅니다.
4. 이름으로 리뷰어를 찾으려면: 오른쪽 사이드바의 Reviewers 섹션에서 Edit를 선택합니다.
5. GitLab Premium 및 Ultimate에서 승인 규칙을 충족하는 리뷰어를 찾으려면:
   1. 오른쪽 사이드바의 Reviewers 섹션에서 Assign을 선택하여 Assign reviewers 드로어를 엽니다.
   2. 각 승인 규칙에 대해 Edit를 선택하여 해당 승인 규칙을 충족하는 리뷰어를 찾습니다.

GitLab은 사용자의 리뷰 요청에 머지 리퀘스트를 추가합니다.

승인 규칙을 충족하는 리뷰어 찾기#

GitLab Premium 및 Ultimate는 머지 리퀘스트에 가장 적합한 리뷰어를 더 빠르게 찾는 데 도움을 줍니다. Assign reviewers 드로어를 사용하여 리뷰어 목록을 필터링합니다. 머지 리퀘스트에서 변경된 파일의 Code Owner와 프로젝트 승인 규칙을 충족하는 사용자를 확인합니다.

이 예시에서 머지 리퀘스트는 3개의 Code Owner 승인이 필요하지만 아직 없습니다:

머지 리퀘스트에서 적격한 승인자를 할당하려면:

1. Reviewers 섹션에서 Assign을 선택합니다.
2. 선택적 승인 규칙 또는 Code Owner를 보려면 Optional approval rules ([chevron-lg-up])를 선택합니다.
3. 필요한 리뷰어 유형 옆에서 Edit를 선택합니다:
   • Code Owners는 해당 파일 유형의 Code Owner만 표시합니다.
   • Approval rules는 해당 승인 규칙을 충족하는 사용자만 표시합니다.
4. 원하는 리뷰어를 선택합니다. (GitLab Premium 및 Ultimate에서는 두 명 이상의 리뷰어를 선택할 수 있습니다.)
5. 각 필수 Code Owner 및 Approval rule 항목에 대해 반복합니다.
6. 리뷰어를 선택했으면 오른쪽 상단에서 Close (✗)를 선택하여 Assign reviewers 드로어를 숨깁니다.

리뷰 재요청#

리뷰어가 머지 리퀘스트 리뷰를 완료한 후 머지 리퀘스트 작성자는 리뷰어에게 새 리뷰를 요청할 수 있습니다. 이를 위해 머지 리퀘스트의 텍스트 필드에서 /request_review @user 빠른 액션을 사용하거나 다음을 수행합니다:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Code > Merge requests를 선택하고 머지 리퀘스트를 찾습니다.
3. 머지 리퀘스트 제목을 선택하여 봅니다.
4. 머지 리퀘스트에서 오른쪽 사이드바를 접어 둔 경우 [chevron-double-lg-left] Expand Sidebar를 선택하여 펼칩니다.
5. Reviewers 섹션에서 리뷰어 이름 옆의 Re-request a review 아이콘 ([redo])을 선택합니다.

GitLab은 리뷰어를 위해 새 할 일 항목을 생성하고 알림 이메일을 보냅니다.

리뷰 시작#

히스토리

• Assign reviewers 드로어가 GitLab 17.11에서 improved_review_experience라는 플래그를 사용하여 도입됨. 기본적으로 비활성화.
• Assign reviewers 드로어가 GitLab 18.1에서 기본으로 활성화됨.

머지 리퀘스트를 검토할 때 개별 댓글을 남기는 대신 리뷰 프로세스를 따릅니다. Start a review를 선택하면 오른쪽 사이드바의 Reviewers 섹션이 상태를 Awaiting review ([dash-circle])에서 Reviewer started review ([comment-dots])로 업데이트합니다.

머지 리퀘스트 리뷰를 시작하려면:

1. 다음 중 하나를 수행합니다:

   • Shift+r을 눌러 Merge requests 페이지로 이동합니다.
   • 오른쪽 상단에서 Merge requests ([merge-request])를 선택합니다.

2. 머지 리퀘스트를 찾고 머지 리퀘스트 제목을 선택하여 봅니다.

3. 머지 리퀘스트 설명과 댓글을 읽어 머지 리퀘스트에 대해 파악합니다.

4. Changes를 선택하여 제안된 변경 사항의 diff를 봅니다. Changes 페이지에 대한 자세한 내용은 머지 리퀘스트의 변경 사항을 참조하세요.

5. 필요에 따라 여러 줄 또는 단일 줄 변경을 제안합니다. 첫 번째 리뷰 댓글을 저장할 준비가 되면 Start a review를 선택하여 다음을 수행합니다:

   • 오른쪽 사이드바의 상태를 Reviewer started review ([comment-dots])로 업데이트합니다.

   • 리뷰 댓글을 저장하되 게시되지 않은 상태로 남겨둡니다:

     

   Start a review 대신 Add comment now를 선택하면 GitLab이 즉시 댓글을 게시합니다.

6. Changes 탭 또는 Overview 탭에서 계속 리뷰 댓글을 작성합니다. Add to review를 선택하면 리뷰를 제출할 때까지 게시되지 않은 상태로 유지됩니다:

   

다음으로 리뷰를 제출합니다.

댓글로 스레드 해결 또는 다시 열기#

댓글은 댓글 스레드를 해결하거나 다시 열 수도 있습니다. 댓글에 답글을 달 때 스레드를 해결하거나 다시 열려면:

1. 댓글 텍스트 영역에 댓글을 작성합니다.
2. Resolve thread 또는 Reopen thread를 선택하거나 지웁니다.
3. Add comment now 또는 Add to review를 선택합니다.

보류 중인 댓글은 지연된 작업에 대한 정보를 표시합니다. 이러한 작업은 리뷰를 제출할 때 실행됩니다.

리뷰 제출#

히스토리

• Approve를 사용하여 보류 중인 리뷰 댓글을 제출하는 기능이 GitLab 18.6에서 도입됨.

리뷰를 제출하면 GitLab이 다음을 수행합니다:

• 리뷰의 댓글을 게시합니다.
• 리뷰 댓글이 첨부된 단일 이메일을 머지 리퀘스트의 모든 알림 대상 사용자에게 보냅니다. 이 이메일에 답글을 달면 머지 리퀘스트에 새 댓글이 생성됩니다.
• 리뷰 댓글에 추가한 빠른 액션을 수행합니다.
• 리뷰 결과를 표시합니다.

머지 리퀘스트 리뷰를 빠르게 제출하려면:

• 머지 리퀘스트 위젯으로 이동하여 Approve를 선택합니다. 머지 리퀘스트도 승인됩니다.
• 비리뷰 댓글 텍스트에서 /submit_review 빠른 액션을 사용합니다.

리뷰를 제출할 때 리뷰 댓글을 읽고 편집하려면:

1. 오른쪽 상단에서 Your review를 선택하여 리뷰에 대한 세부 정보를 표시합니다:

   

2. 보류 중인 댓글을 검토합니다. 필요에 따라 편집합니다.

3. 리뷰 결과를 선택합니다.

   • Approve: 피드백을 남기고 변경 사항을 승인합니다.
   • Comment: 명시적인 승인이나 변경 요청 없이 일반적인 피드백을 남깁니다.
   • Request changes: 작성자가 피드백을 해결할 때까지 머지 리퀘스트 머지를 차단합니다.

4. 선택 사항. 리뷰 요약을 작성합니다. GitLab Premium 및 Ultimate 사용자는 Add summary ([tanuki-ai])를 선택하여 자동으로 요약을 생성할 수 있습니다. 수행하려는 빠른 액션을 포함합니다.

보류 중인 리뷰 취소#

리뷰를 취소하면 게시되지 않은 댓글이 삭제되고 복원할 수 없습니다. 다음을 수행하려면:

1. 오른쪽 상단에서 Your review를 선택하여 리뷰에 대한 세부 정보를 표시합니다:

   

2. Discard review를 선택합니다.

변경을 요청할 때 머지 방지#

히스토리

• GitLab 16.11에서 mr_reviewer_requests_changes라는 플래그를 사용하여 도입됨. 기본적으로 비활성화.
• GitLab 17.2에서 GitLab.com 및 GitLab Self-Managed에서 기본으로 활성화.
• GitLab 17.3에서 기능 플래그 제거됨.

변경을 요청하는 리뷰어는 머지 리퀘스트 머지를 차단합니다. 이 경우 머지 리퀘스트 보고서 영역에 Change requests must be approved by the requesting user 메시지가 표시됩니다. 머지 리퀘스트 차단을 해제하려면 변경을 요청한 리뷰어가 머지 리퀘스트를 재검토하고 승인해야 합니다.

변경 요청 제거#

히스토리

• GitLab 17.8에서 도입됨.

이전에 변경을 요청한 경우 변경 요청을 제거할 수 있습니다. 다음 두 가지 모두에 해당하는 경우 이 작업이 필요할 수 있습니다:

• 더 이상 머지 리퀘스트를 승인할 수 없습니다.
• 변경 요청을 취소하고 싶지만 새 리뷰를 제출하고 싶지 않습니다.

새 리뷰를 제출하지 않고 변경 요청을 제거하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 왼쪽 사이드바에서 Code > Merge requests를 선택하고 머지 리퀘스트를 찾습니다.

3. 머지 리퀘스트 제목을 선택하여 봅니다.

4. 머지 리퀘스트 Overview에서 머지 리퀘스트 보고서 영역으로 스크롤합니다.

5. Change requests must be approved by the requesting user 옆에서 Remove를 선택합니다:

   

변경 요청 우회#

변경을 요청한 사용자가 재검토하거나 승인할 수 없는 경우 머지 리퀘스트를 머지할 권한이 있는 다른 사용자가 이 검사를 우회할 수 있습니다:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 왼쪽 사이드바에서 Code > Merge requests를 선택하고 머지 리퀘스트를 찾습니다.

3. 머지 리퀘스트 제목을 선택하여 봅니다.

4. 머지 리퀘스트 Overview에서 머지 리퀘스트 보고서 영역으로 스크롤합니다.

5. Change requests must be approved by the requesting user 옆에서 Bypass를 선택합니다:

   

6. 머지 보고서 영역에 Merge with caution: Override added가 표시됩니다. 사용자가 우회한 검사를 보려면 Expand merge checks ([chevron-lg-down])를 선택하고 경고 ([status_warning]) 아이콘이 포함된 검사를 찾습니다. 이 예시에서 작성자가 Change requests must be approved by the requesting user를 우회했습니다:

   

머지 리퀘스트 변경 다운로드#

머지 리퀘스트의 변경 사항을 diff 또는 패치 파일로 다운로드할 수 있습니다.

관련 기능#

머지 리퀘스트는 다음 기능과 관련이 있습니다:

• 변경 사항 체리픽: GitLab UI에서 머지된 머지 리퀘스트 또는 커밋에서 Cherry-pick을 선택하여 체리픽합니다.
• 변경 사항 비교: 머지 리퀘스트에 포함된 변경 사항의 diff를 보고 다운로드합니다.
• 빠른 포워드 머지 리퀘스트: 선형 Git 히스토리를 위해 머지 커밋을 생성하지 않고 머지 리퀘스트를 수락합니다.
• 변경을 도입한 머지 리퀘스트 찾기: 커밋 세부 정보 페이지를 볼 때 GitLab은 해당 커밋이 포함된 머지 리퀘스트에 링크합니다.
• 머지 리퀘스트 버전: 머지 리퀘스트 diff의 다양한 버전 선택 및 비교.
• 충돌 해결: GitLab은 GitLab UI에서 특정 머지 리퀘스트 충돌을 해결하는 옵션을 제공할 수 있습니다.
• 변경 사항 되돌리기: 머지 리퀘스트의 모든 커밋에서 변경 사항을 되돌립니다.
• 키보드 단축키: 키보드 명령으로 머지 리퀘스트의 특정 부분에 액세스하고 변경합니다.
• Value stream 분석: 소프트웨어 개발 라이프사이클에서 팀이 가장 많은 시간을 보내는 곳을 식별하기 위해 주요 머지 리퀘스트 단계(예: reviewed 및 approved)를 추적합니다. 이 정보는 그룹 및 프로젝트에 대한 머지 리퀘스트 워크플로를 최적화하고 개발자 생산성을 향상시키기 위한 실행 가능한 인사이트를 발견하는 데 도움이 됩니다. 블로그 게시물에서 value stream 분석으로 MR 리뷰 시간을 단축한 방법에 대해 자세히 읽어보세요.

관련 항목#

• 머지 리퀘스트의 변경 사항 비교
• 리비전 비교
• 머지 방법
• Draft Notes API