Ana içeriğe geç

Observer Deployment Contract

Bu sayfa, Qapu'nun lifecycle operations katmani olan Observer servisinin Docker Swarm uzerindeki deployment contract'ini tanimlar.

Rol​

Observer servisi:

  • stage success/failure sinyallerini izler
  • retry, escalation ve cleanup operasyonlarini yonetir
  • lifecycle truth'u operasyonel gorunurluge donusturur

Benimsenen Model​

  • stateless deployment
  • replica tabanli olceklenme
  • internal-only service davranisi
  • qapu-app ve qapu-data network uyeligi

Placement​

Observer worker node'larda replica olarak kosar.

Onerilen davranis:

  • replicas >= 2
  • healthcheck gate
  • rollout sirasinda duplicate observation ve retry davranisi idempotent tasarlanmalidir

Network​

Tipik network uyeligi:

  • qapu-app
  • qapu-data
  • gerekiyorsa qapu-ops

Dis dunyaya dogrudan acilmaz.

Secrets ve Configs​

Secrets​

  • db credential'lari
  • redis credential'lari
  • kafka credential'lari

Configs​

  • retry threshold'lari
  • timeout pencereleri
  • escalation tuning parametreleri
  • cleanup davranis ayarlari

Health ve Readiness​

Observer icin process ayakta olmasi yeterli degildir.

Minimum readiness beklentisi:

  • consume edecegi event baglami hazir olmali
  • persistence baglami kurulmus olmali
  • retry/escalation config'leri yuklenmis olmali

Update Stratejisi​

Onerilen davranis:

  • rolling update
  • start-first
  • healthcheck gate
  • rollout sirasinda retry/callback davranislari duplicate etki uretmeyecek sekilde korunmali

Operasyonel Not​

Observer deployment contract'inda asil kritik nokta sudur:

  • lifecycle operations semantics rollout sirasinda bozulmadan devam ediyor mu?