기능 플래그를 넣으면 언제든 기능을 끌 수 있으니 출시가 안전하다고 생각하기 쉽습니다. 하지만 새 코드가 이미 데이터를 바꾸거나 외부 메시지를 보냈다면 플래그를 꺼도 되돌릴 수 없습니다. 안전한 출시에는 플래그의 범위와 되돌릴 수 없는 부작용을 구분하는 일이 필요합니다.
표시와 실행을 다른 플래그로 본다
화면 버튼을 숨기는 플래그와 서버 작업을 중단하는 플래그는 다릅니다. UI만 끄면 백그라운드 작업이나 API 경로는 계속 실행될 수 있습니다. 기능 경로 전체를 그려 어느 지점에서 차단할지 정해야 합니다.
대상 사용자를 안정적으로 나눈다
점진 배포에서 사용자 그룹이 요청마다 바뀌면 같은 사람이 기능을 켰다 껐다 경험합니다. 테넌트나 사용자 ID를 기준으로 안정적인 세그먼트를 만들고, 특정 고객만 켜야 할 때 권한과 플래그를 혼동하지 않습니다.
데이터 변경은 역호환으로 설계한다
새 기능이 새 필드를 저장한다면 이전 코드도 그 데이터를 읽을 수 있는지 확인합니다. 플래그를 꺼도 데이터베이스 스키마와 이미 저장된 값은 남습니다. 원복은 설정값 변경과 데이터 복구를 별도로 계획해야 합니다.
경보와 자동 롤백 조건을 둔다
대상 비율을 늘릴 때 오류율, 지연, 업무 실패를 관찰합니다. 사전에 정한 임계값을 넘으면 확장을 멈추거나 되돌립니다. 플래그 자체의 평가 실패나 설정 서비스 장애 때 어떤 기본값을 쓸지도 정합니다.
오래된 플래그를 제거한다
출시가 끝난 플래그를 계속 남기면 분기 조합이 늘어 테스트가 어려워집니다. 소유자, 만료일, 제거 조건을 함께 등록합니다. 기능 플래그는 영구 아키텍처가 아니라 위험을 줄이는 임시 제어 장치입니다.
현장에 적용할 때의 순서
- 플래그가 제어하는 UI·서버·배치 경로를 그린다
- 대상 세그먼트와 오류 경보를 정한다
- 데이터 원복과 플래그 제거 계획을 별도로 만든다
주의할 실패: 플래그를 꺼도 이미 보낸 알림이나 저장한 데이터는 자동 복원되지 않는다.
관찰할 지표: 대상군 오류율, 롤백 시간, 만료된 플래그 수를 본다.
적용 전 체크리스트
- UI와 서버 실행 경로를 함께 차단할 수 있는가
- 플래그를 꺼도 남는 데이터·외부 부작용을 알고 있는가
- 자동 롤백과 플래그 제거 기준이 있는가
참고 자료
AWS AppConfig feature flag deployment. AWS 문서는 세그먼트별 점진 배포와 롤백 기능을 설명합니다. 플래그가 데이터 부작용을 되돌리지 못한다는 점은 애플리케이션 설계 관점의 설명입니다.
이미지와 도식은 이해를 돕기 위한 개념 시각화입니다. 특정 고객의 실제 설비·데이터·화면을 재현한 것이 아닙니다.
#기능플래그 #점진배포 #SaaS운영 #롤백 #카나리배포 #역호환 #배포안전 #FeatureFlag #장애대응 #소프트웨어개발
