Squash and merge

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed형, GitLab Dedicated

기능 브랜치에서 작업할 때 종종 작고 독립적인 커밋을 만듭니다. 이러한 작은 커밋은 기능을 구축하는 과정을 설명하는 데 도움이 되지만, 기능이 완료된 후에는 깨끗한 Merge 히스토리를 보장하기 위해 Git 리포지터리의 히스토리를 지저분하게 만들 수 있습니다. 기능을 완료하면 이러한 커밋을 결합하여 스쿼시 앤 머지 전략을 사용하여 깨끗한 Merge 히스토리를 보장할 수 있습니다.

  • 작은 커밋들이 결합되어 변경 사항의 모든 부분을 되돌릴 수 있게 됩니다.
  • 단일 커밋이 대상 브랜치에 Merge되면 전체 커밋 히스토리가 유지됩니다.
  • 베이스 브랜치는 깨끗한 상태를 유지하며 의미 있는 커밋 메시지를 포함합니다.

브랜치가 베이스 브랜치로 Merge될 때마다 최대 두 개의 커밋이 추가됩니다.

  • 브랜치에서 커밋을 스쿼싱하여 생성된 단일 커밋.
  • 브랜치에서 빠른 순방향 Merge을 활성화하지 않은 경우 Merge 커밋이 추가됩니다. 빠른 순방향 Merge은 Merge 커밋을 비활성화합니다.

기본적으로 스쿼싱된 커밋에는 다음과 같은 메타데이터가 포함됩니다:

  • 메시지: 스쿼시된 커밋의 설명 또는 사용자 정의 메시지
  • 작성자: Merge Request을 만든 사용자
  • 커미터: 스쿼싱을 시작한 사용자

프로젝트 소유자는 스쿼시된 커밋과 Merge 커밋을 위한 새로운 기본 메시지를 만들 수 있습니다.

Merge Request의 기본 스쿼싱 옵션 설정

Merge Request을 만들거나 편집할 수 있는 권한이 있는 사용자는 Merge Request의 기본 스쿼싱 옵션을 설정할 수 있습니다.

전제 조건:

  • 프로젝트는 스쿼싱을 허용하거나 권장하기 위해 구성되어 있어야 합니다.

다음을 수행하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Merge Request을 선택하고 Merge Request을 찾습니다.
  3. 편집을 선택합니다.
  4. Merge Request이 승인될 때 커밋 스쿼싱 확인란을 선택하거나 선택하지 않습니다.
  5. 변경 사항 저장을 선택합니다.

Merge Request에서 커밋 스쿼싱하기

프로젝트가 Merge Request에 대해 스쿼싱 옵션을 선택할 수 있도록 허용한다면, Merge 프로세스의 일부로 커밋을 스쿼싱하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Merge Request을 선택하고 Merge Request을 찾습니다.
  3. Merge 버튼을 포함하는 Merge Request 보고서 섹션으로 스크롤합니다.
  4. 커밋 스쿼싱 확인란이 선택되어 있는지 확인합니다. 프로젝트의 스쿼싱 옵션이 허용 금지 또는 필요로 함으로 설정된 경우 이 확인란은 표시되지 않습니다.
  5. 원하는 경우 (프로젝트 구성에 따라) 스쿼시 커밋 메시지 또는 Merge 커밋 메시지를 수정하려면 커밋 메시지 수정을 선택합니다.
  6. Merge Request을 Merge할 준비가 되었을 때 Merge을 선택합니다.

프로젝트의 스쿼싱 옵션 구성

전제 조건:

  • 이 프로젝트의 유지자 역할을 최소한 가지고 있어야 합니다.

프로젝트의 모든 Merge Request에 대한 기본 스쿼싱 동작을 구성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > Merge Request을 선택합니다.
  3. Merge 시 커밋 스쿼싱 섹션에서 원하는 동작을 선택합니다:
    • 허용 금지: 스쿼싱을 절대 수행하지 않으며 옵션이 표시되지 않습니다.
    • 허용: 스쿼싱이 허용되지만 기본적으로 지워집니다.
    • 권장: 스쿼싱이 허용되고 기본적으로 선택되지만 비활성화될 수 있습니다.
    • 필요로 함: 항상 스쿼싱이 수행됩니다. Merge Request은 스쿼싱 옵션을 표시하지만 사용자는 변경할 수 없습니다.
  4. 변경 사항 저장을 선택합니다.

관련 주제