5.브랜치 병합

5-1.빠른 전진 병합

브랜치 병합 실습은 결과를 잘 살펴 봐야 효과를 정확히 알 수 있다. 소스 구조가 복잡하면 상황 파악이 어려우니 간단한 프로젝트를 따로 만들어 실습해 보자. 직접 실습해 보는게 제일 확실하지만 시간과 체력이 많이 소모된다. 그래서 깃을 대충 배우기는 쉬워도 확실히 경험해 보기가 어렵다.

정 귀찮고 시간이 없다면 읽기만 하되 과정을 자세히 보고 내부적인 동작을 상상해 보자. 새 프로젝트를 만들 때는 항상 루트인 StudyGit 폴더에서 명령을 내려야 한다. 프롬프트에 game (main)라고 되어 있는 상태에서는 깃 폴더를 또 만들어서는 안되므로 상위 디렉토리로 이동한다.

 

soen@SoenDesk MINGW64 /c/StudyGit/game (main)

$ cd ..

 

soen@SoenDesk MINGW64 /c/StudyGit

$ git init merge1;cd merge1

Initialized empty Git repository in C:/StudyGit/merge1/.git/

 

상위 디렉토리는 깃 폴더가 아니므로 (main) 브랜치 표시가 나타나지 않는다. merge1 프로젝트를 만들고 폴더 안으로 들어간다. main.txt 파일을 생성하고 다음 내용을 입력한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받아 화면에 표시

 

텍스트 편집기를 만든다고 치고 문자를 입력받아 화면에 표시하는 의사 코드를 작성했다. 스테이지에 올리고 커밋한다.

 

$ git add main.txt;git commit -m "입력받은 문자 표시"

 

현재 main 브랜치에 커밋 하나만 있다. 편집기는 긴 문자열이 오른쪽 끝에 닿으면 다음 줄로 자동개행(WordWrap)하는데 이 논리가 굉장히 복잡하고 정교하다. 제대로 만드는데 시간이 많이 걸리므로 별도의 sub 브랜치를 만들어 테스트해 보자.

 

$ git branch sub;git switch sub

 

브랜치 생성과 스위칭을 한번에 수행했다. sub 브랜치 안에 sub.txt 파일을 만들고 다음 내용을 작성한다.

 

문장의 오른쪽 끝을 찾아 자동 개행

 

문장 정렬 로직은 굉장히 길고 옵션도 많지만 의사코드로 간단하게 구현한 척 했다. 저장한 후 커밋한다.

 

$ git add sub.txt;git commit -m "자동개행 정렬"

 

main에는 문자 입력 기능, sub에는 정렬 기능을 작성했다. 브랜치별로 어떤 기능을 커밋했는지 로그를 로그를 찍어 보자.

 

$ git log --branches --oneline

59aa3b0 (HEAD -> sub) 자동개행 정렬

1803135 (main) 입력받은 문자 표시

 

여기까지의 작업 과정은 다음 실습에도 똑같이 활용하니 merge1 디렉토리를 merge_bak 이름으로 백업해 두자. 두 브랜치를 나누어 놓은 상황 전체를 저장해 두는 것이다. 처음부터 새로 만들어도 상관없지만 백업해 두면 실습이 빨라지고 여러 번 반복해 볼 수 있다. 현재 프로젝트의 상황을 정리해 보자.

정렬 기능을 테스트해 보니 별 문제없고 그대로 써도 될 거 같다. 시범적인 기능을 브랜치로 분기하여 꼼꼼히 테스트하고 합격 판정을 내린 상황이다. sub 브랜치를 병합하기 위해 병합을 받을 main 브랜치로 이동한다.

 

$ git switch main

Switched to branch 'main'

 

main으로 온 후 워킹트리를 보면 sub.txt는 없다. 이 브랜치에서 만든 기능이 아니니 당연하다. merge 명령으로 sub 브랜치를 병합하면 sub.txt가 main 브랜치의 워킹트리로 들어온다.

 

$ git merge sub

Updating 1803135..59aa3b0

Fast-forward

 sub.txt | 2 ++

 1 file changed, 2 insertions(+)

 create mode 100644 sub.txt

 

이 유형의 병합이 가장 간단한 예이다. 각 브랜치는 각자의 파일을 가지며 자신의 파일만 수정했다. 충돌이 전혀 없어 sub의 마지막 커밋을 main이 가리키기만 하면 된다. 로그를 찍어 보면 main이 가리키는 포인트만 달라졌으며 새로운 커밋이 생긴 것은 아니다. 따라서 커밋 메시지를 입력할 필요도 없다.

 

$ git log --branches --oneline

1c73a6d (HEAD -> main, sub) 자동개행 정렬

2ea5cf6 입력받은 문자 표시

 

HEAD가 sub를 가리키다가 병합 후 main과 sub를 모두 가리키고 있다. 내부적으로 커밋 포인트만 조작하면 되니 말썽을 일으킬 여지가 없다. 이런 유형을 Fast-forward(빠른 전진) 병합이라고 하며 가장 쉬운 예이다.

sub를 main에 병합했다고 해서 sub가 사라지는 것은 아니다. git branch로 확인해 보면 sub가 아직 남아 있다. 병합 직후에 두 브랜치의 최종 커밋이 같을 뿐이며 지금부터 또 다르게 진행할 수도 있다. 중간 점검 결과를 main에 넘겨주고 더 새로운 알고리즘을 계속 테스트해 봐도 된다.

브랜치를 삭제하려면 -d 옵션을 사용한다. 브랜치를 지운 후 git branch 명령을 내려보면 sub 브랜치는 보이지 않는다. 그냥 둬도 되지만 병합 후 딱히 더 필요치 않다면 지워 버리는 것도 깔끔하다.

 

$ git branch -d sub

Deleted branch sub (was 77f6d6c).

 

내부적으로는 실제로 지우지 않고 숨겨서 지운 척만 한다. 어쨌든 목록에는 안 보이므로 지운 것과 효과는 비슷하다. 만약 이후에 같은 이름으로 브랜치를 다시 만들면 이전의 브랜치가 다시 부활한다. 깃은 프로젝트의 모든 것을 저장하는 것이 본연의 임무여서 지운 기록까지도 저장한다.

5-2.일반적인 병합

다음은 조금 더 복잡한 상황을 실습해 보자. 앞 실습에 사용했던 merge1 프로젝트는 이미 병합을 해 버렸기 때문에 다른 유형의 실습을 할 수 없다. 새로운 상황을 만들기 위해 merge2 프로젝트를 만들되 merge1의 실습 과정을 그대로 따라하여 sub를 만든 상황까지 재현한다.

merge_bak 폴더를 백업해 두었다면 이 안에 병합 직전의 상황이 고스란히 들어 있으므로 merge2로 사본을 떠 실습을 계속하면 된다. sub.txt에 정렬 기능을 작성한 상태에서 main으로 스위칭하여 코드를 한줄 더 작성한다. sub 브랜치 개발팀이 정렬 루틴을 작성하는동안 main 개발팀이 마우스로 편집 위치를 이동하는 기능을 작성했다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받아 화면에 표시

마우스로 클릭한 곳으로 이동

 

두 브랜치가 병렬 진행하고 있는 상황이다. sub에서 작업하고 있는동안 main이 놀고 있을 수는 없으니 이런 상황은 흔하게 발생한다. 이동 기능 작성 후 커밋한다.

 

$ git commit -am "클릭 위치로 이동"

 

브랜치한 후에 main도 바뀌었다. merge1과는 상황이 다른데 로그를 찍어 보면 어떤 차이가 있는지 알 수 있다.

 

$ git log --branches --oneline

6054d30 (HEAD -> main) 클릭 위치로 이동

a8d555a (sub) 자동개행 정렬

86b8efb 입력받은 문자 표시

 

이 상황에서 병합해 보자. 상황이 달라도 병합하는 명령은 같다. 이미 main 브랜치에 와 있으니 명령만 내리면 된다.

 

$ git merge sub

 

병합하기 전에 병합에 대한 메시지를 입력하는 편집기가 뜨며 Merge branch 'sub' 라고 미리 입력되어 있다. 편집기에 병합에 대한 상세한 메시지를 입력하고 저장 후 메모장을 닫으면 병합이 완료된다.

Merge made by the 'ort' strategy.

 sub.txt | 2 ++

 1 file changed, 2 insertions(+)

 create mode 100644 sub.txt

 

merge1과는 메시지가 다른데 Fast-forward 대신 ort 작전을 쓴다고 되어 있다. sub를 작성하는동안 main도 작업이 진척되어 포인트만 옮겨 병합할 수 없고 main에서 이후에 작성한 클릭이동 기능을 보전한 채로 병합해야 한다. 로그를 찍어 보자.

 

$ git log --branches --oneline

292ab56 (HEAD -> main) Merge branch 'sub' 위치이동 기능 작성 후 정렬 기능 병합

6054d30 클릭 위치로 이동

a8d555a (sub) 자동개행 정렬

86b8efb 입력받은 문자 표시

 

병합에 의해 sub 브랜치의 코드를 가져와 main에 써 넣는 구체적인 처리를 해야 하며 저장소에 변화가 발생한다. 그래서 병합도 하나의 커밋으로 표시되며 따라서 메시지도 입력해야 한다. 그러나 아직 각자의 파일을 편집한 것이어서 충돌은 없다.

5-3.자동 병합

이번에는 더 복잡한 예로 같은 파일을 양쪽 브랜치에서 동시에 수정해 보자. 이것도 여러 케이스로 나뉜다. merge3 프로젝트를 시작한다.

 

$ git init merge3;cd merge3

 

main.txt에 다음 소스 작성를 작성한다. 정확한 상황을 만들기 위해 제일 마지막줄에 빈줄 넣지 않도록 주의한다. 7줄이 아니라 6줄이다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받아 화면에 표시

마우스로 클릭한 곳으로 이동

 

옵션창 열기

옵션 변경시 적용

 

마지막에 개행하고 새 줄에 코드를 작성하면 추가이지만 원래 빈줄이 있었으면 수정이라 결과가 다르게 나타난다. 초기 커밋한다.

 

$ git add main.txt;git commit -m "문자입력, 옵션창 열기"

 

이 상태에서 메인 개발팀이 바빠 다른 팀에게 옵션 변경 관련 작업을 맡기기로 했다고 하자. git branch sub 명령으로 sub 브랜치를 만들어 둔다. 아직 스위칭은 하지 않고 메인 개발팀은 main에서 소스를 계속 수정한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받아 화면에 표시

키보드 커서키로 이동 처리

마우스로 클릭한 곳으로 이동

 

옵션창 열기

옵션 변경시 적용

 

편집 코드에 커서키로 이동하는 처리를 추가하고 커밋한다.

 

$ git commit -am "커서키 이동 처리"

 

메인 팀이 이 작업을 하고 있는 동안 서브 팀은 옵션 관련 코드를 작성한다. git switch sub 명령으로 sub로 스위칭하면 커서키 이동 처리 코드가 사라진다. 아래쪽에 새 줄을 만들고 옵션 관련 코드를 작성한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받아 화면에 표시

마우스로 클릭한 곳으로 이동

 

옵션창 열기

옵션 변경시 적용

권장값 적용시 모든 옵션 리셋

 

같은 파일의 아래, 위 다른 부분을 두 팀이 브랜치를 나누어 수정하고 있는 상황이다. 커밋하고 main로 돌아와 로그를 찍어 현재 상황을 확인한다.  

 

$ git commit -am "권장 옵션 리셋"

$ git switch main

$ git log --branches --oneline

0678c6a (sub) 권장 옵션 리셋

93e0c94 (HEAD -> main) 커서키 이동 처리

ebd86fc 문자입력, 옵션창 열기

 

일일이 이 상황을 만들기 번거롭지만 현재 상황을 정확히 파악해야 한다. HEAD는 main를 가리키고 있고 두 브랜치 모두 각각 수정한 내역이 있다. 이 상태에서 sub를 병합하면 메시지 입력창이 뜬다. 메시지를 작성해서 저장하면 자동 병합이 완료된다.

$ git merge sub

Auto-merging main.txt

hint: Waiting for your editor to close the file... unix2dos: converting file C:/StudyGit/merge3/.git/MERGE_MSG to DOS format...

dos2unix: converting file C:/StudyGit/merge3/.git/MERGE_MSG to Unix format...

Merge made by the 'ort' strategy.

 main.txt | 3 ++-

 1 file changed, 2 insertions(+), 1 deletion(-)

 

각 팀이 같은 파일을 두 군데서 수정했지만 위치가 다르기 때문에 자동 병합에 문제가 없다. 같은 소스를 수정하더라도 팀마다 맡은 부분이 다르기 때문에 같은 위치를 동시에 수정하지는 않는다. 병합 결과는 이렇다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받아 화면에 표시

키보드 커서키로 이동 처리

마우스로 클릭한 곳으로 이동

 

옵션창 열기

옵션 변경시 적용

권장값 적용시 모든 옵션 리셋

 

커서키로 이동하는 처리와 옵션을 리셋하는 코드가 제대로 들어와 있다. 로그를 찍어 보자. 병합 기록 메시지까지 잘 들어가 있다.

 

$ git log --branches --oneline

53621da (HEAD -> main) Merge branch 'sub' 옵션 변경에 리셋 기능 추가한 거 병합

a333cd0 (sub) 권장 옵션 리셋

0960bc3 커서키 이동 처리

7746579 문자입력, 옵션창 열기

 

 

깃이 어떤 알고리즘으로 이 병합을 수행하는지는 어렴풋이 짐작할 수 있다. 두 브랜치의 수정 내역을 보고 변경 위치가 겹치지 않음을 발견하고 각 위치의 수정 사항만 지능적으로 가져온 것이다. 이런 경우는 자동 병합이 가능하다.

5-4.수동 병합

다음은 같은 파일의 같은 부분을 수정했을 때를 실험해 보자. 이게 제일 골치 아픈 경우이다. merge3 프로젝트를 이어서 실습해도 되겠지만 의도적으로 만들어 내는 상황이다 보니 새로 프로젝트를 만드는게 간편하다. merge4 프로젝트를 만들고 main.txt에 다음 코드를 작성한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받음

파란 바탕에 흰 글자로 출력

 

문자를 입력받아 출력하는 코드를 작성하고 커밋한다. sub 브랜치를 만들고 이 브랜치에서 main.txt를 다음과 같이 수정한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받음

검정 배경에 노란 글자로 출력

폰트 크기 12pt로 확대

 

글자색을 바꾸고 폰트 크기도 약간 키우는 코드를 작성하여 커밋한다. main으로 돌아와 로그를 확인해 보자.

 

$ git switch main

$ git log --branches --oneline

77f6d6c (sub) 검정 배경 노란색 큰 글자

903d692 (HEAD -> main) 파란 배경 흰글자

8e69c0f 문자입력

 

두 팀이 사용하는 글자 색상이 다르다. 팀끼리 의사소통이 잘 안되서 그럴 수도 있고 설마 저쪽에서 이 부분을 고쳤겠어 하는 안이한 생각에 실수하는 경우도 있다. 이런 경우는 잘 발생하지 않지만 어쨌거나 발생 가능성은 있다. 이 상태에서 병합해 보자.

 

$ git merge sub

Auto-merging main.txt

CONFLICT (content): Merge conflict in main.txt

Automatic merge failed; fix conflicts and then commit the result.

 

main.txt에서 충돌이 발생했다는 보고서가 나타나며 자동 병합을 할 수 없으니 충돌을 먼저 해결하라고 권한다. 같은 부분을 동시에 편집한 상황이 충돌(conflict)이며 프로그램이 둘 중 하나를 임의로 선택할 수 없다.

한팀은 파란색 배경, 한팀은 검정색 배경을 사용하라고 하니 두 말을 다 들어줄 수가 없는 상황이다. 대신 깃은 main.txt에 어디서 충돌이 발생했는지 자세히 표시해 주는데 이걸 잘 읽을 줄 알아야 한다. 이 파일을 열어 보고 취사 선택을 해야 한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받음

<<<<<<< HEAD

파란 바탕에 흰 글자로 출력

=======

검정 배경에 노란 글자로 출력

폰트 크기 12pt로 확대

>>>>>>> sub

 

HEAD에는 이 위치에 파란 바탕에 흰 글자 코드가 있다. sub에는 검정 배경에 노란 글자와 폰트 크기 12pt 확대 코드가 있다. 자동 병합은 불가능하니 어떤게 맞는지 선택하라는 의미에서 각 브랜치의 다른 부분을 보여준다. 깃이 소스에 메시지를 남겨 놓아 이 상태로는 컴파일할 수 없으며 어떡하든 문제를 해결해야 한다.

이럴 때는 보통 충돌을 만든 두 팀이 회의를 하여 둘 중 하나를 취사 선택하는데 의견이 맞지 않으면 싸워서라도 하나를 결정하거나 최소한 타협이라도 해야 한다. 예를 들어 색상은 우리걸로 하되 글꼴을 확대한 것은 마음에 든다면 이 코드만 받아 들이면 된다. 다음과 같이 수정한다.

 

텍스트 편집기 프로젝트

사용자로부터 문자 입력받음

파란 바탕에 흰 글자로 출력

폰트 크기 12pt로 확대

 

색상은 메인팀의 것을 쓰고 글꼴 크기는 서브팀의 것을 채용했다. 충돌난 부분을 수동으로 병합한 것이다. 이것도 변화이므로 커밋해야 한다.

 

$ git commit -am "글꼴 크기만 확대"

$ git log --branches --oneline

56010a7 (HEAD -> main) 글꼴 크기만 확대

77f6d6c (sub) 검정 배경 노란색 큰 글자

903d692 파란 배경 흰글자

8e69c0f 문자입력

 

수동 병합은 이런 식이다. 사람이 작성한 코드를 툴이 함부로 결정할 수 없으니 차이점만 정리해 주고 책임을 떠 넘긴다. 충돌을 만든 주체가 사람이니 결국 사람이 결정해야 한다. 이걸 도와주는 소스 비교툴이 잘 만들어져 있다.

아무리 툴이 잘 만들어져 있어도 소스가 대규모로 바뀐 상태에서 충돌이 발생하면 병합이 쉽지 않다. 그래서 병합을 잘 하기보다는 애초에 같은 부분을 동시에 건드리지 않도록 브랜치를 잘 나누어야 한다. 아무리 잘 나누어도 불가피하게 충돌이 발생할 가능성은 항상 있지만 최소화할 수는 있다.

여러 파일을 동시에 수정하면 자동 병합과 충돌 병합이 동시에 일어나기도 한다. 자동 병합이 되는 파일은 그대로 받아 들이면 되고 충돌이 발생한 파일은 수동으로 해결한 후 커밋한다. 이런 상황을 문제없이 잘 해결하려면 풍부한 경험이 필요하며 명령의 효과를 정확히 알고 있어야 한다.

git의 병합은 기계적이고 단순하다. 줄 단위로 비교하여 원론적이지만 조금만 바뀌어도 민감하게 비교한다. 예를 들어 빈줄이나 들여쓰기도 다 바뀐 것으로 판단한다. 이보다 더 편리하고 지능적인 비교, 병합툴이 많이 발표되어 있으니 적극 활용해 보자.

5-5.체리픽

병합은 보통 두 브랜치의 마지막 커밋을 합치는데 비해 체리픽은 중간쯤의 커밋을 병합하는 방법이다. 체리픽이 꼭 필요한 상황을 만들기 번거로운데 최대한 간단하게 만들어 보자. 프로젝트를 시작한다.

 

$ git init merge5;cd merge5

 

main.txt 파일을 만들고 앞으로 작성할 기능 목록을 입력한다.

 

메인 기능

1.

2.

3.

 

서브 기능

1.

2.

3.

 

이 상태로 커밋한다.

 

$ git add .;git commit -m "프로젝트 시작"

 

팀원이 부족해서 서브 기능은 별도의 팀에게 시키기로 하고 git branch sub 명령으로 브랜치를 분기해 둔다. 일거리를 떼 줬으니 이제 위쪽의 메인 기능만 열심히 작성하면 된다. 두번째 줄을 작성한다.

 

메인 기능

1.텍스트 편집기 프로젝트

 

커밋한다.

 

$ git commit -am "텍스트 편집기 제작"

 

서브팀은 기능을 하나씩 작성해 나간다. git switch sub로 전환한 후 서브 기능을 작성한다. 일단 하나 만들어 보자.

 

서브 기능

1.sub1

2.

3.

 

커밋한다.

 

$ git commit -am "sub1 기능 작성"

 

같은 방법으로 2.sub2, 3.sub3을 한줄씩 넣으면서 각각 커밋한다. 넘겨받은 일거리를 하나씩 완수하는 중이다. main으로 돌아와 로그를 출력해 보자.

 

$ git switch main;git log --branches --oneline

Switched to branch 'main'

60e5cd1 (sub) sub3 기능 작성

cd0b192 sub2 기능 작성

4c17ceb sub1 기능 작성

7dde427 (HEAD -> main) 텍스트 편집기 제작

82d7fde 프로젝트 시작

 

서브팀의 일이 진행되는 상황을 확인할 수 있다. 그러나 main.txt에는 아직 서브 기능이 병합되어 있지 않다. 이 기능을 가져오되 sub3은 아직 시범적인 기능이라 불안하고 완성된 sub2까지만 병합하고 싶다고 하자. 이때 cherry-pick 명령을 사용하며 병합할 커밋의 해시값을 지정한다.

 

$ git cherry-pick cd0b192

Auto-merging main.txt

CONFLICT (content): Merge conflict in main.txt

error: could not apply cd0b192... sub2 기능 작성

hint: After resolving the conflicts, mark them with

hint: "git add/rm <pathspec>", then run

hint: "git cherry-pick --continue".

hint: You can instead skip this commit with "git cherry-pick --skip".

hint: To abort and get back to the state before "git cherry-pick",

hint: run "git cherry-pick --abort".

hint: Disable this message with "git config advice.mergeConflict false"

 

한 파일에 코드를 작성하다 보니 충돌이 발생했는데 줄이 달라 수동 병합하기 어렵지 않다. 일부만 병합하라고 지시했으니 충돌 목록에도 sub2까지만 병합해 놓았다.

 

메인 기능

1.텍스트 편집기 프로젝트

2.

3.

 

서브 기능

<<<<<<< HEAD

1.

2.

=======

1.sub1

2.sub2

>>>>>>> cd0b192 (sub2 기능 작성)

3.

메인 기능

1.텍스트 편집기 프로젝트

2.

3.

 

서브 기능

1.sub1

2.sub2

3.

 

main에서 빈 번호였던 부분을 지우고 sub에서 구현한 sub1, sub를 채택하여 충돌을 수동 해결한다. 마지막으로 커밋하면 병합이 완료된다.

 

$ git commit -am "sub2까지만 병합"

 

완전히 분리된 파일에서 작업한다면 충돌없이 병합될 것이다. 그 상황을 예제로 만들기 번거로와 한 파일에서 실습했다.