자동 리뷰어 지정 및 추천
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
GitLab은 머지 리퀘스트의 리뷰어를 직접 선택하지 않아도 되도록 리뷰어를 지정하거나 추천할 수 있습니다: 자동 리뷰어 지정을 활성화하면 GitLab이 변경된 파일의 Code Owners를 머지 리퀘스트의 리뷰어로 지정합니다.
GitLab은 머지 리퀘스트의 리뷰어를 직접 선택하지 않아도 되도록 리뷰어를 지정하거나 추천할 수 있습니다:
- 변경된 파일의 Code Owners를 리뷰어로 지정하려면 자동 리뷰어 지정을 사용합니다.
- 코드 오너 규칙을 포함한 승인 규칙을 기준으로 리뷰어 추천을 받으려면 Recommend Reviewers 플로를 사용합니다.
자동 리뷰어 지정#
히스토리
- GitLab 18.10에서
auto_assign_code_owner_reviewers기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.1에서 일반 공급되었습니다. 기능 플래그
auto_assign_code_owner_reviewers가 제거되었습니다.
자동 리뷰어 지정을 활성화하면 GitLab이 변경된 파일의 Code Owners를 머지 리퀘스트의 리뷰어로 지정합니다.
사전 요구 사항:
- 프로젝트에
CODEOWNERS파일이 있어야 합니다. - 프로젝트에 대한 Maintainer 또는 Owner 권한이 필요합니다.
자동 리뷰어 지정 활성화#
프로젝트에 대한 자동 리뷰어 지정을 켜려면 다음 단계를 수행합니다:
- 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > Merge requests를 선택합니다.
- Automatic reviewer assignment 섹션으로 이동합니다.
- Automatically assign all code owners as reviewers를 선택합니다.
- Save changes를 선택합니다.
GitLab이 리뷰어를 지정하는 시점#
설정을 켠 후 GitLab은 다음 경우에 Code Owners를 리뷰어로 지정합니다:
- 준비 상태로 머지 리퀘스트가 생성될 때.
- 초안 머지 리퀘스트가 준비 완료로 표시될 때.
GitLab은 머지 리퀘스트에서 변경된 파일과 일치하는 모든 Code Owner를 지정합니다.
GitLab은 다음 경우 자동 지정을 건너뜁니다:
- 머지 리퀘스트가 초안 상태일 때.
- 머지 리퀘스트에 이미 리뷰어가 있을 때.
@GitLabDuo는 이 확인에서 제외됩니다. - 머지 리퀘스트에서 변경된 파일과 일치하는 코드 소유자가 없을 때.
- 머지 리퀘스트 작성자에게 머지 리퀘스트 메타데이터를 설정할 권한이 없을 때.
Recommend Reviewers 플로#
히스토리
- GitLab 19.0에서
dap_powered_recommend_reviewers기능 플래그와 함께 베타 프로젝트 설정으로 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.4에서 프로젝트 설정 대신 플로 트리거를 사용하도록 변경되었습니다. 기능 플래그
dap_powered_recommend_reviewers가 제거되었습니다. - GitLab 19.5에서 머지 리퀘스트가 생성될 때 실행되는 트리거를 만들도록 변경되었습니다.
- GitLab 19.5에서 리뷰어를 지정하는 대신 머지 리퀘스트 사이드바에서 리뷰어를 추천하도록 변경되었습니다.
- 기존 머지 리퀘스트에 대한 추천 요청이 GitLab 19.5에서 도입되었습니다.
- GitLab 19.5에서 일반 공급되었습니다.
Recommend Reviewers 플로는 머지 리퀘스트를 검토하기에 가장 적합한 리뷰어를 추천합니다. 각 승인 규칙을 충족하는 데 필요한 최소 인원의 리뷰어를 추천하며, 가용성·검토 부하·시간대를 기준으로 리뷰어를 선택합니다.
추천된 리뷰어는 머지 리퀘스트 사이드바에 표시되며, 그중 누구를 지정할지는 사용자가 선택합니다.
이 기능은 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 Flow를 참고합니다.
플로 사용#
최상위 그룹에서 Recommend Reviewers 플로를 켜면 GitLab이 각 프로젝트에 자동화를 생성합니다. 이 자동화는 초안으로 생성된 머지 리퀘스트와 준비 상태로 생성된 머지 리퀘스트를 포함해 머지 리퀘스트가 생성될 때 플로를 실행합니다. 초안 머지 리퀘스트의 경우 이 플로는 머지 리퀘스트가 준비 완료로 표시될 때가 아니라 생성될 때 리뷰어를 추천합니다.
이 자동화는 프로젝트의 AI > Automations 페이지에 표시되며, 여기에서 끌 수 있습니다.
초안 머지 리퀘스트가 준비 완료로 표시될 때 플로를 실행하려면 이 자동화를 끄고 자동화를 생성합니다:
- 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 AI > Automations를 선택합니다.
- New automation을 선택합니다.
- Name에 자동화의 이름을 입력합니다.
- Runs with 드롭다운 목록에서 Recommend Reviewers를 선택합니다.
- Runs when에서 일정이 열려 있으면 Cancel을 선택합니다.
- Add trigger > On an event를 선택한 다음 다음을 수행합니다:
- Select an event 드롭다운 목록에서 Merge request를 선택합니다.
- Run when 드롭다운 목록에서 Marked ready를 선택합니다.
- Add event를 선택합니다.
- Create를 선택합니다.
이 플로는 Developer 이상의 권한을 가진 사람이 초안 머지 리퀘스트를 준비 완료로 표시할 때 실행됩니다.
자동화 생성 및 편집에 대한 자세한 내용은 자동화를 참고합니다.
기존 머지 리퀘스트에 대한 추천 요청#
플로를 켜기 전에 존재하던 머지 리퀘스트는 플로를 수동으로 시작해야 합니다.
사전 요구 사항:
- 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한이 필요합니다.
플로가 실행되지 않은 머지 리퀘스트에 대한 추천을 요청하려면 다음과 같이 합니다:
- 오른쪽 사이드바의 Reviewers > Recommended에서 Generate를 선택합니다.
플로가 실행되는 동안에는 Generate를 사용할 수 없습니다.
추천된 리뷰어 지정#
플로가 실행된 후 추천된 리뷰어는 오른쪽 사이드바의 Reviewers 아래 Recommended 섹션에 승인 규칙별로 묶여 표시됩니다. 추천이 하나 이상 있을 때 이 섹션이 표시됩니다.
플로가 사용자를 추천한 이유와 시점을 보려면 해당 사용자 위에 마우스를 올립니다.
사전 요구 사항:
- 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한이 필요합니다.
추천된 리뷰어를 머지 리퀘스트에 지정하려면 다음과 같이 합니다:
- Recommended에서 지정하려는 사용자 옆의 Add reviewer(+)를 선택합니다.
리뷰어를 지정하면 해당 사용자는 더 이상 Recommended 섹션에 표시되지 않습니다.
플로를 다시 실행하여 새 추천을 받으려면 다음과 같이 합니다:
- Recommended 섹션에서 Recommended reviewer actions(⋮) > Refresh를 선택합니다.
GitLab은 머지 리퀘스트가 머지되거나 닫히면 추천을 제거합니다.
예외#
- 머지 리퀘스트를 생성하거나 준비 완료로 표시하는 사람은 프로젝트에 대해 Developer 이상의 권한을 가지고 있어야 합니다. 권한이 그보다 낮으면 이 플로는 리뷰어를 추천하지 않습니다.
리뷰어 선정#
Recommend Reviewers 플로는 머지 리퀘스트에 설정된 필수 승인 규칙과 선택 승인 규칙을 읽습니다. 선택 승인 규칙은 승인이 0건 필요한 규칙입니다. 이 플로는 선택 사항인 All Members 규칙과 머지 리퀘스트 승인 정책이 만든 선택 규칙은 건너뜁니다. 현재 리뷰어가 아직 충족하지 못한 각 규칙에 대해, 해당 규칙을 충족하는 데 필요한 최소 인원의 리뷰어를 추천합니다. 이 플로는 이미 리뷰어인 사용자는 추천하지 않습니다. 추천된 각 리뷰어에 대해 추천 이유를 간단히 저장합니다.
규칙에 대한 승인 가능 인원 중에서 선택할 때 이 플로는 각 승인자에 대해 다음을 고려합니다:
- 상태를 기준으로 한 가용성.
- 리뷰어로 지정된 열린 머지 리퀘스트 수를 기준으로 한 검토 부하. 머지 리퀘스트는 리뷰어가 리뷰하거나 승인하거나 변경을 요청한 뒤에는 절반으로 계산됩니다. Generate 또는 Refresh를 선택하면, 이러한 머지 리퀘스트는 플로가 최근 1시간 안에 계산한 경우에만 포함됩니다.
- 프로필의 시간대를 기준으로 한 현지 시각.
- 가장 최근 활동.
승인자가 지정되지 않은 기본 All Members 규칙의 경우, 이 플로는 머지 리퀘스트를 승인할 수 있으면서 대상 브랜치에 머지할 수도 있는 프로젝트 직접 멤버 중에서 선택합니다. 대상 브랜치에 머지할 수 있는 권한이 없으면 승인 가능한 모든 직접 멤버가 후보가 됩니다. 상위 그룹이나 초대된 그룹을 통해 액세스 권한을 받은 멤버는 후보가 아니므로, 직접 멤버가 없는 프로젝트는 이 규칙에 대한 추천을 받지 못합니다.
추천은 백그라운드에서 실행되므로 추천된 리뷰어가 표시되기까지 시간이 걸릴 수 있습니다. 이 플로는 최상위 그룹에서 플로를 켤 때 설정된 서비스 계정으로 실행됩니다.