Git Flow 완벽 정리: 협업과 배포를 위한 Git 브랜치 전략

Git Flow는 기능 개발, 배포, 유지보수 등의 작업을 효율적으로 관리할 수 있도록 설계된 Git 브랜치 전략입니다.

특히, 팀 프로젝트나 지속적인 배포(CI/CD) 환경에서 유용하게 활용됩니다.

 

---

1. Git Flow의 핵심 개념

Git Flow에서는 총 5가지 주요 브랜치를 사용하여 코드 변경을 효과적으로 관리합니다.

✅ Main 브랜치 (main or master)

• 배포(Release)된 최종 안정적인 코드가 있는 브랜치
• 직접 수정하지 않으며, develop 브랜치에서 검증된 코드만 병합됨

✅ Develop 브랜치 (develop)

• 기능 개발을 진행하는 브랜치
• feature 브랜치에서 개발된 코드가 머지되며, 이 브랜치를 기준으로 release 브랜치가 생성됨

✅ Feature 브랜치 (feature/)

• 새로운 기능을 개발할 때 사용하는 브랜치
• develop 브랜치에서 분기하며, 개발 완료 후 develop 브랜치에 병합
• 브랜치 명명 규칙: feature/기능명 (예: feature/login-api)

✅ Release 브랜치 (release/)

• 배포 전 테스트 및 버그 수정을 담당하는 브랜치
• develop 브랜치에서 분기하며, 안정화 후 main 브랜치에 병합
• 브랜치 명명 규칙: release/버전명 (예: release/v1.0.0)

✅ Hotfix 브랜치 (hotfix/)

• main 브랜치에서 발견된 긴급한 버그를 수정하는 브랜치
• main 브랜치에서 직접 분기하고, 수정 완료 후 main과 develop에 병합
• 브랜치 명명 규칙: hotfix/버그명 (예: hotfix/critical-bug)

---

2. Git Flow 브랜치 흐름 예시

🔹 기능 개발 (Feature 브랜치)

git checkout develop
git checkout -b feature/login-api

# 개발 후 커밋 및 병합
git add .
git commit -m "로그인 API 개발 완료"
git checkout develop
git merge feature/login-api

# feature 브랜치 삭제
git branch -d feature/login-api

🔹 릴리즈 준비 (Release 브랜치)

git checkout develop
git checkout -b release/v1.0.0

git add .
git commit -m "버그 수정 및 배포 준비 완료"

git checkout main
git merge release/v1.0.0
git checkout develop
git merge release/v1.0.0

# release 브랜치 삭제
git branch -d release/v1.0.0

🔹 긴급 버그 수정 (Hotfix 브랜치)

git checkout main
git checkout -b hotfix/critical-bug

git add .
git commit -m "긴급 버그 수정 완료"

git checkout main
git merge hotfix/critical-bug
git checkout develop
git merge hotfix/critical-bug

# hotfix 브랜치 삭제
git branch -d hotfix/critical-bug

 

---

3. Git Flow 플러그인을 활용한 간편한 관리

🔹 Git Flow 플러그인 설치 및 초기화

git flow init

🔹 기능 개발 (Feature Start & Finish)

git flow feature start login-api
git flow feature finish login-api

🔹 릴리즈 준비 및 완료 (Release Start & Finish)

git flow release start v1.0.0
git flow release finish v1.0.0

🔹 긴급 버그 수정 (Hotfix Start & Finish)

git flow hotfix start critical-bug
git flow hotfix finish critical-bug

 

---

4. Git Flow vs GitHub Flow 비교

특징	Git Flow	GitHub Flow
브랜치 구조	main, develop, feature, release, hotfix	main, feature
주요 사용 목적	안정적인 릴리스 관리 (대규모 프로젝트)	빠른 배포와 단순한 개발 (소규모 프로젝트)
배포 방식	release 브랜치를 통해 배포	main 브랜치에서 직접 배포
협업 방식	기능 개발 후 develop으로 병합, 이후 release → main	기능 개발 후 바로 main에 병합
사용 환경	엔터프라이즈, 장기 유지보수 프로젝트	스타트업, 빠른 배포가 필요한 서비스
장점	명확한 브랜치 관리, 버전별 유지보수 가능	단순한 브랜치 구조, 빠른 배포 가능
단점	브랜치가 많아 복잡할 수 있음	장기 유지보수에는 불리함

 

---

5. Git Flow vs GitHub Flow, 어떤 걸 선택할까?

✅ Git Flow 추천

• 장기 유지보수가 필요한 프로젝트
• 여러 명의 개발자가 협업하는 환경
• 배포 전 철저한 검증이 필요한 프로젝트

✅ GitHub Flow 추천

• 빠른 배포가 중요한 프로젝트
• 스타트업, 애자일(Agile) 개발 방식
• 소규모 팀에서 협업하는 프로젝트

💡 결론: 작은 프로젝트나 MVP 개발이라면 GitHub Flow가 더 적합하고,

규모가 크고 협업이 필요한 프로젝트라면 Git Flow를 선택하는 것이 좋습니다.

 

---

6. 마무리

Git Flow는 기능 개발, 배포, 유지보수 등 프로젝트의 흐름을 체계적으로 관리할 수 있도록 도와주는 브랜치 전략입니다.

하지만 프로젝트 규모와 팀의 개발 방식에 따라 적절한 전략을 선택하는 것이 중요합니다.

🔥 여러분의 프로젝트 특성에 맞는 브랜치 전략을 선택하여 더욱 효율적인 개발을 진행하세요!