Squash and merge

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

특징 브랜치에서 작업하는 동안 종종 작고 독립적인 커밋을 만듭니다. 이러한 작은 커밋은 기능을 구축하는 프로세스를 설명하는 데 도움이 되지만, 기능을 마치고 나면 깨끗한 Merge 이력을 보장하기 위해 스쿼시 및 Merge 전략을 사용하여 Git 리포지터리의 기록을 혼동시킬 수 있습니다.

  • 작은 커밋을 결합하여 변경 사항의 모든 부분을 되돌릴 수 있도록 만듭니다.
  • 단일 커밋이 대상 브랜치에 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. 변경 사항 저장을 선택합니다.

관련 주제