💡 trunk, branch, merge

trunk ?
소스의 주 개발 작업을 진행하는 폴더

branch ?
소스의 현재 버전을 유지보수하고, 현재 버전을 기반으로 차기 버전을 개발하는 경우 사용하는 폴더

merge ?
branch 소스 개발이 완료가 되면 trunk나 다른 branch와 합치는 작업

branching

Project SVN Checkout

먼저 프로젝트 폴더를 SVN Checkout 받는다.
우리는 대부분 trunk 위치까지 Checkout 받아 눈으로 확인할 수 없었지만, 프로젝트 폴더 하위에는 아래와 같이 세 개의 폴더가 있는 것을 확인할 수 있다.

branch 생성, branching

trunk 폴더 마우스 우클릭 > TortoiseSVN > Branch/tag To Path 입력 칸 우측에 ... 을 클릭해준다.

그러면 창이 하나 뜨는데, URL 입력 칸에 branches 폴더 하위에 자신이 생성할 branch의 이름을 적고 OK 버튼을 클릭한다. Ex) ~/branches/gwpark

다시 메인 창으로 돌아와 로그 메시지를 작성하고, 복사할 repository revision을 결정한다.

1. branch 생성 로그 남기는 용도
2. copy할 저장소(trunk)의 revision 지정
   2-1. HEAD revision in the repository - trunk의 최종 revision
   2-2. Specific revision in repository - 입력한 revision (Show Log 버튼으로 revision이력 확인 가능)

그 다음, SVN Update 해주면 아래와 같이 trunk 하위 폴더 및 파일들이 모두 copy 되어 생성한 branch 하위에 추가되는 것을 확인할 수 있다.

merging

IDE에서 branch 소스 수정 작업을 마치고, 수정 내용을 commit 한다.

merge 작업 이전에는 반드시 trunk와 branch 모두 변경 사항 없이 commit 된 상태여야 한다.

TortoiseSVN > Merge..

Merge type을 선택하는 단계다. 이는 아래 내용을 참고해서 선택하면 된다.
대부분의 경우 Merge two different trees 타입으로 지정하면 될 것이다.

💡 merge type !!

• Merge a range of revisions
  branch 소스를 수정하고 해당 변경 사항을 다른 branch(혹은 trunk)로 이식하는 경우
  
  [FROM] branch A의 revision 1 [TO] branch A의 revision 7 로 잡았다고 가정 → branch A의 revision 1~7까지의 변경 사항을 다른 brunch나 trunk에 merge
  
  
• Merge two different trees
  branch에서 수정된 소스를 trunk에 동일하게 적용하는 경우
  
  [FROM] trunk의 Head revision [TO] branch의 Head revision → trunk의 최종 버전과 branch의 최종 버전을 merge

From URL - trunk 폴더 위치, To URL - branch 폴더 위치로 잡고 merge하고자 하는 각각의 revision을 선택한다.

아래 창은 merge의 옵션을 선택하는 단계인데, 별도의 옵션 선택이 필요 없을 것이므로 아래 Merge 버튼을 클릭해 merge를 진행한다.

merge 작업이 아래와 같이 완료되었다.
trunk 소스를 살펴봤을 때, branch에서 수정했던 내용이 동일하게 적용된 것을 확인했다면 성공적으로 merge가 이루어진 것이다.

최종적으로, merge가 완료된 trunk 소스를 commit하여 SVN 서버에 반영해준다.

On IntelliJ

IntelliJ에서도 branching, merging과 같은 작업들이 가능하다.

1. 프로젝트 우클릭 > Subversion > Branch or Tag
   • Base URL : SVN 서버에서 브랜치를 저장할 경로
   • Name : 브랜치명
   

2. 상단 SVN > Update Project에서 branch 프로젝트로 들어간다.
   

3. 소스 수정 후 commit하면 SVN 서버의 해당 branch에서만 소스가 변경된다.

4. 다시 SVN > Update Project에서 trunk 프로젝트로 들어간다.

5. 프로젝트 우클릭 > Subversion > Integrate Directory 클릭해서 수정 작업한 branch를 trunk로 병합한다.
   

6. trunk 소스를 SVN 서버에 commit 한다.
   
   

On Eclipse

Eclipse 상에서 branch 프로젝트와 trunk 프로젝트 간의 소스 관리 방식에는 크게 두 가지가 있다. 첫 번째로 branch를 생성만 하고 trunk 프로젝트와 branch 프로젝트를 서로 Switch 시켜 관리하는 방식이 있고, 두 번째로 branch 프로젝트를 새로 checkout 받아 관리하는 방식이 있다.

일단 branch 생성 과정은 이와 관계 없이 동일하게 진행한다.

• branch를 생성할 프로젝트 마우스 오른쪽 클릭 > Team > Branch
  

• 생성할 branch명을 입력하고, copy 방법을 선택하여 새로운 branch를 생성한다.
  

• Use the working copy as it is : 해당 Local의 프로젝트 소스로 branch 생성

• Use the repository version : SVN 버전 중에 선택해 branch 생성

여기서부터 관리 방식에 따라 전개 과정이 달라진다.

Switch

1. branch를 생성할 프로젝트 마우스 오른쪽 클릭 > Team > Switch
   

2. URL에 생성한 branch 경로를 찾아 입력한다.
   

3. Switch 작업이 완료되면 아래와 같이 branch 프로젝트로 바뀌게 된다.
   

4. branch 프로젝트에서 필요한 작업을 진행한다.

   branch의 소스 코드를 수정했으면 commit하여 branch별로 버전 관리를 해줘야 한다. 만약 commit하지 않는 경우 원치 않는 내용이 trunk 소스에 적용될 수 있다. 이 점을 반드시 유의하자.

5. branch 프로젝트의 소스 수정이 완료되었다면, 프로젝트를 trunk로 변경한다.

6. 프로젝트 마우스 오른쪽 클릭 > Team > Merge
   

7. URL에 merge하고자 하는 branch의 주소를 입력하고 OK 버튼을 클릭한다.
   

8. branch에서 변경된 내역이 아래와 같이 표시되고, 수정된 코드를 확인하고 싶다면 해당 파일을 클릭하여 볼 수 있다.
   

9. 표시된 내역 중 merge 시키고 싶은 내역만 마우스 우클릭해 Accept하면 병합이 완료된다.

충돌이 발생한 파일은 Override and Update 해줘 기존의 trunk 소스를 branch 소스로 덮어 씌워주거나 코드를 알맞게 수정하고 resolve 시킨 후 진행하면 정상적으로 병합이 완료된다.

10. 최종적으로 trunk의 소스를 commit하여 SVN Server에 반영한다.
    
    

Branch Checkout

SVN Reposiotry를 refresh 시킨 후 확인해보면 branches 하위에 생성한 branch가 생겨있는 것을 확인할 수 있다.

1. 해당 branch를 Checkout 받는다.
   

아래와 같이 branch 프로젝트가 Project Explorer 탭에 나타나고, 저장 영역이
다른 것을 확인할 수 있다.

2. branch 프로젝트에서 필요한 작업을 진행하고 commit한다.

   이 때, trunk 프로젝트와는 별개로 branch 영역에 commit이 된다. 하지만 같은 프로젝트처럼 revision이 이어서 올라가는 것을 확인할 수 있다.

3. 이후에 merge 작업 전개 과정은 Switch 방식과 동일하다. (Switch 6번부터 참고)