참고문서
핵심 키워드
- 트렁크(Trunk) / 메인 브랜치(Main Branch)
- CI/CD (지속적 통합/배포)
- 소규모 빈번한 커밋
- 피처 플래그(Feature Flag)
- 자동화된 테스트
- 코드 리뷰
들어가며: 왜 트렁크 기반 개발인가?
소프트웨어 개발에서 가장 중요한 것 중 하나는 "얼마나 빠르고 안정적으로 새로운 기능을 사용자에게 전달할 수 있는가" 이다. 트렁크 기반 개발은 이러한 목표를 달성하기 위한 현대적인 개발 방식이다.
트렁크? 빤스인가?
트렁크 기반 개발은 개발자들이 작은 단위의 변경사항을 자주 메인 브랜치(트렁크)에 병합하는 버전 관리 방식이다. 이는 마치 나무의 줄기(trunk)처럼 하나의 중심 줄기에 모든 변경사항이 모이는 형태를 띈다.
실제 시나리오로 이해하기
팀 프로젝트 상황을 가정해보겠다:
상황: 온라인 쇼핑몰 개발 프로젝트
팀원: 프론트엔드 개발자 A, 백엔드 개발자 B, C
1일차 아침:
- A: 장바구니 UI 개선 작업 시작
- B: 결제 API 수정 작업 시작
- C: 상품 검색 기능 개선 작업 시작
1일차 오후:
- A: 장바구니 아이콘 변경사항 커밋 및 병합 (15줄 수정)
- B: 결제 API 유효성 검사 로직 추가 커밋 및 병합 (20줄 수정)
- C: 검색 알고리즘 최적화 부분 커밋 및 병합 (30줄 수정)
2일차:
- 각자 남은 작업을 작은 단위로 나누어 지속적으로 커밋 및 병합기존 Git Flow와의 차이점
Git Flow 방식
Feature Branch 방식:
1. feature/cart-improvement 브랜치 생성
2. 2주간 작업
3. 100개 이상의 파일 변경
4. PR 생성
5. 코드 리뷰에 3일 소요
6. 충돌 해결에 2일 소요트렁크 기반 개발 방식
1. 트렁크에서 직접 작업 또는 초단기 브랜치 생성
2. 하루 작업
3. 5-10개 파일 변경
4. PR 생성
5. 코드 리뷰 30분 소요
6. 충돌 최소화트렁크 기반 개발의 장점
- 지속적 통합의 실현
- 작은 변경사항의 빈번한 병합으로 통합 문제 최소화
- 실시간으로 문제 발견 및 해결 가능
- 효율적인 코드 리뷰
- 작은 단위의 변경사항으로 리뷰어의 부담 감소
- 더 깊이 있는 코드 리뷰 가능
- 빠른 배포 주기
- 언제든 배포 가능한 상태 유지
- 새로운 기능의 빠른 출시 가능
실전 적용을 위한 Best Practice
1. 작은 단위로 개발하기
나쁜 예:
- 한 번에 전체 회원가입 기능 구현 (500줄 변경)
좋은 예:
- 회원가입 입력 폼 UI 구현 (50줄)
- 이메일 유효성 검사 추가 (30줄)
- 비밀번호 정책 구현 (40줄)
- API 연동 구현 (60줄)2. 피처 플래그 활용하기
피처 플래그(Feature Flag): 코드 안에 "스위치"를 심어두는 개발 기법. 이 스위치를 통해 프로덕션 환경에서도 새로운 기능을 안전하게 켜고 끌 수 있다.
// 피처 플래그 예시
if (featureFlags.isEnabled('new-payment-system')) {
// 새로운 결제 시스템 코드(특정 사용자에게만 새 기능을 보여줄 수 있음)
processNewPayment();
} else {
// 기존 결제 시스템 코드
processOldPayment();
}3. 자동화된 테스트 구축
커밋 시 자동 실행되는 테스트:
1. 단위 테스트
2. 통합 테스트
3. 코드 커버리지 검사
4. 린트 검사트렁크 기반 개발 도입 시 주의사항
- 팀 문화의 변화
- 작은 단위 커밋에 대한 팀원 합의 필요
- 빠른 코드 리뷰 문화 정착 필요
- 테스트 자동화 필수
- 지속적 통합을 위한 테스트 인프라 구축
- 테스트 작성을 일상화
- 점진적 도입
- 소규모 프로젝트부터 시작
- 팀원들의 적응 기간 필요
마치며
트렁크 기반 개발은 현대 소프트웨어 개발에서 CI/CD를 실현하는 핵심 방법론이다. 필자가 참고한 본문에 의하면 작은 변경사항의 빈번한 통합이라는 단순한 원칙이 가져오는 효과는 매우 크다고 한다. 처음에는 도전적으로 느껴질 수 있지만, 팀의 생산성과 코드 품질을 크게 향상시킬 수 있다.
참 되게 살자