mufassall

Konspekt · Yetkazib berish

Feature flag'lar

13 daq · O'rta · mufassall.dtwin.uz/uz/l/feature-flags/

← Darsni ochish

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
Yakuniy sahna
8%45%

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_flags

Mermaid: 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@v431

D2

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
@enduml

PlantUML: 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
@enduml

Xulosa

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'rsatkichBoshidaOxirida
Checkout xatolari0,4%0,4%
O'chirish vaqti900 s2 s
Checkout p99180 ms181 ms
Eskirgan flag'lar04

Qadamlar

  1. Holat Deploy va release bir lahzada

    Jamoa yangi checkout oqimini tugatadi va PR'ni merge qiladi.

  2. Muammo Yangi oqimdagi bug hammaga tegadi

    Yangi oqim soliqni boshqacha yaxlitlaydi va ba'zi savatlar 500 bilan yiqiladi.

  3. Yechim Kod o'chiq chiqadi, flag hal qiladi

    Yangi oqim endi if (flags.on("new-checkout", user)) ortida turibdi.

  4. 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.

  5. Yechim SDK lokal nusxa saqlaydi va xotirada baholaydi

    API endi flag SDK'sidan foydalanadi.

  6. Yechim O'zgarishlar stream orqali yuboriladi

    SDK flag servisi bilan SSE (server-sent events) orqali bitta uzoq yashovchi ulanish ushlab turadi.

  7. Yechim Barqaror hash bo'yicha foizli rollout

    Rollout 5% dan 25% ga o'sadi.

  8. Yechim Incident: rollback emas, kill switch

    25% da yangi oqimda karta rad etishlari sakraydi: shu foydalanuvchilar orasida checkout xatolari 4.8% ga yetadi.

  9. Yechim Guardrail flag'ni o'zi o'chiradi

    Har checkout olgan flag qiymati bilan hodisa yuboradi.

  10. Muammo Eski flag'lar to'planib qarzga aylanadi

    Bir yildan keyin 142 ta flag bor, ularning 61 tasi eskirgan.

  11. Yechim Har flag'ning egasi va muddati bor

    Endi flag yaratish uchun ega va muddat majburiy.

  12. 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.