아래 문서는 머지 리퀘스트 용어 및 기능에 관한 단일 진실 공급원(Single Source Of Truth, SSOT)입니다.

머지 리퀘스트는 전반적인 머지 리퀘스트 경험을 구성하는 여러 핵심 컴포넌트와 개념으로 이루어져 있습니다. 이러한 개념들은 때로 용어가 혼재되거나 혼란스럽게 겹치기도 합니다. 이 페이지에서는 다음 개념을 다룹니다:

• 머지 위젯

• 보고서 위젯

• 머지 검사

• 승인 규칙

새로운 머지 리퀘스트 위젯을 개발할 때는 머지 리퀘스트 위젯 프레임워크 문서를 읽어보세요. 모든 새 위젯은 이 프레임워크를 사용해야 하며, 기존 위젯들도 이 프레임워크를 사용하도록 포팅되어야 합니다.

머지 위젯#

머지 위젯은 merge 버튼이 위치하는 머지 리퀘스트의 컴포넌트입니다:

[

](/19.1/development/merge_request_concepts/img/merge_widget_v17_11.png)

머지 리퀘스트의 이 영역에서 머지 전에 모든 옵션과 커밋 메시지가 정의됩니다. 또한 머지 리퀘스트에 무엇이 포함되어 있는지, 어떤 이슈가 종료되는지, 그리고 머지 프로세스에 중요한 기타 정보를 포함합니다.

보고서 위젯#

보고서 위젯은 머지 리퀘스트 내의 변경 사항에 관한 정보를 보고하는 위젯입니다. 이러한 위젯들은 작성자가 변경 사항을 더 잘 이해하고 제안된 변경 사항을 추가로 개선하는 데 도움이 되는 정보를 제공합니다.

Design Documentation

[

](/19.1/development/merge_request_concepts/img/merge_request_reports_v17_11.png)

머지 검사#

머지 검사는 통과 또는 실패할 수 있는 상태로, 머지 리퀘스트 내에서 머지 버튼의 가용성을 조건부로 제어합니다. 머지 검사의 핵심적인 구별 요소는 사용자가 머지 리퀘스트 내에서 머지 검사와 직접 상호작용하지 않지만, 검사의 통과 또는 실패 여부에 영향을 줄 수 있다는 점입니다. 검사 결과는 머지 리퀘스트의 머지 가능 여부를 판단하기 위해 true/false로 처리됩니다.

머지 검사의 예시에는 다음이 포함됩니다:

• 머지 충돌

• 파이프라인 성공

• 스레드 해결

• 외부 상태 검사

• 필수 승인

머지 리퀘스트는 필수 머지 검사가 모두 충족되어야만 머지할 수 있습니다.

승인#

승인 규칙은 일종의 조직 정책에 따라 머지 리퀘스트를 필수적으로 또는 선택적으로 승인해야 하는 사용자를 지정합니다. 승인이 필수인 경우 실질적으로 필수 머지 검사가 됩니다. 머지 검사와 승인 규칙의 핵심 차이점은 사용자가 머지 리퀘스트 승인 여부를 결정함으로써 승인 규칙과 직접 상호작용한다는 점입니다.

또한 승인 설정은 머지 리퀘스트에서 승인 규칙이 적용되는 방식을 정의하는 구성 옵션을 제공합니다. 제한을 설정하거나, 요구 사항을 추가하거나, 승인을 수정할 수 있습니다.

승인 규칙 및 설정의 예시에는 다음이 포함됩니다:

• 머지 리퀘스트 승인 규칙

• 코드 소유자 승인

• 보안 승인

• 승인 규칙 편집 방지

• 커밋 추가 시 모든 승인 제거