핵심 인사이트 (3줄 요약)
- 본질: 피처 플래그(Feature Flag)는 코드에 if/else 스위치를 삽입하여, 배포(Deploy)와 릴리즈(Release)를 분리하고 런타임에 기능 ON/OFF를 즉시 전환할 수 있게 하는 소프트웨어 배포 전략이다.
- 가치: 코드는 이미 프로덕션에 배포되었지만 플래그가 OFF이므로 사용자에게 보이지 않는 **다크 런칭(Dark Launching)**이 가능하며, 문제 발생 시 코드 롤백 없이 플래그만 OFF하면 즉시 무력화된다.
- 판단 포인트: Release Toggle(단기)·Experiment Toggle(A/B 테스트)·Ops Toggle(운영 제어)·Permission Toggle(사용자별 기능 제한)의 4가지 유형을 구분하고, 사용 후 반드시 제거하여 **토글 부채(Toggle Debt)**를 방지해야 한다.
Ⅰ. 개요 및 필요성
새 결제 시스템을 개발 완료했지만, 모든 사용자에게 한 번에 공개하기 두렵다. 피처 플래그로 사내 직원 10명에게만 ON → 검증 → 1% 카나리 → 100% 릴리즈로 점진 공개할 수 있다.
┌───────────────────────────────────────────────────────┐
│ 피처 플래그 = 배포 ≠ 릴리즈 │
├───────────────────────────────────────────────────────┤
│ [기존] 배포 = 릴리즈 (동시에 전체 공개) │
│ 문제 시 → 코드 롤백 (5~30분) │
│ │
│ [피처 플래그] 배포 ≠ 릴리즈 │
│ 1. 코드 배포 (Flag OFF → 아무도 안 보임) │
│ 2. 사내 직원에게 ON → 검증 │
│ 3. 1% 사용자 ON → 카나리 검증 │
│ 4. 100% ON → 전체 릴리즈 │
│ 5. 문제 시 → Flag OFF (1초, 롤백 불필요) │
└───────────────────────────────────────────────────────┘
- 📢 섹션 요약 비유: 피처 플래그는 극장 무대의 조명 스위치다. 배우(코드)는 이미 무대에 서 있지만, 조명을 켜야(Flag ON) 관객(사용자)에게 보인다.
Ⅱ. 아키텍처 및 핵심 원리
4가지 토글 유형
| 유형 | 수명 | 용도 | 예 |
|---|
| Release Toggle | 단기 (배포~릴리즈) | 미완성 기능 숨기기 | 신규 결제 시스템 |
| Experiment Toggle | 중기 (A/B 테스트) | 두 변형 비교 실험 | 버튼 색상 A/B |
| Ops Toggle | 장기 (운영) | 부하 시 기능 차단 | 추천 엔진 OFF |
| Permission Toggle | 영구 | 사용자별 기능 제한 | 프리미엄 전용 기능 |
피처 플래그 도구
| 도구 | 유형 | 특징 |
|---|
| LaunchDarkly | SaaS | 타겟팅·A/B·실시간 |
| Unleash | OSS | 자체 호스팅, 무료 |
| Flagsmith | OSS/SaaS | 멀티플랫폼 |
- 📢 섹션 요약 비유: Release Toggle은 영화 개봉 전 시사회 초대권이고, Experiment Toggle은 신메뉴 시식 이벤트며, Ops Toggle은 비상시 전원 차단기다.
Ⅲ. 비교 및 연결
| 비교 | 코드 롤백 | 피처 플래그 OFF |
|---|
| 속도 | 5~30분 (빌드+배포) | 1초 (API 호출) |
| 범위 | 전체 코드 | 해당 기능만 |
| 위험 | 다른 기능 영향 가능 | 해당 기능만 비활성 |
| 데이터 | 상태 복원 어려움 | 코드 그대로, 플래그만 OFF |
Ⅳ. 실무 적용 및 기술사 판단
토글 부채 (Toggle Debt) 방지
- 만료일 설정: Release Toggle에 2주 만료일 지정, 자동 알림.
- 정기 정리: 분기별 "Flag 대청소" 스프린트.
- 문서화: 각 플래그의 목적·소유자·만료일을 레지스트리에 기록.
안티패턴
- 50개 이상 플래그 방치: 코드 분기 폭발 → 테스트 경우의 수 $2^{50}$ → 유지보수 불가.
Ⅴ. 기대효과 및 결론
| 지표 | 플래그 미사용 | 플래그 사용 | 개선 |
|---|
| 롤백 속도 | 5~30분 | 1초 | 99% 단축 |
| 릴리즈 자신감 | 낮음 (빅뱅) | 높음 (점진적) | 리스크 감소 |
| A/B 테스트 | 별도 인프라 | 플래그로 즉시 | 실험 가속 |
피처 플래그는 Trunk-based Development의 핵심 조력자이며, AI 기반 자동 롤아웃(카나리 분석 + 자동 Flag ON/OFF)과 결합하여 자율 릴리즈 시스템으로 진화하고 있다.
📌 관련 개념 맵
| 개념 | 연결 포인트 |
|---|
| 다크 런칭 (Dark Launching) | Flag OFF 상태로 프로덕션 배포 |
| 카나리 릴리즈 | 피처 플래그로 1% 사용자 먼저 공개 |
| A/B 테스트 | Experiment Toggle로 변형 비교 |
| Trunk-based Development | 피처 플래그가 브랜치 전략을 대체 |
| 토글 부채 (Toggle Debt) | 미정리 플래그의 기술 부채 |
📈 관련 키워드 및 발전 흐름도
[Feature Branch (2000s) — 브랜치별 기능 개발]
│
▼
[Feature Flag 개념 (2010s) — 배포와 릴리즈 분리]
│
▼
[LaunchDarkly SaaS (2014~) — 실시간 플래그 관리]
│
▼
[Trunk-based + Flag (2018~) — 단일 브랜치 + 플래그 점진 공개]
│
▼
[현재: AI 기반 자동 롤아웃 — 카나리 분석 + 자동 Flag ON/OFF]
👶 어린이를 위한 3줄 비유 설명
- 피처 플래그는 극장 무대의 조명 스위치예요. 배우(코드)는 이미 있지만, 불을 켜야 관객이 봐요.
- 새 공연이 걱정되면 가족(사내 직원)에게만 먼저 보여주고, 괜찮으면 모든 관객에게 공개해요.
- 만약 실수가 있으면 조명만 끄면(1초) 돼서, 무대를 부수고(롤백) 다시 만들 필요가 없답니다!