기능 플래그
규칙
- 기능 플래그를 사용하여 점진적 롤아웃을 수행하세요 — 코드를 플래그 뒤에 배포하고, 점진적으로 활성화합니다.
- 플래그 유형: 불리언(켜기/끄기), 퍼센트(사용자의 10%), 사용자 타겟팅(특정 ID/세그먼트)
- 엔터프라이즈에는 LaunchDarkly, 오픈소스에는 Flagsmith, Next.js에는 Vercel Flags 또는
@vercel/flags를 사용하세요.
- 기본적으로 서버 측에서 플래그를 평가하세요 — 클라이언트에는 플래그 값만 전달하고, 평가 로직은 절대 전달하지 마세요.
- 플래그 명명 규칙:
enable-new-checkout, show-pricing-v2 — 설명적이고, 케밥-케이스(kebab-case)를 사용하세요.
- 전체 롤아웃 후 플래그를 정리하세요 — 오래된 플래그는 기술 부채입니다. 만료 날짜를 설정하세요.
- 퍼센트 롤아웃: 일관된 버케팅(bucketing)을 위해 사용자 ID를 해시하세요 — 동일한 사용자는 항상 동일한 변형을 봅니다.
- 새로운 기능은 기본적으로 플래그를 끈 상태로 시작하세요 — 플래그 서비스를 사용할 수 없는 경우 안전하게 실패합니다.
- A/B 테스트에 플래그를 사용하세요: 변형을 정의하고, 전환 이벤트를 추적하며, 통계적 유의성을 측정합니다.
- 로컬 개발을 위해 플래그 오버라이드를 환경 변수에 저장하세요.
패턴
import { flag } from "@vercel/flags/next";
export const showNewCheckout = flag({
key: "show-new-checkout",
decide: () => false,
});
const enabled = await showNewCheckout();
import * as ld from "@launchdarkly/node-server-sdk";
const client = ld.init(process.env.LAUNCHDARKLY_SDK_KEY!);
const showFeature = await client.variation("new-checkout", user, false);
피해야 할 것
- 플래그 없이 기능을 배포하지 마세요 — 모든 새로운 기능은 토글 가능해야 합니다.
- 중첩된 플래그 의존성을 만들지 마세요 — 플래그 로직을 평평하고 독립적으로 유지하세요.
- 100% 롤아웃 후에도 코드에 플래그를 남겨두지 마세요 — 2주 이내에 정리 일정을 잡으세요.
- 타겟팅 규칙이 노출되는 클라이언트 측 플래그 평가를 하지 마세요 — 서버에서 평가하고 결과만 전송하세요.