Feature flag — melepas kode tanpa menyalakan fitur

Deploy dan rilis adalah dua hal berbeda. Feature flag membuat kode baru bisa masuk produksi dalam keadaan mati, dinyalakan bertahap, dan dimatikan dalam hitungan detik saat bermasalah — tanpa deploy.

Antarmuka yang sederhana

type Flag interface {
	Aktif(ctx context.Context, nama string) bool
}

// Pemakaian: percabangan yang jelas dan mudah dihapus nanti.
func (h *Handler) Checkout(w http.ResponseWriter, r *http.Request) {
	if h.flag.Aktif(r.Context(), "checkout-baru") {
		h.checkoutBaru(w, r)
		return
	}
	h.checkoutLama(w, r)
}

// Implementasi: cache lokal yang disegarkan berkala, JANGAN memanggil
// jaringan di jalur permintaan.
type FlagCache struct {
	nilai   atomic.Pointer[map[string]Aturan]   // pembaca tanpa lock (Fase 2)
	sumber  Sumber
	log     *slog.Logger
}

func (f *FlagCache) Aktif(ctx context.Context, nama string) bool {
	m := f.nilai.Load()
	if m == nil {
		return false            // BAWAAN AMAN: fitur baru mati
	}
	a, ada := (*m)[nama]
	if !ada {
		return false
	}
	return a.Evaluasi(ctx)
}

func (f *FlagCache) segarkanBerkala(ctx context.Context) {
	t := time.NewTicker(30 * time.Second)
	defer t.Stop()
	for {
		select {
		case <-ctx.Done():
			return
		case <-t.C:
			m, err := f.sumber.Muat(ctx)
			if err != nil {
				// Sumber flag bermasalah: PERTAHANKAN nilai lama.
				f.log.WarnContext(ctx, "gagal memuat flag", "err", err)
				continue
			}
			f.nilai.Store(&m)
		}
	}
}

Empat jenis flag

Peluncuran bertahap

type Aturan struct {
	Aktif      bool
	Persentase int       // 0–100
	Pengguna   []int64   // daftar putih: tim internal dulu
	Tenant     []int64
}

func (a Aturan) Evaluasi(ctx context.Context) bool {
	if !a.Aktif {
		return false
	}

	u := auth.DariContext(ctx)
	if slices.Contains(a.Pengguna, u.ID) {
		return true
	}

	if a.Persentase >= 100 {
		return true
	}
	if a.Persentase <= 0 {
		return false
	}

	// Hash ID pengguna, BUKAN acak: pengguna yang sama harus selalu
	// mendapat hasil yang sama, atau tampilannya berubah tiap muat ulang.
	h := fnv.New32a()
	fmt.Fprintf(h, "%s:%d", a.Nama, u.ID)
	return int(h.Sum32()%100) < a.Persentase
}

Urutan peluncuran yang lazim:

  1. Deploy dengan flag MATI            → kode di produksi, tidak aktif
  2. Nyalakan untuk tim internal        → uji dengan data sungguhan
  3. 5% pengguna, pantau alarm          → p95, laju error, metrik bisnis
  4. 25% → 50% → 100%
  5. Hapus flag dan kode jalur lama     ← jangan dilewati

Menguji kedua jalur

func TestCheckout(t *testing.T) {
	for _, aktif := range []bool{false, true} {
		t.Run(fmt.Sprintf("flag=%v", aktif), func(t *testing.T) {
			h := New(svcUji(t), flagTetap{"checkout-baru": aktif})
			...
		})
	}
}

// Flag palsu: satu map, tanpa pustaka.
type flagTetap map[string]bool

func (f flagTetap) Aktif(_ context.Context, nama string) bool { return f[nama] }

Pilihan penyimpanan