release 브랜치를 '굳이?'라며 뺐다가 다시 넣은 Git-flow 도입기
주니어 셋이 master 단일 브랜치에서 Git-flow로 옮기며 release 브랜치를 처음엔 생략했다가 다시 도입하기까지, 그리고 팀이 정한 브랜치·PR 규칙을 돌아봅니다.
Git-flow를 도입하면서 release 브랜치는 "저희 상황에서는 굳이?"라고 생각했습니다. 결과적으로는 굳이 그래야 했습니다.
리케어랩 프론트개발팀에서 지금의 브랜치 전략이 자리 잡기까지의 이야기입니다. 지금의 흐름이 반드시 정답이라고 생각하지는 않습니다. 다만 도입 과정에서 겪은 시행착오가 비슷한 규모의 팀에 도움이 되면 좋겠습니다.
세 명이 master 하나로 작업하자 충돌과 운영 오류가 늘었다
팀이 세 명으로 늘었는데 모두 master에서만 분기해 작업했고, 검증 단계 없이 바로 병합해 실제 서비스에서 오류가 났습니다.
두 명일 때는 굴러가던 방식
제가 입사하기 전에는 팀원 두 분이 레포를 관리하셨습니다. 두 분이 작업하던 때라 명확한 정의 없이도 자연스럽게 일이 굴러갔습니다. 그런데 제가 들어와 세 명이 되자, 막연히 master 브랜치에서만 분기해 작업하다 보니 충돌과 작업 상황 공유 같은 문제에 부딪혔습니다.
dev 서버 없이 master로 바로
dev 서버 없이 master에 바로 병합하다 보니 실제 서비스 환경에서 오류가 나는 일이 잦아졌습니다. 결제 시스템처럼 고정 IP가 필요한 경우가 생길 때마다 master에서 테스트해야 하는 상황을 보며 생각했습니다.
"아 이건 관리가 필요하다"
빠른 개발이 계속 요구되는 주니어 팀
저희는 초기 스타트업이라 빠른 개발, 신규 기능, 수정과 오류 해결이 계속 요구됐습니다. 그리고 모두 주니어여서, 명확히 옳다 틀리다를 말해 줄 사람이 없었습니다.
develop만 추가할까, release까지 둘까
| 선택지 | 얻는 것 | 잃는 것 |
|---|---|---|
| master 단일 브랜치 (기존) | 관리할 브랜치가 적음 | 충돌, 검증 없이 운영 반영, master에서 테스트 |
| develop만 추가 | develop에서 QA 후 배포, 브랜치 부담이 적음 | 메인 오류 수정과 개발 중인 작업이 섞임 |
| release·hotfix까지 포함한 Git-flow | 출시 준비와 긴급 수정을 개발과 분리 | 관리할 브랜치가 늘어남 |
처음 고른 것: develop만 추가하고 release는 뺐다
초기 도입

develop 브랜치를 만들어 거기서 분기해 작업하고, QA를 거쳐 배포하면 메인 서버의 오류가 줄지 않을까 하는 생각으로 Git-flow를 도입했습니다. release 브랜치를 쓰는 방식도 많이 봤지만, "저희 상황에서는 굳이??" 라고 생각했던 것 같습니다.
깨진 지점: 이게 맞아요...? "네. 굳이 그래야 됐었습니다."
신규 기능을 dev에 올려도 메인에서 오류가 나면 기존 커밋을 reset하는 일이 빈번해졌고, 커밋이 꼬이면서 실수가 생기기 시작했습니다. 결국 3시간의 열띤 토론 끝에 release 브랜치로 버전을 관리해야 한다는 데 모두 공감했습니다.
release·hotfix를 포함한 Git-flow와 팀 규칙
release 브랜치를 넣기까지 2개월
글로 정리하니 짧아 보이지만, 장장 2개월 동안 모두 고생했습니다.

이 전략을 다들 처음부터 알고는 있었습니다. 다만 저희 상황에 맞는지 판단해 줄 사람이 없어 직접 부딪혀 가며 정했습니다.
release 브랜치를 도입하자 메인 브랜치에서 오류가 나도 hotfix로 고칠 수 있었고, 개발 중인 develop 브랜치에는 영향을 주지 않았습니다. QA 중에는 release에서 수정한 뒤, 최종 배포 단계에서 master와 develop에 모두 병합했습니다.
브랜치 역할
- master : 제품으로 출시될 수 있는 브랜치
- develop : 다음 출시 버전을 개발하는 브랜치
- feature : 기능을 개발하는 브랜치
- release : 이번 출시 버전을 준비하는 브랜치
- hotfix : 출시 버전에서 발생한 버그를 수정하는 브랜치
작업 규칙
나름대로 규칙을 만들고 지키려고 노력했습니다.
- PR은 한 명 이상의 동료 승인이 있을 때만 진행합니다.
- 작업을 시작하기 전에 JIRA 티켓을 생성합니다(hotfix도 무조건!).
- 하나의 티켓은 되도록 하나의 커밋으로 만듭니다.
- 자신의 Pull Request는 스스로 merge합니다.
브랜치는 늘었지만 대응은 일관돼졌다
master 하나로 작업하던 Github-flow 때보다 관리할 브랜치가 늘어난 부담은 있습니다. 그래도 전보다 여러 상황에 일관되게 대처할 수 있게 된 것 같습니다.
남은 한계
모든 상황이 flow대로 흘러가지는 않습니다. (아직 저희가 부족해서 그런 것 같지만...) 그래도 시행착오를 겪으며 발전해 왔다고 생각하기에, 또 다른 문제를 만나도 저희끼리 잘 헤쳐 나갈 수 있을 것 같습니다.
배운 것
브랜치 전략에 정답은 없다고 생각합니다. 읽어 주신 분들도 각자 상황에 맞는 전략을 고르실 수 있기를 바랍니다.
같은 주제의 글
WebView 하단 탭바를 Link와 idle prefetch로 가볍게 만든 기록
Next.js App Router + Flutter WebView에서 전역 5탭·금 모으기 4탭 하단바의 전환 지연, 초기 prefetch 부담, 입장 애니메이션을 라우팅 모델에 맞춰 나눠 푼 과정입니다.
Next.js 정적 파일을 S3·CloudFront로 옮겨 CPU 스파이크 줄이기
assetPrefix로 /_next/static만 S3 + CloudFront(OAC)로 분리한 구조와 배포 후 캐시 무효화 순서, 같이 챙겨야 했던 이미지 허용·빌드 OOM 설정을 정리했습니다.
허용 도메인만 열린 교육청 망에서 S3 이미지를 nginx 리버스 프록시로 띄운 기록
서울시교육청 시범 도입 중 화이트리스트 망에서 S3 이미지가 막히자, 이미 허용된 API 도메인 뒤에 nginx 리버스 프록시를 두어 이미지를 서빙한 과정과 트레이드오프를 정리했습니다.