자동 리뷰어 지정을 활성화하면 GitLab이 변경된 파일의 Code Owners를 머지 리퀘스트의 리뷰어로 지정합니다. CODEOWNERS 파일에서 리뷰어를 직접 고르지 않아도 됩니다.

사전 요구 사항#

• 프로젝트에 CODEOWNERS 파일이 있어야 합니다.
• 프로젝트에 대한 Maintainer 또는 Owner 권한이 필요합니다.

자동 리뷰어 지정 활성화#

프로젝트에 대한 자동 리뷰어 지정을 켜려면 다음 단계를 수행합니다:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. Settings > Merge requests를 선택합니다.
3. Automatic reviewer assignment 섹션으로 이동합니다.
4. Automatically assign all code owners as reviewers를 선택합니다.
5. Save changes를 선택합니다.

GitLab이 리뷰어를 지정하는 시점#

설정을 켠 후 GitLab은 다음 경우에 Code Owners를 리뷰어로 지정합니다:

• 준비 상태로 머지 리퀘스트가 생성될 때.
• 초안 머지 리퀘스트가 준비 완료로 표시될 때.

GitLab은 머지 리퀘스트에서 변경된 파일과 일치하는 모든 Code Owner를 지정합니다.

GitLab은 다음 경우 자동 지정을 건너뜁니다:

• 머지 리퀘스트가 초안 상태일 때.
• 머지 리퀘스트에 이미 리뷰어가 있을 때. @GitLabDuo는 이 확인에서 제외됩니다.
• 머지 리퀘스트에서 변경된 파일과 일치하는 코드 소유자가 없을 때.
• 머지 리퀘스트 작성자에게 머지 리퀘스트 메타데이터를 설정할 권한이 없을 때.

Recommend Reviewers 플로로 리뷰어 지정#

Recommend Reviewers 플로는 머지 리퀘스트를 검토하기에 가장 적합한 리뷰어를 추천하고 지정합니다.

모든 Code Owner를 지정하는 대신, 가용성·검토 부하·시간대를 기준으로 각 승인 규칙을 충족하는 데 필요한 최소 인원의 리뷰어를 지정합니다.

이 기능은 GitLab Duo Agent Platform에서 실행됩니다.

이 플로는 GitLab 19.3 이하에서 사용하던 Reviewer assignment strategy 프로젝트 설정을 대체합니다.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한과 프로젝트에 대한 Maintainer 또는 Owner 권한이 필요합니다.
• GitLab Duo Agent Platform 사전 조건을 충족해야 합니다.
• 최상위 그룹에서 Allow flow execution, Allow foundational flows, Recommend Reviewers가 켜져 있어야 합니다.

플로 사용#

Recommend Reviewers 플로를 사용하려면 트리거를 생성합니다:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 AI > Triggers를 선택합니다.
3. New flow trigger를 선택합니다.
4. Description에 트리거에 대한 설명을 입력합니다.
5. Configuration source가 표시되면 Flow or external agent를 선택한 다음 플로 목록에서 Recommend Reviewers를 선택합니다.
6. Conditions 섹션에서 다음을 수행합니다:
   1. Add condition을 선택한 다음 On an event를 선택합니다.
   2. Event 드롭다운 목록에서 Merge request를 선택합니다.
   3. Run when 드롭다운 목록에서 Marked ready를 선택합니다.
   4. Add event를 선택합니다.
7. Create flow trigger를 선택합니다.

이 플로는 Developer 이상의 권한을 가진 사람이 초안 머지 리퀘스트를 준비 완료로 표시할 때 실행됩니다.

트리거 생성 및 편집에 대한 자세한 내용은 트리거를 참고합니다.

예외#

• 리뷰어는 초안 머지 리퀘스트가 준비 완료로 표시될 때만 지정됩니다. 머지 리퀘스트가 처음부터 준비 상태로 열리면 이 플로는 리뷰어를 지정하지 않습니다. 자세한 내용은 이슈 592452를 참고합니다.
• 머지 리퀘스트를 준비 완료로 표시하는 사람은 프로젝트에 대해 Developer 이상의 권한을 가지고 있어야 합니다. 권한이 그보다 낮으면 이 플로는 리뷰어를 지정하지 않습니다.

리뷰어 선정#

Recommend Reviewers 플로는 머지 리퀘스트에 설정된 필수 승인 규칙을 읽습니다. 각 규칙에 대해 해당 규칙을 충족하는 데 필요한 최소 인원의 리뷰어를 추천하고 지정합니다. 그런 다음 추천 근거를 설명하는 노트를 추가합니다. 이 플로는 선택 승인 규칙은 무시합니다.

규칙에 대한 승인 가능 인원 중에서 선택할 때 이 플로는 각 승인자에 대해 다음을 고려합니다:

• 상태를 기준으로 한 가용성.
• 검토를 기다리는 열린 머지 리퀘스트 수를 기준으로 한 검토 부하.
• 프로필의 시간대를 기준으로 한 현지 시각.
• 가장 최근 활동.

승인자가 지정되지 않은 기본 All Members 규칙의 경우, 이 플로는 머지 리퀘스트를 승인할 수 있으면서 대상 브랜치에 머지할 수도 있는 프로젝트 직접 멤버 중에서 선택합니다. 대상 브랜치에 머지할 수 있는 권한이 없으면 승인 가능한 모든 직접 멤버가 후보가 됩니다. 상위 그룹이나 초대된 그룹을 통해 액세스 권한을 받은 멤버는 후보가 아니므로, 직접 멤버가 없는 프로젝트는 이 규칙에 대한 추천을 받지 못합니다.

추천은 백그라운드에서 실행되므로 리뷰어가 표시되기까지 시간이 걸릴 수 있습니다. 이 플로는 리뷰어 지정과 노트를 최상위 그룹에서 플로를 켤 때 설정된 서비스 계정에 귀속시킵니다. 머지 리퀘스트를 준비 완료로 표시한 사람에게 귀속되지 않습니다.

관련 주제#

• Code Owners
• 머지 리퀘스트 리뷰
• 머지 리퀘스트 승인 규칙