스쿼시 및 병합

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

기능 브랜치에서 작업할 때, 종종 작은 독립적인 커밋을 생성합니다.

이러한 작은 커밋은 기능을 구축하는 과정을 설명하는 데 도움이 되지만, 기능이 끝난 후 Git 기록을 혼잡하게 만들 수 있습니다.

기능을 마무리하면서 이러한 커밋을 결합하고 스쿼시 및 병합 전략을 사용하여 Git 저장소에서 더 깔끔한 병합 기록을 보장할 수 있습니다.

  • 작은 커밋이 함께 합쳐져 변경 사항의 모든 부분을 되돌리는 것이 더 간단해집니다.
  • 단일 커밋이 대상 분기로 병합될 때 전체 커밋 기록이 유지됩니다.
  • 기본 브랜치는 깔끔하게 유지되며 의미 있는 커밋 메시지를 포함합니다.

브랜치가 기본 브랜치에 병합될 때마다 최대 두 개의 커밋이 추가됩니다:

  • 브랜치의 커밋을 스쿼싱하여 생성된 단일 커밋.
  • 병합 커밋, 프로젝트에서 패스트 포워드 병합을 활성화하지 않은 경우. 패스트 포워드 병합은 병합 커밋을 비활성화합니다.

기본적으로 스쿼시된 커밋은 다음 메타데이터를 포함합니다:

  • 메시지: 스쿼시 커밋에 대한 설명 또는 사용자 정의 메시지
  • 작성자: 병합 요청을 생성한 사용자
  • 커미터: 스쿼시를 시작한 사용자

프로젝트 소유자는 모든 스쿼시 커밋 및 병합 커밋에 대한 새 기본 메시지를 생성할 수 있습니다.

병합 요청에 대한 기본 스쿼시 옵션 설정

병합 요청을 생성하거나 수정할 수 있는 권한이 있는 사용자는 병합 요청에 대한 기본 스쿼시 옵션을 설정할 수 있습니다.

사전 요구 사항:

  • 프로젝트는 스쿼싱을 허용하거나 장려하도록 구성되어야 합니다.

이 작업을 수행하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
  3. 편집을 선택합니다.
  4. 병합 요청이 수락될 때 커밋 스쿼시 체크박스를 선택 또는 해제합니다.
  5. 변경 사항 저장을 선택합니다.

병합 요청에서 커밋 스쿼시

프로젝트에서 병합 요청에 대한 스쿼시 옵션을 선택할 수 있는 경우, 병합 프로세스의 일부로 커밋을 스쿼시하려면:

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

프로젝트에 대한 스쿼시 옵션 구성

사전 요구 사항:

  • 이 프로젝트의 Maintainer 역할을 가져야 합니다.

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

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

관련 주제