병합 요청 승인
프로젝트의 변경 사항에 대한 리뷰 프로세스를 설정하려면 병합 요청 승인을 구성하세요.
이는 변경 사항이 프로젝트에 병합되기 전에 검토되도록 보장하는 데 도움이 됩니다.
승인은 프로젝트의 요구 사항과 GitLab 등급에 따라 선택적이거나 필수로 설정할 수 있습니다.
-
GitLab Free는
최소한의 Developer role을 가진 모든 사용자에게
병합 요청을 승인할 수 있는 권한을 부여합니다. 이러한 승인은 선택 사항이며 승인 없이 병합하는 것을 방지하지 않습니다. -
GitLab Premium 및
GitLab Ultimate는 더 많은 유연성을 제공합니다:- 필수 승인 수 및 유형에 대한 규칙을 생성합니다.
- 특정 파일에 대한 Code Owners 목록을 생성합니다.
- 전체 인스턴스를 위한 승인 구성합니다.
-
그룹 병합 요청 승인 설정을 구성합니다.
그룹 병합 요청 승인 설정에 대한 지원은
epic 4367에서 추적됩니다.
승인 규칙 구성하기
사전 요구 사항:
- 프로젝트에 대해 최소한 Developer 역할이 있어야 합니다.
승인 규칙을 구성하려면:
- 프로젝트의 Settings > Merge requests로 이동합니다.
- Merge request approvals 섹션으로 이동합니다.
- 원하는 규칙을 설정합니다.
추가로 구성할 수 있는 항목으로는:
- 프로젝트의 감독 및 보안 수준을 더 잘 제어하기 위한 추가 병합 요청 승인 설정.
- 병합 요청 승인 API를 사용하여 병합 요청 승인 규칙을 설정합니다.
규칙 구성에 대한 자세한 내용은 Approval rules를 참조하세요.
필수 승인
필수 승인은 지정된 사용자의 코드 리뷰를 강제합니다. 이러한 승인이 없으면 병합이 불가능합니다.
사용 사례에는:
- 저장소에 병합되는 모든 코드에 대한 검토를 강제합니다.
- 검토자 및 최소 승인 수를 지정합니다.
- 백엔드, 프론트엔드, 품질 보증, 데이터베이스 또는 문서화와 같은 검토자 범주를 지정합니다.
- Code Owners 파일을 사용하여 검토자를 결정합니다.
- 테스트 커버리지 거부에 대한 승인 요구 사항을 설정합니다.
- GitLab Ultimate: 잠재적 취약성에 대한 보안 팀 승인을 요구합니다.
승인 상태 보기
병합 요청의 승인 상태를 두 곳에서 확인할 수 있습니다. 단일 병합 요청에서와
병합 요청 목록에서 확인 가능합니다.
단일 병합 요청에 대해
Eligible approvers는 단일 병합 요청에서 승인 상태를 볼 수 있습니다.
승인 상태를 보려면:
- 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Code > Merge requests로 이동하여 병합 요청을 찾습니다.
- 병합 요청을 보려면 제목을 선택합니다.
-
병합 요청 위젯으로 이동하여 승인 상태를 확인합니다. 다음 예제에서는 병합 요청을 승인할 수 있습니다:
위젯은 다음 중 하나의 상태를 표시합니다:
- Approve: 병합 요청에 더 많은 승인이 필요합니다.
- Approve additionally: 병합 요청에 필수 승인이 있습니다.
- Revoke approval: 이미 병합 요청을 승인했습니다.
Code Owner 요구 사항을 충족하는지 확인하려면 Expand eligible approvers()를 선택합니다.
병합 요청 목록
프로젝트 또는 그룹의 병합 요청 목록은 각 병합 요청에 대한 승인 상태를 보여줍니다:
예시 | 설명 |
---|---|
![]() |
필요한 승인 사항이 누락되었습니다. () |
![]() |
승인이 완료되었습니다. () |
![]() |
승인이 완료되었으며, 귀하는 승인자 중 한 명입니다. () |
개별 검토자 상태
각 검토자의 검토 및 승인 상태를 보려면:
- 병합 요청을 엽니다.
- 오른쪽 사이드바를 확인합니다.
각 검토자의 상태는 그들의 이름 옆에 표시됩니다.
검토 요청 다시 하기를 하려면, 사용자 옆의 검토 요청 다시 하기 아이콘 ()을 선택합니다.
병합 요청 승인
적격 승인자는 두 가지 방법으로 병합 요청을 승인할 수 있습니다:
- 병합 요청 위젯에서 승인을 선택합니다.
- 댓글에서
/approve
빠른 작업을 사용합니다.
승인된 병합 요청은 검토자 목록에서 사용자 이름 옆에 초록색 체크 마크 ()를 표시합니다.
병합 요청이 필요한 승인을 받으면 병합할 준비가 되지만, 다음으로 인해 차단될 수 있습니다:
작성자 승인 방지
작성자가 자신의 작업을 승인하지 못하도록 하려면 작성자에 의한 승인 방지 설정을 활성화합니다.
승인 규칙 변경
승인 규칙 무시를 활성화하면 기본 승인 규칙 변경이 기존 병합 요청에 영향을 미치지 않으며, 대상 브랜치 변경을 제외합니다.
유효하지 않은 규칙
GitLab은 승인 규칙이 충족할 수 없는 경우 자동 승인됨으로 표시합니다, 예를 들어:
- 유일한 적격 승인이 병합 요청 작성자일 때.
- 규칙에 적격 승인이 할당되지 않았을 때.
- 필요한 승인이 적격 승인의 수를 초과할 때.
이러한 규칙은 병합 요청의 차단을 해제하기 위해 자동으로 승인됩니다, 만약 당신이 병합 요청 승인 정책을 통해 규칙을 생성하지 않았다면.
유효하지 않은 정책 생성 규칙:
- 조치 필요로 표시됩니다.
- 자동으로 승인되지 않습니다.
- 영향을 받는 병합 요청을 차단합니다.