[깃] 체리픽 (Cherry-pick) 🍒

체리픽

체리픽이란 하나 이상의 기존의 커밋의 변경 사항을 적용하여 새 커밋으로 기록하는 것이다. 브랜치에서 커밋을 선택하고 다른 브랜치에 적용하는 것이다.

체리픽 사용의 예

커밋을 잘못된 브랜치에 한 경우 해당 커밋을 체리픽하여 원하는 브랜치에 적용시킬 수 있다. 다른 레포지토리의 브랜치에 적용된 변경 사항들을 현재 레포지토리의 원하는 브랜치에 적용시킬 수 있다.

새로운 기능 개발 도중 버그를 발견한 경우 핫픽스를 위해 해당 버그를 수정한 변경 사항을 커밋으로 생성하면 메인 브랜치에서 해당 핫픽스 커밋을 체리픽하여 버그를 빠르게 수정할 수 있다.

체리픽 사용 시 주의사항

체리픽을 위해서는 HEAD 커밋 이후에 변경 사항이 없어야 한다. 또한 병합과 리베이스를 대체하기 위해 사용하는 것을 권장하지 않는다.

체리픽 시 병합 충돌이 발생하는 이유는 체리픽 대상 브랜치와 현재 브랜치가 분기된 이후 동일한 파일에 대한 수정이 발생했기 때문이며 이 경우 해당 체리픽 대상 커밋이 현재 브랜치에 형상이 다를 것이다.

여러 커밋들을 체리픽하는 도중 특정 체리픽에서 병합 충돌이 발생하는 경우는 현재까지 체리픽하여 커밋을 반영한 스냅샷(특정 체리픽 이전 스냅샷)을 기준으로 해당 파일을 변경해 가고 있기 때문이고 해당 파일이 특정 체리픽 대상 커밋에서 수정한 파일과 동일한 파일이기 때문이다. 예를 들어 최신화된 A 브랜치에 B 브랜치의 커밋을 체리픽 중이고, 체리픽 도중 병합 충돌이 발생하면 A 브랜치에 최신화된 소스를 선택하고, A 브랜치에 아직 반영되지 않은 소스는 B 브랜치의 소스를 선택한다. 그리고 체리픽 대상 커밋이 이전에 과거 시점의 A 브랜치를 B 브랜치에 병합한 병합 커밋이라면 해당 병합 커밋은 체리픽에서 제외한다.

병합 커밋

커밋은 부모 커밋을 가지지 않거나 하나 이상의 부모 커밋을 가질 수 있다. 병합 커밋이 발생하는 경우 해당 커밋은 두 개 이상의 부모 커밋을 가지게 된다.

현재 체크아웃한 병합 기준 브랜치인 A 브랜치에 병합 대상 브랜치인 B 브랜치를 병합하려고 하는 경우 A 브랜치의 병합 커밋 전 가장 최근 커밋이 첫번째 부모(first parent) 커밋이며 B 브랜치의 가장 최큰 커밋이 두번째 부모(second parent) 커밋이다.

A a1-a2-a3-a4
B   \b1-b2/

병합 커밋인 a4 커밋의 첫번째 부모는 a3 커밋이며 두번째 부모는 b2 커밋이다.

병합을 반대로 했다면? 다른 브랜치의 병합 커밋을 체리픽 했다면?

브랜치 A에 브랜치 B를 병합해야 하지만 반대로 브랜치 B에 브랜치 A를 병합하면 의도치 않게 브랜치 B에는 브랜치 A의 커밋들이 반영되게 된다.

C   /c1\
A a1-a2-a3\
B   \b1-b2-b3-b4-b5
B'   b1-b2-b4-b5

이 경우 병합 커밋(b3)으로 인해 브랜치 A에 포함된 커밋 중 다른 브랜치(브랜치 C)의 커밋(병합이 이루어진 경우)이 브랜치 B에 반영될 수도 있다. 또는 브랜치 A에서 수행한 병합 커밋(a3) 자체를 브랜치 B에서 체리픽한다면 마찬가지로 의도치 않게 브랜치 B에는 브랜치 A에 포함된 커밋 중 다른 브랜치(브랜치 C)의 커밋들이 반영될 수 있다.

이 경우 잘못 수행한 병합 커밋(또는 체리픽 커밋) 바로 이전의 커밋(b2 또는 a3)으로 리셋을 진행하고 새로운 브랜치로 체크아웃한 후 병합 커밋 다음 커밋들(b4, b5)을 체리픽하는 방법이 있다. 하지만 병합 커밋(b3)이 c1 커밋과 동일한 파일을 수정함으로써 발생하는 병합 충돌을 해결한 커밋이라면 이후 커밋을 체리픽할 때 병합 커밋 이후 커밋에는 이미 브랜치 B에 반영된 브랜치 C의 커밋으로 인한 소스 코드 반영이 있기 때문에 병합 충돌이 발생할 수 있으며 해당 커밋(c1)으로 인한 소스 코드 반영을 제거하는 병합 충돌 해결 과정이 추가로 필요하다.