Git 프로젝트 형상관리 첫걸음, 팀원별 브랜치 만드는 3가지 방법(GitHub, STS, Git Bash)

Git 프로젝트 형상관리 첫걸음, 팀원별 브랜치 만드는 3가지 방법(GitHub, STS, Git Bash)

 

웹 애플리케이션 개발 프로젝트를 진행하다 보면 가장 먼저 마주하는 난관은 코드 작성 그 자체가 아니라, 바로 '어떻게 코드를 합치고 관리할 것인가'에 대한 문제입니다. 특히 6명 이상의 팀원이 함께하는 프로젝트라면 형상관리의 중요성은 아무리 강조해도 지나치지 않습니다. 초기 프로젝트에서는 모든 팀원이 main branch 하나에 직접 소스를 커밋하고 푸시하는 방식을 사용하곤 합니다. 하지만 프로젝트 규모가 커지고 기능이 다양해질수록, 이 방식은 예기치 못한 코드 충돌(Conflict)과 소스 유실, 그리고 배포 환경의 불안전성이라는 큰 리스크를 안게 됩니다.

 

우리가 형상관리 도구인 Git을 사용하는 근본적인 이유는 단순히 코드를 저장하기 위함이 아니라, '안전하게 협업하기 위함' 입니다. 이를 위해 필요한 것이 바로 'Branch 전략'입니다. main 브랜치는 언제든 사용자에게 배포할 수 있는 '완성본'의 상태를 유지해야 하며, 모든 실험적인 코드와 개별 작업은 독립된 공간인 '개별 브랜치'에서 이루어져야 합니다. 팀장은 이 개별 작업들을 검토한 뒤 최종적으로 main에 합치는 역할을 수행함으로써 프로젝트의 전체적인 품질을 보장할 수 있습니다.

 

팀원 각자의 이니셜로 된 브랜치를 만들면, 내가 수정한 코드가 타인의 코드에 즉각적인 영향을 주지 않으므로 심리적 안정감을 가지고 개발에 집중할 수 있습니다. 또한 팀장은 누가 어떤 기능을 구현했는지 직관적으로 파악할 수 있어 관리 효율이 극대화됩니다. 많은 입문자가 Git을 어려워하는 이유는 환경마다 사용법이 조금씩 다르기 때문입니다. 그래서 개발 현장에 가장 많이 쓰이는 여러 방법들 중, 3가지 (GitHub 웹 사이트, STS(Eclipse), Git Bash 커맨드라인)를 통해 브랜치를 생성하는 방법에 대해서 가이드합니다. 

 

 

 

 

 

GitHub 사이트에서 브랜치 생성하기

 

가장 빠르고 간편한 방법으로, 저장소 관리자나 팀장이 원격지에 브랜치를 미리 생성해 둘 때 유용합니다.

 

1.  프로젝트에서 사용중인 Repository의 main 브랜치로 이동해주세요. 이동 후 main 브랜치 셀렉트 옆 'Branch'를 눌러주세요.

 

 

 

 

 

 

2.  'New branch' 버튼을 눌러주세요.

 

 

 

 

 

 

3.  New branch name 항목에 원하는 브랜치명을 작성 후, 'Create new branch' 버튼을 눌러주세요.

 

 

 

 

 

 

4.  브랜치명으로 작성한 'member1' 브랜치가 하위 브랜치로 생성되는걸 확인 할 수 있습니다.

 

 

 

 

 

 

5.  1-4번 방법 외에 또는 해당 Repository에서 'main' 브랜치 셀렉트 항목을 열어서 나타나는 검색란에 추가할 브랜치명을 입력 후, 아래로 출력되는 'Create branch member2 from main' 문구를 클릭하면 main 하위 브랜치로 입력한 member2 브랜치가 만들어집니다.

 

 

1-4번 방법으로도 하위 브랜치를 생성할 수 있고, 5번 방법으로도 간단하게 브랜치를 생성할 수 있습니다.

 

 

 

 

 

STS Git GUI로 브랜치 생성하기

 

IDE 환경을 벗어나지 않고 개발 흐름 안에서 브랜치를 만들고 싶을 때 사용하는 방법입니다.

 

1.  STS에서 Window > Show View > Other를 클릭합니다.

 

 

 

 

 

 

2.  'git'을 검색 후, Git Repositories View를 선택 후 Open 버튼을 클릭합니다.

 

 

 

 

 

 

3.  Git Repositories View가 열립니다.

 

 

 

 

 

 

4.  해당 Repository에 마우스 우 클릭후, Switch To > New Branch 버튼을 클릭합니다. 

 

 

 

 

 

 

5.  main 브랜치 하위로 새롭게 만들기 위해 'Select' 버튼을 클릭합니다.

 

 

 

 

 

 

6.  Remote Tracking항목의 'origin/main'을 선택 후, OK 버튼을 클릭합니다.

 

 

Source를선택하는 과정은 '어떤 시점의 코드를 복사해서 새 브랜치를 만들 것인지'를 결정하는 중요한 단계입니다. 

 

 🎈 중요!

1. Local (로컬)
- 현재 내 컴퓨터(Local)에 저장되어 있는 브랜치들을 기준으로 합니다.
- main 브랜치를 pull 받아서 내 컴퓨터에 최신 상태로 가지고 있다면, Local 아래의 refs/heads/main을 선택하면 됩니다.

2. Remote Tracking (원격 추적)
- 원격 저장소(GitHub)에 있는 브랜치 상태를 기준으로 합니다. 보통 origin/main 과 같은 형태로 표시됩니다.
- 내 로컬 main이 최신인지 확신할 수 없을 때, GitHub 서버에 있는 최신 main을 기준으로 만들고 싶다면 해당 항목을 선택하는 것이 가장 안전합니다.

3. Tags (태그)
- 커밋 기록 중 특정 시점에 찍어놓은 이정표를 기준으로 합니다.
- 현재 진행중인 코드가 아니라, 과거의 특정 출시 버전(Tag) 시점으로 돌아가서 브랜치를 만들어야 할 때 사용합니다. 

4. References (참조)
- Git의 내부적인 모든 참조 기록(HEAD, 기타 메타데이터 등)을 직접 선택하는 방식입니다.
- 일반적인 사용자보다는 Git의 구조를 깊게 다루는 고급 사용자가 특정 지점을 찾을 때 사용합니다.

 

 

 

 

 

7.  Source를 선택 후, Branch name 항목에 추가할 브랜치명을 입력 후 Finish 버튼을 클릭합니다.

 

 

 

 

 

 

8.  해당 Repository의 마우스 우 클릭 후, 'Push Branch member3...' 눌러 원격 저장소로 반영합니다.

 

 

 

 

 

 

9.  Remote, Branch 정보를 확인 후, Branch 항목에서 아까 만들었던 member3 브랜치를 입력하거나 아래 완성된 항목들 중 하나를 선택합니다. 선택 후, Push 버튼을 클릭합니다.

 

 

❓ Branch 항목에서 브랜치를 선택하면 'refs/heads/...' 라고 나오는데 잘못된 걸까요?

정상입니다! 'refs/heads/'는 Git이 브랜치를 관리하는 내부 폴더 경로라고 생각하면 됩니다. 'refs/heads/member3'는 member3라는 이름의 브랜치를 가리키는 위치의 표현이므로 GitHub에서는 member3라는 이름의 브랜치가 생성되는걸 확인할 수 있습니다.

 

 

 

 

 

10.  접속 정보를 입력 후, Log In 버튼을 클릭합니다.

 

 

 

 

 

 

11.  Push 메세지를 확인 후 Close 버튼을 클릭합니다.

 

 

 

 

 

 

12.  GitHub의 해당 Repository에서 Branch를 확인해보면 추가한 member3 브랜치가 생성된걸 확인할 수 있습니다.

 

 

 

 

 

 

Git Bash(Terminal) 명령어로 생성하기

 

명령어를 직접 입력하며 Git의 원리를 이해하는데 도움이 되며 가장 강력하고 정확한 방법입니다.

 

1.  Git Bash에서 해당 프로젝트 파일이 있는 위치로 이동해주세요. 그리고 main 브랜치로 전환 후, 최신 데이터 파일로 동기화를 진행합니다. (최신 업데이트)

 

 

# 사용 명령어
cd 999.NEW_CLASS/03.SPRING2\(STS4\)/workspace_spring2/GitPushTest01
git checkout main
git pull origin main

 

cd {프로젝트 파일 위치 경로}

- Git을 사용하기 위한 프로젝트 위치까지 cd 명령어를 이용해 이동합니다.

 

git checkout main

- 브랜치를 main으로 전환합니다.

 

git pull origin main

- 해당 프로젝트 파일을 원격 저장소에 저장되어 있는 최신 파일로의 동기화를 진행합니다. (업데이트)

 

🎈 중요!

Git 협업에서 가장 무서운 적은 '충돌(Conflict)'입니다. 본인이 어제 프로젝트를 내려받았더라도, 그 사이에 다른 팀원이 기능을 완성해서 main에 코드를 Commit & Push를 했을 수 있습니다. 그런 상태에서 내가 업데이트를 안한 어제의 파일을 수정 시, 충돌이 날 확률이 매우 높습니다. 따라서 새로운 작업을 시작하기 직전에 서버의 최신 상태를 내 컴퓨터로 가져와 동기화를 진행해야 합니다.  

 

 

 

 

 

2.  'git checkout -b member4' 명령어로 새로운 브랜치 member4를 만들고 진입합니다.

 

 

# 사용 명령어
git checkout -b member4

 

git checkout -b member4

- 새로운 브랜치 member4를 만들겠다는 명령어입니다. 이때, '-b' 옵션은 Branch의 약자로 브랜치 생성과 checkout 명령어로 이동을 동시에 수행하라는 명령어입니다.

 

 

 

 

 

3.  'git push origin member4' 명령어로 새롭게 만든 member4 브랜치를 main 브랜치 하위로 push합니다.

 

 

# 사용 명령어
git push origin member4

 

git push origin member4

- 내 Local에 있는 member4 브랜치를 원격 저장소에 반영하겠다는 명령어입니다.

 

 

 

 

 

4.  새롭게 추가된 member4 브랜치를 확인할 수 있습니다.

 

 

 

 

 

 

@Junesker

---