변경 사항 선택하기

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

Git에서 cherry-picking은 한 브랜치에서 단일 커밋을 가져와 다른 브랜치의 최신 커밋으로 추가하는 것입니다. 소스 브랜치의 나머지 커밋은 대상에 추가되지 않습니다. 커밋 내용을 전체 브랜치의 내용이 아닌 단일 커밋으로 필요한 경우에 커밋을 cherry-pick합니다. 예를 들어:

  • 기본 브랜치에서 버그 수정을 이전 릴리스 브랜치로 백포트합니다.
  • 포크에서 변경 내용을 상위 리포지터리로 복사합니다.

GitLab UI를 사용하여 프로젝트나 프로젝트 포크에서 단일 커밋이나 전체 Merge Request의 내용을 cherry-pick할 수 있습니다.

이 예시에서 Git 리포지터리에 develop와 main 두 개의 브랜치가 있습니다. main 브랜치의 커밋 E 이후에 develop 브랜치에서 커밋 B가 cherry-pick되며 커밋 G가 추가됩니다.

gitGraph commit id: "A" branch develop commit id:"B" checkout main commit id:"C" checkout develop commit id:"D" checkout main commit id:"E" cherry-pick id:"B" commit id:"G" checkout develop commit id:"H"

Merge Request에서 모든 변경 사항 선택하기

Merge Request이 Merge된 후, 해당 Merge Request에 의해 도입된 모든 변경 사항을 cherry-pick할 수 있습니다. Merge Request은 상류 프로젝트나 하류 포크에 있을 수 있습니다.

전제 조건:

  • 프로젝트에서 Merge Request을 편집하고 리포지터리에 코드를 추가할 수 있는 역할이 있어야 합니다.

  • 프로젝트는 Settings > Merge requests에서 설정한 Merge Commit Merge 방법을 사용해야 합니다.

    GitLab 16.9 이후에는 fast-forwarded 커밋이 통합되거나 Merge Request이 단일 커밋을 포함할 때만 GitLab UI에서 cherry-pick할 수 있습니다. 항상 단일 커밋들을 cherry-pick할 수 있습니다.

다음을 수행합니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Merge requests를 선택하고 Merge Request을 찾습니다.
  3. Merge Request 보고 섹션으로 스크롤하여 Merged by 보고서를 찾습니다.

  4. 보고서의 오른쪽 상단에서 Cherry-pick을 선택합니다:

    Merge Request cherry-pick

  5. 대화상자에서 cherry-pick할 프로젝트와 브랜치를 선택합니다.
  6. 선택 사항. 이 변경 사항으로 새 Merge Request 시작을 선택합니다.
  7. Cherry-pick을 선택합니다.

단일 커밋 선택하기

GitLab 프로젝트에서 여러 위치에서 단일 커밋을 cherry-pick할 수 있습니다.

프로젝트의 커밋 디렉터리에서

프로젝트의 모든 커밋 디렉터리에서 커밋을 cherry-pick하려면 다음을 수행합니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Commits를 선택합니다.
  3. cherry-pick하려는 커밋의 타이틀을 선택합니다.
  4. 오른쪽 상단에서 Options > Cherry-pick을 선택합니다.
  5. cherry-pick 대화상자에서 cherry-pick할 프로젝트와 브랜치를 선택합니다.
  6. 선택 사항. 이 변경 사항으로 새 Merge Request 시작을 선택합니다.
  7. Cherry-pick을 선택합니다.

리포지터리의 파일 보기에서

프로젝트의 Git 리포지터리에서 파일을 보고 있는 개별 파일에 영향을 주는 이전 커밋 디렉터리에서 cherry-pick할 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Repository를 선택합니다.
  3. 해당 커밋에서 변경된 파일로 이동합니다. 오른쪽 상단에서 History를 선택합니다.
  4. cherry-pick하려는 커밋의 타이틀을 선택합니다.
  5. 오른쪽 상단에서 Options > Cherry-pick을 선택합니다.
  6. cherry-pick 대화상자에서 cherry-pick할 프로젝트와 브랜치를 선택합니다.
  7. 선택 사항. 이 변경 사항으로 새 Merge Request 시작을 선택합니다.
  8. Cherry-pick을 선택합니다.

명령줄에서

git 명령줄 인터페이스를 사용하여 커밋을 하나의 브랜치에서 다른 브랜치로 cherry-pick할 수 있습니다.

이 예시에서는 특정 브랜치(feature)에서 다른 브랜치(develop)로 커밋을 cherry-pick합니다.

  1. 기본 브랜치를 확인하고, 해당 브랜치를 기반으로 새로운 develop 브랜치를 확인합니다: 

    git checkout main
git checkout -b develop

  2. 다시 feature 브랜치로 변경합니다: 

    git checkout feature

  3. 변경 사항을 적용하고, 커밋합니다: 

    git add changed_file.rb
git commit -m 'changed_file.rb의 버그 수정'

  4. 커밋 로그를 표시합니다: 

    $ git log
   
commit 0000011111222223333344444555556666677777
Merge: 88888999999 aaaaabbbbbb
Author: user@example.com
Date:   Tue Aug 31 21:19:41 2021 +0000

  5. commit 행을 확인하고, 해당 행의 글자와 숫자로 구성된 문자열을 복사합니다. 이 정보는 커밋의 SHA(Secure Hash Algorithm)입니다. SHA는 해당 커밋의 고유 식별자이며, 이후 단계에서 필요합니다.

  6. 이제 SHA를 알고 있으므로 develop 브랜치를 다시 확인합니다: 

    git checkout develop

  7. develop 브랜치로 커밋을 cherry-pick하고, SHA를 커밋 SHA로 변경합니다: 

    git cherry-pick SHA

cherry-pick된 커밋에 대한 시스템 노트 보기

GitLab UI나 API에서 Merge 커밋을 cherry-pick하면 GitLab은 관련 Merge Request 스레드에 시스템 노트를 추가합니다. 형식은 [USER] picked the changes into the branch [BRANCHNAME] with commit** [SHA] [DATE]입니다:

Merge Request 타임라인에서 cherry-pick 추적

시스템 노트는 새로운 커밋과 기존 Merge Request을 상호 연결합니다. 각 배포의 연결된 Merge Request 디렉터리에는 cherry-pick된 Merge 커밋이 포함됩니다.

GitLab UI나 API 외부에서 cherry-pick된 커밋은 시스템 노트를 추가하지 않습니다.

관련 주제

문제 해결

cherry-pick할 때 다른 부모 커밋 선택하기

GitLab UI에서 Merge 커밋을 cherry-pick하면 기본 라인은 항상 첫 번째 부모입니다. 다른 라인을 사용하여 커밋을 cherry-pick하려면 명령줄을 사용하세요.

다음은 두 번째 부모를 사용하여 Merge 커밋을 cherry-pick하는 빠른 예제입니다: 

git cherry-pick -m 2 7a39eb0