Konspekt · Yetkazib berish
Feature flag'lar
Muammo
Do'kon yangi checkout oqimini chiqaradi. Deploy va release bitta harakat bo'lsa, bug hamma foydalanuvchiga yetadi, ortga qaytish esa 15 daqiqalik qayta deploy. Feature flag'lar ikkalasini ajratadi: kod o'chirilgan holda chiqadi, kim ko'rishini flag servisi hal qiladi, SDK lokal baholaydi va o'zgarishlarni stream orqali oladi, kill switch ikki soniyada o'chiradi, egasi va muddati bor flag'lar esa eskilari to'planib qolishiga yo'l qo'ymaydi.
Nimani o'rganasiz
- Nega deploy release emas va segment hamda foizli flag qoidasi qanday ko'rinadi
- Har so'rovga masofaviy chaqiruv o'rniga keshlangan snapshot'dan lokal baholash va stream orqali yangilanish
- User id'ning barqaror hash'i bo'yicha foizli rollout, kill switch va o'zi ortga qaytaradigan guardrail
- Eskirgan flag'lar qarz sifatida: egasi, muddati va build'ni yiqitadigan CI tekshiruvi
Diagramma kod sifatida
Darsdagi yakuniy sxemani matn ko'rinishida oling va Jira, GitLab, GitHub, Notion yoki hujjatga qo'ying: Mermaid u yerlarda o'zi chiziladi. D2 va PlantUML (Confluence, IntelliJ) uchun alohida variantlar bor.
Mermaid: sxema
flowchart LR
n_users(["Xaridorlar"])
n_api["Checkout API"]
n_db[("Buyurtma bazasi")]
n_ci("CI/CD")
n_flags["Flag servisi"]
n_team(("Checkout jamoasi"))
n_users --> n_api
n_api --> n_db
n_ci --> n_api
n_team --> n_flags
n_api --> n_flags
n_flags -->|"asinxron"| n_api
n_ci --x n_flagsMermaid: so'rovlar ketma-ketligi
sequenceDiagram
participant n_ci as CI/CD
participant n_api as Checkout API
participant n_users as Xaridorlar
actor n_team as Checkout jamoasi
participant n_flags as Flag servisi
participant n_guard as Guardrail
Note over n_ci,n_api: Deploy va release bir lahzada
n_ci->>n_api: 14:00:00 deploy checkout v412 -#62; 24/24 pods
Note over n_users,n_api: Yangi oqimdagi bug hammaga tegadi
n_users->>n_api: POST /v1/checkout HTTP/1.1
n_api-->>n_users: HTTP/1.1 500 Internal Server Error
Note over n_team,n_flags: Kod o'chiq chiqadi, flag hal qiladi
n_team->>n_flags: PUT /v1/flags/new-checkout HTTP/1.1
n_flags-->>n_team: HTTP/1.1 200 OK
Note over n_api,n_flags: Har so'rovga tarmoq chaqiruvi: sekin va mo'rt
n_api->>n_flags: 14:20:01 eval new-checkout user=u_42 remote 46 ms
Note over n_api,n_flags: SDK lokal nusxa saqlaydi va xotirada baholaydi
n_api->>n_flags: GET /v1/sdk/snapshot HTTP/1.1
n_flags-->>n_api: HTTP/1.1 200 OK
Note over n_flags,n_api: O'zgarishlar stream orqali yuboriladi
n_flags->>n_api: GET /v1/sdk/stream HTTP/1.1
n_api-->>n_flags: HTTP/1.1 200 OK
Note over n_users,n_api: Barqaror hash bo'yicha foizli rollout
n_users->>n_api: eval flag=new-checkout user=u_42 bucket=1873
Note over n_team,n_flags: Incident: rollback emas, kill switch
n_team->>n_flags: PATCH /v1/flags/new-checkout HTTP/1.1
n_flags-->>n_team: HTTP/1.1 200 OK
Note over n_guard,n_flags: Guardrail flag'ni o'zi o'chiradi
n_guard->>n_flags: GUARDRAIL new-checkout rollout 50% window 10 min
Note over n_ci,n_flags: Eski flag'lar to'planib qarzga aylanadi
n_ci->>n_flags: flag-audit 2026-11-18: 142 flags, 61 stale
Note over n_ci,n_flags: Har flag'ning egasi va muddati bor
n_ci->>n_flags: ci flag-lint checkout@v431D2
direction: right
n_users: "Xaridorlar" {
shape: rectangle
}
n_api: "Checkout API" {
shape: rectangle
}
n_db: "Buyurtma bazasi" {
shape: cylinder
}
n_ci: "CI/CD" {
shape: rectangle
style.multiple: true
}
n_flags: "Flag servisi" {
shape: rectangle
}
n_team: "Checkout jamoasi" {
shape: person
}
n_users -> n_api
n_api -> n_db
n_ci -> n_api
n_team -> n_flags
n_api -> n_flags
n_flags -> n_api: "asinxron"
n_ci -> n_flags {
target-arrowhead.shape: cross
}PlantUML: so'rovlar ketma-ketligi
@startuml
participant "CI/CD" as n_ci
participant "Checkout API" as n_api
participant "Xaridorlar" as n_users
actor "Checkout jamoasi" as n_team
participant "Flag servisi" as n_flags
participant "Guardrail" as n_guard
note over n_ci, n_api : Deploy va release bir lahzada
n_ci -> n_api : 14:00:00 deploy checkout v412 -> 24/24 pods
note over n_users, n_api : Yangi oqimdagi bug hammaga tegadi
n_users -> n_api : POST /v1/checkout HTTP/1.1
n_api --> n_users : HTTP/1.1 500 Internal Server Error
note over n_team, n_flags : Kod o'chiq chiqadi, flag hal qiladi
n_team -> n_flags : PUT /v1/flags/new-checkout HTTP/1.1
n_flags --> n_team : HTTP/1.1 200 OK
note over n_api, n_flags : Har so'rovga tarmoq chaqiruvi: sekin va mo'rt
n_api -> n_flags : 14:20:01 eval new-checkout user=u_42 remote 46 ms
note over n_api, n_flags : SDK lokal nusxa saqlaydi va xotirada baholaydi
n_api -> n_flags : GET /v1/sdk/snapshot HTTP/1.1
n_flags --> n_api : HTTP/1.1 200 OK
note over n_flags, n_api : O'zgarishlar stream orqali yuboriladi
n_flags ->> n_api : GET /v1/sdk/stream HTTP/1.1
n_api -->> n_flags : HTTP/1.1 200 OK
note over n_users, n_api : Barqaror hash bo'yicha foizli rollout
n_users -> n_api : eval flag=new-checkout user=u_42 bucket=1873
note over n_team, n_flags : Incident: rollback emas, kill switch
n_team -> n_flags : [qayta urinish] PATCH /v1/flags/new-checkout HTTP/1.1
n_flags --> n_team : HTTP/1.1 200 OK
note over n_guard, n_flags : Guardrail flag'ni o'zi o'chiradi
n_guard -> n_flags : GUARDRAIL new-checkout rollout 50% window 10 min
note over n_ci, n_flags : Eski flag'lar to'planib qarzga aylanadi
n_ci -> n_flags : flag-audit 2026-11-18: 142 flags, 61 stale
note over n_ci, n_flags : Har flag'ning egasi va muddati bor
n_ci -> n_flags : ci flag-lint checkout@v431
@endumlPlantUML: komponentlar
@startuml
left to right direction
agent "Xaridorlar" as n_users
component "Checkout API" as n_api
database "Buyurtma bazasi" as n_db
collections "CI/CD" as n_ci
component "Flag servisi" as n_flags
actor "Checkout jamoasi" as n_team
n_users --> n_api
n_api --> n_db
n_ci --> n_api
n_team --> n_flags
n_api --> n_flags
n_flags --> n_api : asinxron
n_ci -[#c62828]-> n_flags
@endumlXulosa
Feature flag'lar uchun olti qoida.
1) Deploy release emas: kodni o'chiq chiqaring, kim ko'rishini flag'da hal qiling. 2) SDK snapshot'idan xotirada baholang; har so'rovga tarmoq chaqiruvi yo'q, flag servisi ishlamasa ham ishlashda davom eting. 3) O'zgarishlarni stream orqali yuboring, o'chirish soniyalar olsin. 4) User id'ning barqaror hash'i bo'yicha rollout qiling: foydalanuvchilar sakramaydi, foiz faqat odam qo'shadi. 5) Sinalgan kill switch va metrikalar bo'yicha o'zi ortga qaytaradigan guardrail'lar saqlang. 6) Har flag'ning egasi va muddati bor, CI buni majburlaydi.
Ko'rsatkichlar: boshida va oxirida
| Ko'rsatkich | Boshida | Oxirida |
|---|---|---|
| Checkout xatolari | 0,4% | 0,4% |
| O'chirish vaqti | 900 s | 2 s |
| Checkout p99 | 180 ms | 181 ms |
| Eskirgan flag'lar | 0 | 4 |
Qadamlar
- Holat Deploy va release bir lahzada
Jamoa yangi checkout oqimini tugatadi va PR'ni merge qiladi.
- Muammo Yangi oqimdagi bug hammaga tegadi
Yangi oqim soliqni boshqacha yaxlitlaydi va ba'zi savatlar
500bilan yiqiladi. - Yechim Kod o'chiq chiqadi, flag hal qiladi
Yangi oqim endi
if (flags.on("new-checkout", user))ortida turibdi. - Muammo Har so'rovga tarmoq chaqiruvi: sekin va mo'rt
Har checkout endi flag servisiga chaqiruvni kutadi: 46 dan 51 ms gacha, p99 esa 180 dan 226 ms ga o'sadi.
- Yechim SDK lokal nusxa saqlaydi va xotirada baholaydi
API endi flag SDK'sidan foydalanadi.
- Yechim O'zgarishlar stream orqali yuboriladi
SDK flag servisi bilan SSE (server-sent events) orqali bitta uzoq yashovchi ulanish ushlab turadi.
- Yechim Barqaror hash bo'yicha foizli rollout
Rollout 5% dan 25% ga o'sadi.
- Yechim Incident: rollback emas, kill switch
25% da yangi oqimda karta rad etishlari sakraydi: shu foydalanuvchilar orasida checkout xatolari 4.8% ga yetadi.
- Yechim Guardrail flag'ni o'zi o'chiradi
Har checkout olgan flag qiymati bilan hodisa yuboradi.
- Muammo Eski flag'lar to'planib qarzga aylanadi
Bir yildan keyin 142 ta flag bor, ularning 61 tasi eskirgan.
- Yechim Har flag'ning egasi va muddati bor
Endi flag yaratish uchun ega va muddat majburiy.
- Xulosa Xulosa
Feature flag'lar uchun olti qoida.
Atamalar
- Kill switch
- Feature'ni deploy'siz, soniyalar ichida hamma uchun o'chiradigan flag.
- Foizli rollout
- Feature user id'ning barqaror hash'i bo'yicha foydalanuvchilarning bir ulushiga yoqiladi, har kim doim bir xil javob oladi.
- Guardrail metrikasi
- Rollout paytida flag yoniq va o'chiq guruhlar solishtiriladigan, chegaradan oshsa flag'ni avtomatik o'chiradigan metrika.