프로젝트의 변경 사항에 대한 검토 프로세스를 설정하려면 머지 리퀘스트 승인을 구성합니다. 이를 통해 변경 사항이 프로젝트에 병합되기 전에 검토되도록 할 수 있습니다. 프로젝트의 필요와 GitLab 티어에 따라 승인을 선택적 또는 필수로 구성할 수 있습니다.

• GitLab Free는 Developer 역할 이상을 가진 모든 사용자가 머지 리퀘스트를 승인할 수 있습니다. 이 승인은 선택적이며 승인 없이 병합하는 것을 막지 않습니다.

• GitLab Premium과 GitLab Ultimate는 다음을 위한 더 많은 유연성을 제공합니다:

  • 필요한 승인 수와 유형에 대한 필수 규칙을 만듭니다.

  • 특정 파일에 대한 코드 소유자 목록을 만듭니다.

  • 전체 인스턴스에 대한 승인을 구성합니다.

  • 그룹 머지 리퀘스트 승인 설정을 구성합니다.

    [!note] 그룹 머지 리퀘스트 승인 설정에 대한 지원은 에픽 4367에서 추적됩니다.

승인 규칙 구성#

필수 요건:

• 프로젝트에 대한 Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

승인 규칙을 구성하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 설정 > 머지 리퀘스트를 선택합니다.
3. 머지 리퀘스트 승인 섹션으로 이동합니다.
4. 원하는 규칙을 설정합니다.

다음을 추가로 구성할 수 있습니다:

• 프로젝트에 필요한 감독 및 보안 수준을 제어하기 위한 머지 리퀘스트 승인 설정.
• 머지 리퀘스트 승인 API를 사용하는 머지 리퀘스트 승인 규칙.

규칙 구성에 대한 자세한 내용은 승인 규칙을 참조하세요.

필수 승인#

필수 승인은 지정된 사용자의 코드 검토를 강제합니다. 이 승인 없이는 병합이 불가능합니다.

사용 사례:

• 리포지터리에 병합되는 모든 코드 검토를 강제합니다.
• 검토자와 최소 승인 수를 지정합니다.
• 백엔드, 프론트엔드, QA, 데이터베이스, 문서와 같은 검토자 카테고리를 지정합니다.
• CODEOWNERS 파일을 사용하여 검토자를 결정합니다.
• 테스트 커버리지 감소에 대한 승인을 요구합니다.
• GitLab Ultimate: 잠재적인 취약점에 대해 보안 팀 승인을 요구합니다.

승인 상태 보기#

머지 리퀘스트의 승인 상태를 보려면 머지 리퀘스트 자체나 프로젝트 또는 그룹의 머지 리퀘스트 목록에서 확인합니다.

단일 머지 리퀘스트의 경우#

자격 있는 승인자는 단일 머지 리퀘스트의 승인 상태를 볼 수 있습니다.

승인 상태를 보려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

3. 머지 리퀘스트를 보려면 제목을 선택합니다.

4. 머지 리퀘스트 위젯에서 승인 상태를 확인합니다. 이 예시에서는 머지 리퀘스트를 승인할 수 있습니다:

   

위젯에는 다음 중 하나의 상태가 표시됩니다:

• 승인: 머지 리퀘스트에 더 많은 승인이 필요합니다.
• 추가 승인: 머지 리퀘스트에 필요한 승인이 있습니다.
• 승인 취소: 이미 머지 리퀘스트를 승인했습니다.

승인이 Code Owner 요건을 충족하는지 확인하려면 자격 있는 승인자 펼치기([chevron-lg-down])를 선택합니다.

승인자 가시성은 프로젝트 멤버 자격 및 그룹 개인 정보 보호에 따라 다릅니다:

• 프로젝트 멤버는 모든 승인자를 볼 수 있습니다.
• 프로젝트 비멤버는 다음을 볼 수 있습니다:
  • 모든 승인자가 공개 그룹에 속한 경우 모든 승인자.
  • 승인자 중 한 명이라도 비공개 그룹에 속한 경우 승인자에 대한 정보 없음.

머지 리퀘스트 목록에서#

프로젝트 또는 그룹의 머지 리퀘스트 목록에는 각 머지 리퀘스트의 승인 상태가 표시됩니다:

예시	설명
	필수 승인이 부족합니다. ([approval])
	승인이 완료되었습니다. (✓)
	승인이 완료되었으며 승인자 중 한 명입니다. ([approval-solid])

개별 검토자 상태#

각 검토자의 검토 및 승인 상태를 보려면:

1. 머지 리퀘스트를 엽니다.
2. 오른쪽 사이드바를 확인합니다.

각 검토자의 상태가 이름 옆에 표시됩니다.

• [dash-circle] 검토 대기 중

• [status_running] 검토 진행 중

• [check-circle] 승인됨

• [comment-lines] 검토자가 댓글 남김

• [status_warning] 검토자가 변경 요청

  

검토 재요청을 하려면 사용자 옆의 검토 재요청 아이콘([redo])을 선택합니다.

머지 리퀘스트 승인#

자격 있는 승인자는 두 가지 방법으로 머지 리퀘스트를 승인할 수 있습니다:

• 머지 리퀘스트 위젯에서 승인을 선택합니다.
• 댓글에서 /approve 빠른 작업을 사용합니다.

승인된 머지 리퀘스트는 검토자 목록의 사용자 이름 옆에 녹색 체크 표시([check-circle-filled])가 표시됩니다. 머지 리퀘스트가 필요한 승인을 받으면 다음으로 인해 차단되지 않는 한 병합할 준비가 됩니다:

• 머지 충돌
• 열린 스레드
• 실패한 CI/CD 파이프라인

머지 리퀘스트 작성자 승인 방지#

머지 리퀘스트 작성자가 자신의 작업을 승인하는 것을 방지하려면 머지 리퀘스트 작성자의 승인 방지 설정을 활성화합니다.

승인 규칙 변경#

승인 규칙 재정의를 활성화하면 기본 승인 규칙에 대한 변경 사항이 대상 브랜치 변경을 제외하고 기존 머지 리퀘스트에 영향을 미치지 않습니다.

유효하지 않은 규칙#

GitLab은 다음과 같이 충족 불가능한 경우 승인 규칙을 자동 승인으로 표시합니다:

• 자격 있는 유일한 승인자가 머지 리퀘스트 작성자입니다.
• 규칙에 자격 있는 승인자가 할당되어 있지 않습니다.
• 필요한 승인 수가 자격 있는 승인자 수를 초과합니다.

이러한 규칙은 머지 리퀘스트 승인 정책을 통해 만든 규칙이 아닌 경우 머지 리퀘스트 차단을 해제하기 위해 자동으로 승인됩니다.

유효하지 않은 정책으로 만든 규칙:

• 조치 필요로 표시됩니다.
• 자동으로 승인되지 않습니다.
• 영향을 받는 머지 리퀘스트를 차단합니다.

관련 주제#

• 머지 리퀘스트 승인 API
• GitLab Self-Managed 인스턴스의 인스턴스 승인 규칙
• Planner 또는 Reporter 역할을 가진 사용자에게 승인 권한 활성화
• 머지 리퀘스트 승인 규칙 편집 또는 재정의