Ana içeriğe geç

Stack ve Compose Guideline'lari

Bu sayfa, Docker Swarm stack dosyalari yazilirken izlenecek temel kurallari tanimlar.

Naming Kurallari​

  • servis adlari semantic ve stabil olmali
  • stateful servislerde identity degistiren rastgele naming kullanılmamali
  • topic, network ve volume isimleri environment ayrimi ile tutarli olmali

Label ve Constraint Kurallari​

  • stateful servisler label tabanli deterministic placement alir
  • app servisleri manager node'a mecbur kalmadikca yerlestirilmez
  • storage erisimi gereken servisler qapu.storage label mantigiyla dusunulur

Healthcheck Kurallari​

  • healthcheck olmayan servis production rollout adayi sayilmaz
  • process up check tek basina yeterli degildir
  • readiness semantics servis contract ile uyumlu olmalidir

Secrets ve Config Kurallari​

  • image icine secret gomulmez
  • environment dosyalari ile gerçek secret management karistirilmaz
  • config override davranisi deterministic olmali

Rollout Kurallari​

  • stateless servisler rolling update alir
  • stateful servisler controlled update alir
  • migration etkisi olan degisiklikler once compatibility acisindan degerlendirilir

Gozlem Kurallari​

  • her kritik servis icin log, metrics ve health sinyali tanimli olmali
  • deploy sonrasi smoke test checklist'i bulunmali

Sonuc​

Stack dosyasi yalniz bir deployment artefact'i degildir. Qapu icin stack dosyasi, deployment contract'larin calisan karsiligidir.