InfoGrab DocsInfoGrab Docs

자동 리뷰어 지정 및 추천

요약

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 권한이 필요합니다.

자동 리뷰어 지정 활성화#

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

  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 플로#

히스토리
  • 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 페이지에 표시되며, 여기에서 끌 수 있습니다.

초안 머지 리퀘스트가 준비 완료로 표시될 때 플로를 실행하려면 이 자동화를 끄고 자동화를 생성합니다:

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. New automation을 선택합니다.
  4. Name에 자동화의 이름을 입력합니다.
  5. Runs with 드롭다운 목록에서 Recommend Reviewers를 선택합니다.
  6. Runs when에서 일정이 열려 있으면 Cancel을 선택합니다.
  7. Add trigger > On an event를 선택한 다음 다음을 수행합니다:
    1. Select an event 드롭다운 목록에서 Merge request를 선택합니다.
    2. Run when 드롭다운 목록에서 Marked ready를 선택합니다.
    3. Add event를 선택합니다.
  8. 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 규칙의 경우, 이 플로는 머지 리퀘스트를 승인할 수 있으면서 대상 브랜치에 머지할 수도 있는 프로젝트 직접 멤버 중에서 선택합니다. 대상 브랜치에 머지할 수 있는 권한이 없으면 승인 가능한 모든 직접 멤버가 후보가 됩니다. 상위 그룹이나 초대된 그룹을 통해 액세스 권한을 받은 멤버는 후보가 아니므로, 직접 멤버가 없는 프로젝트는 이 규칙에 대한 추천을 받지 못합니다.

추천은 백그라운드에서 실행되므로 추천된 리뷰어가 표시되기까지 시간이 걸릴 수 있습니다. 이 플로는 최상위 그룹에서 플로를 켤 때 설정된 서비스 계정으로 실행됩니다.

관련 주제#

자동 리뷰어 지정 및 추천

GitLab v19.6
Tier: Premium, Ultimate
Offering: 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 권한이 필요합니다.

자동 리뷰어 지정 활성화#

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

  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 플로#

히스토리
  • 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 페이지에 표시되며, 여기에서 끌 수 있습니다.

초안 머지 리퀘스트가 준비 완료로 표시될 때 플로를 실행하려면 이 자동화를 끄고 자동화를 생성합니다:

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. New automation을 선택합니다.
  4. Name에 자동화의 이름을 입력합니다.
  5. Runs with 드롭다운 목록에서 Recommend Reviewers를 선택합니다.
  6. Runs when에서 일정이 열려 있으면 Cancel을 선택합니다.
  7. Add trigger > On an event를 선택한 다음 다음을 수행합니다:
    1. Select an event 드롭다운 목록에서 Merge request를 선택합니다.
    2. Run when 드롭다운 목록에서 Marked ready를 선택합니다.
    3. Add event를 선택합니다.
  8. 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 규칙의 경우, 이 플로는 머지 리퀘스트를 승인할 수 있으면서 대상 브랜치에 머지할 수도 있는 프로젝트 직접 멤버 중에서 선택합니다. 대상 브랜치에 머지할 수 있는 권한이 없으면 승인 가능한 모든 직접 멤버가 후보가 됩니다. 상위 그룹이나 초대된 그룹을 통해 액세스 권한을 받은 멤버는 후보가 아니므로, 직접 멤버가 없는 프로젝트는 이 규칙에 대한 추천을 받지 못합니다.

추천은 백그라운드에서 실행되므로 추천된 리뷰어가 표시되기까지 시간이 걸릴 수 있습니다. 이 플로는 최상위 그룹에서 플로를 켤 때 설정된 서비스 계정으로 실행됩니다.

관련 주제#