Özellik Bayrakları — Deploy Ettim Ama Kimse Görmedi

Bir elektrikçi salona yeni bir lamba takıyor. Lamba bir anahtara bağlıysa takıldığı an sönük durur; ne zaman yanacağına sen karar verirsin. Anahtar yoksa takıldığı an yanar, söndürmek için ustanın geri gelmesi gerekir.

Deploy ayrı, yayın ayrı

Bir özellik bayrağı?Terimin tanımını açfeature flagKodun içinde, çalışırken değiştirilebilen bir ayara bakan 'açık mı?' kontrolü. Deploy'u release'ten ayırır; kapatmak bir deploy değil, bir ayardır.Sözlükte gör →, kodun içindeki bir “açık mı?” sorusudur. Cevap koddan değil, çalışırken değiştirilebilen bir ayardan gelir.

Kodu bayrak kapalıyken yayına almaya dark launch?Terimin tanımını açdark launchKodu bayrak kapalıyken yayına almak: kod sunucudadır ama hiçbir kullanıcı o yola girmez. Açmak ayrı bir karar olarak bekler.Sözlükte gör → denir. Deploy olur ama kimse özelliği görmez; açmak ayrı bir karar olarak bekler.

Adım adım açmak

Güvenli sıra: önce çalışanlar, sonra küçük bir müşteri dilimi, sonra herkes. Her adımda metriklere bakılır; tıpkı canary?Terimin tanımını açcanary releaseYeni sürümü önce trafiğin küçük bir dilimine açıp hata oranını eski sürümle karşılaştırmak. Hatalı sürüm yalnızca o dilime dokunur.Sözlükte gör → gibi, ama sunucu yerine kullanıcı üzerinden.

Yüzde dilimi müşteri numarasının hash’ine bağlanır. Böylece bir müşteri dilimin içindeyse hep içinde kalır.

Kendin gör

1. Varsayılanla oynat. Hatalı özellik deploy ile herkese açıldı; kapatmak geri deploy.
2. “Bayrak arkasında, kapalı” seç. Kod yayında, kimse görmüyor.
3. “Yalnızca çalışanlar” seç. Hatayı çalışanlar buldu, bayrak saniyeler içinde kapandı.
4. Yüzde 10’a geç ve yapışıklığı kapat. Müşteri 42’nin düğmesi bir geliyor bir gidiyor.

Tuzaklar

Unutulan bayraklar. Herkese açılmış ve aylarca dokunulmamış bayraklar kodu iki yola böler ve testleri ikiye katlar. Her bayrağın bir sahibi ve bir silinme tarihi olsun.

Bayrağın çözmediği şey. Veritabanı şeması bayrakla açılıp kapanmaz. Yeni bir kolon, bayrak kapalıyken de eski kodla uyumlu olmalı.

Bayrak servisine bağımlılık. Bayrak ayarı okunamazsa ne olacağı baştan belli olmalı. Güvenli varsayılan çoğu zaman “kapalı”dır.

Aşağıdaki örnek bir bankanın anında havale özelliğinden: bayrak müşteri numarasıyla yapışık, ayar okunamazsa kapalı, kod iki yolu temiz ayırıyor.

1
@Component
2
class InstantTransferFlag {
3

4
    private final FlagSettings settings;
5

6
    InstantTransferFlag(FlagSettings settings) {
7
        this.settings = settings;
8
    }
9

10
    // Owner: payments-team. Remove after 2026-12-31 once fully rolled out.
11
    boolean isOnFor(Customer customer) {
12
        FlagSettings.Rollout rollout = settings.instantTransfer();
13
        if (customer.isStaff()) return rollout.staff();
14
        // Sticky: the same customer always lands in the same bucket.
15
        int bucket = Math.floorMod(Long.hashCode(customer.id()), 100);
16
        return bucket < rollout.percent();
17
    }
18
}

1
// Read from the config service at runtime. If it cannot be read, every flag
2
// is off: a missing setting must never switch a new feature on.
3
@ConfigurationProperties("flags")
4
record FlagSettings(Rollout instantTransfer) {
5

6
    FlagSettings {
7
        if (instantTransfer == null) instantTransfer = new Rollout(false, 0);
8
    }
9

10
    record Rollout(boolean staff, int percent) {
11
    }
12
}

1
@Service
2
class TransferService {
3

4
    private final InstantTransferFlag instant;
5
    private final InstantRail instantRail;
6
    private final BatchRail batchRail;
7

8
    TransferService(InstantTransferFlag instant, InstantRail instantRail, BatchRail batchRail) {
9
        this.instant = instant;
10
        this.instantRail = instantRail;
11
        this.batchRail = batchRail;
12
    }
13

14
    TransferResult send(Customer customer, TransferRequest request) {
15
        // The single branch point: deleting the flag later changes this one line.
16
        return instant.isOnFor(customer) ? instantRail.send(request) : batchRail.send(request);
17
    }
18
}

1
class InstantTransferFlagTest {
2

3
    @Test
4
    void aCustomerGetsTheSameAnswerEveryTime() {
5
        var flag = new InstantTransferFlag(new FlagSettings(new FlagSettings.Rollout(false, 10)));
6
        var customer = Customer.retail(42L);
7

8
        boolean first = flag.isOnFor(customer);
9
        for (int i = 0; i < 100; i++) {
10
            assertThat(flag.isOnFor(customer)).isEqualTo(first);
11
        }
12
    }
13
}

Kendini sına