Konfigurasiýalary ýerleşdirmek

1) Näme üçin

Konfigurasiýa koddan has ýygy üýtgeýär we girdejä gönüden-göni täsir edýär (PSP marşrutlamak, çäklendirmeler, koeffisiýentler, frontuň nokatlary) we gabat gelmek (KYC/AML, RG). Konwensiýalary önüme ibermegiň gaýtalanýan, barlanylýan we yzyna gaýtarylýan prosesi, berk rugsat we gözegçilik bilen gerek.

2) Ýörelgeler

1. Configuration as Data: konfigiler - "el bilen basmak" däl-de, wersiýalanýan maglumatlar (YAML/JSON).
2. Schema-first: islendik ýazgy shema garşy tassyklanýar (JSON Schema/Protobuf).
3. Syýasatçylar kod hökmünde: geýt, rugsat, SoD - syýasatçylaryň howdanynda.
4. GitOps: Hakykatyň ýeke-täk çeşmesi - Git; klasterler gaýtadan işleýän adam tarapyndan berjaý edilýär.
5. Progressiw eltip bermek: segmentler (GEO/Tenant/Bank/Provayder) boýunça kanar aýlawlary.
6. Zero-downtime: atom switçalary, goşa buferizasiýa, formatlaryň laýyklygy.
7. Gözegçilik edilişi by design: audit, ulanyş metrikleri, drift detektor.
8. Howpsuzlyk: töwekgelçilikli üýtgeşmelere SoD/4-eyes iň az artykmaçlyklar, syrlar.

3) Konfigurasiýa modeli

Statiki: seýrek üýtgeýär, çykmagy talap edýär (portlar, ýadro wagtlary).
Dinamiki: restartlarsyz ulanylýar (PSP routing, fiçler, çäkler).
Syrlar: açarlar/bellikler; aýratyn kontury (KMS/Secret Manager).
Artefaktlar: düzgünleriň faýllary/mappingler (BIN → bank, GEO → PSP, bonuslaryň çäkleri).

Salgy açarlary: 'tenant', 'region', 'environment', 'service', 'version', 'segment' (psp/bank_group/device).

4) Formatlar we shemalar

json
{
"$schema": "https://json-schema. org/draft/2020-12/schema",
"title": "pspRouting",
"type": "object",
"properties": {
"version": {"type": "string"},
"rules": {
"type": "array",
"items": {
"type": "object",
"required": ["geo","binGroup","primary","fallback"],
"properties": {
"geo": {"type":"string"},
"binGroup":{"type":"string"},
"primary":{"type":"string"},
"fallback":{"type":"array","items":{"type":"string"}},
"limits":{"type":"object","properties":{"perMinute":{"type":"integer"}}}
}
}
}
},
"required": ["version","rules"]
}

5) Durmuş aýlawy (GitOps)

1. Authoring: PR konfigurasiýa ammaryna: maglumatlar + bilet/üýtgeşme baglanyşygy.
2. Lint/Validate: CI: shemalar, baglanyşyklar, semantika (gapma-garşylyk düzgünleri), stendde dry-run.
3. Policy Gates: SoD/4-eyes, töwekgelçilik synpy, freeze penjireleri, SLO statusyna laýyklyk.
4. Staging Apply: integrasiýa synaglarynyň/sintetikanyň geçmegi, SLI barlagy.
5. Progressive Delivery: prod-kanareika (1-5%) → 25% → sebit/tenant → 100%.
6. Post-monitoring: 30-60 min metrik/alert; netijäni düzetmek.
7. Promotion/Rollback: reliz bellikleri, Git revert/" previous version "arkaly çalt yza gaýdyp gelmek.

6) Ýaýlamak strategiýalary

Segmentler boýunça kanareýeçilik: 'tenant = A, geo = TR, bank = BIN _ XXXX'.
Sebitlere görä: EU → LATAM → APAC, sagadyň iň ýokary derejesini göz öňünde tutup.
Funksiýasyna görä: guardrails (TTL, gurşaw çäkleri) bilen baýdagy (feature flag) açmak.
Çeşme üçin Blue/Green: okyjylary täze snapshot-a geçirmek.

7) Dinamiki ýüklemek we gabat gelmek

Gyzgyn täzeden başlamak (watchers/konsullar/OTel Collector pipeline reload).
Goşa format (v1 + v2): Prod ikisini hem okaýar, öndürijiler täzesine ýazýar.
Utgaşyklyk: "kimiň haýsy konfigurasiýada" görmek üçin API/metrika jogaplaryndaky wersiýa.

8) Howpsuzlyk, syrlar, SoD

Syrlar aýratyn: KMS/Secret Manager-da saklamak, meýdan derejesinde şifrlemek, ABAC arkaly elýeterlilik.
SoD/4-eyes: töleg routinginiň/bonuslaryň/PII-eksportyň çäkleriniň üýtgemegi - diňe goşa tassyklama arkaly.
JIT hukuklary: amallar üçin wagtlaýyn bellikler, doly audit.
Howpsuzlyk barlaglary: linter konfigada PII/synag açarlaryny gadagan edýär.

9) Ulanylmazdan öň tassyklamalar

Shemalar (JSON Schema/Protobuf), linterler, kardinallygy barlamak.
Domen semantikasy: aýlawlar/dublikatlar/" gara deşikler" ýok, häzirki garaşlylyklar bilen gabat gelýär.
Shadow-traffic/simulýasiýa: Täze marşrut/düzgünleri hakyky akymda okamak-ýazmazdan "sürmek".
SLO-gate: gyzyl SLI → mahabat gadaganlygy.

10) Gözegçilik we audit

Ýerleşdiriş metrikleri: ulanmak wagty, üstünlik, gurşaw paýy, parsing ýalňyşlyklary, rollbacks.
Wakalar: kim/näme/haçan/näme üçin, diff (syrlary gizlemek bilen birlikde).
Drift detektory: "Git-de" we "kärendede" deňeşdirme; tapawut ýüze çykan halatynda alert.
Nusgalar (exemplars): konfigurasiýalary okamak üçin 'trace _ id' -e baglanyşyk.

11) Adaty konfigurasiýalaryň katalogy (iGaming)

Payments routing: GEO/BIN/usuly boýunça PSP; retraýlaryň çäkleri; 3DS.
KYC/AML: üpjün edijiler, wagtlar, TTL, fallback/el barlagy düzgünleri.
Töwekgelçilik & RG: velocity-limitler, gündelik/aýlyk kaplar, geo-kadadan çykmalar.
Games/Core: kesiş koeffisiýentleri, pullaryň ululyklary, fiçeflaglar (gaýtalanmalaryň taryhy, täze usullar).
Ops/Observability: alert bosagalary, sampling düzgünleri, retention synplary, sintetika.
Status/Comms: Habar şablonlary, lokalizasiýa, täzelenme tertibi.

12) Konfigurasiýa bukjasynyň mysaly (manifest)

yaml apiVersion: cfg. platform/v1 kind: ConfigRelease metadata:
id: payments-routing-2025-11-01 change: "RTE-421: reroute TR BIN_4571 → PSP2"
spec:
scope:
tenants: [brandA, brandB]
regions: [EU]
segments:
geo: [TR]
strategy:
steps:
- name: canary coverage: "5%"
duration: "20m"
- name: ramp coverage: "25%"
duration: "30m"
- name: region-full"
coverage: "100%"
gates:
require:
- policy: "slo-green"
- approval: ["Payments Lead","Compliance"]
- freeze: "not-in-effect"
rollback:
to: "payments-routing-2025-10-29"
autoIf:
- metric: "auth_success_rate"
condition: "drop>10% for 10m"

13) Yza gaýdyp gelmek (rollback) we üýtgeşmeleriň howpsuzlygy

Git arkaly tersine:' revert '/" promote previous".
Atom geçiriji: okyjylar öňki snapshot-a geçýärler.
Awto-yza gaýdyp gelmegiň ölçegleri: SLI/KRI-iň pese gaçmagy, parsing/walidator ýalňyşlyklarynyň köpelmegi.
Aragatnaşyk: waka-bot awto-yza gaýdyp baranda statusy çap edýär.

14) Multi-tenant we geo-rezidensiýa

Faýllar/bukjalar we açarlar derejesindäki atlar boşlugy ('tenant/region/env').
Okamak syýasaty: hyzmatlar diňe öz hilini görýär.
Konfigurasiýalaryň geo-nusgalary (EU/LATAM/APAC) we SLA-dan göçürmeleriň gijikdirilmegi.
Dürli ýurisdiksiýalar üçin dürli aýlaw penjireleri (complayens/baýramçylyklar).

15) Öndürijilik we çykdajy (FinOps)

Snapshot keş: lokal/paýlanan; TTL/ETag/If-None-Match.
Konfigurasiýalaryň ululygy: gurluşlaryň göwrümi we çuňlugy boýunça çäkler; modullara bölmek.
Giriş kartasy: okamagyň esasy sarp edijileri; pulling ýygylygyny optimizirlemek.
Ýalňyşlyklaryň bahasy: "gymmat" gaýdyşlary/goşmaça kanareýalary hasaplaýjy.

16) Integrasiýa

Alerting/SLO: mahabat derwezesi, awto-yza gaýdyp gelmek.
Release-gates: konfigurasiýalaryň aýlanmagy tamamlanmasa kod goýberilişlerini blokirlemek.
Waka-bot: '/config promote ', '/config rollback', difflere we dashbordlara baglanyşyklar.
Workflow Engine: ýokary töwekgelçilikli üýtgeşmeler üçin adam-task; eskalasiýa wagtlary.

17) KPI/KRI funksiýalary

Lead Time konfigurasiýalary: PR → Prod.
Change Failure Rate (CFR): yzyna gaýtarmak bilen üýtgeşmeleriň paýy.
MTTR hadysasy.
Drift rate: tapawut ýygylygy Git runtime.
SLO-gates pass rate: elden aýrylmazdan geýtlerden geçen üýtgeşmeleriň paýy.
Üýtgetmek üçin bahasy: CPU/IO, kanareýkalar, hadysalar.

18) Durmuşa geçirmegiň ýol kartasy (6-10 hepde)

Ned. 1-2: konfigurasiýalaryň, shemalaryň, linterleriň katalogy; Git-repo; esasy CI (validasiýa/diff).
Ned. 3-4: GitOps-rekonsaýler, dry-run/staging, status-daşbordlar; TTL bilen fiçeflaglar.
Ned. 5-6: policy-as-code (SoD/penjireler/freeze/SLO-geýtlar), kanareýanyň aýlawlary, awto-yza gaýdyş.
Ned. 7-8: drift detektor, KMS arkaly syrlar, köp tenant we geo-göçürmeler, integrasiýa hadysasy.
Ned. 9-10: ýüklemek/bulam-bujarlyk synaglary, FinOps-hasabat, buýruklary taýýarlamak we şablonlar.

19) Artefaktlaryň şablonlary

PR Template: maksat, töwekgelçilik synpy, sebit (tenant/region), togalamak meýilnamasy, yzyna gaýtarmak meýilnamasy, dry-run netijeleri.
Policy Pack: SLO-geýtlar, SoD/4-eyes, freeze-senenama, ululyk/kardinallyk çäkleri.
Runbook: "kanareýkalaryň häzirki wersiýasyny/diff/ýagdaýyny nädip okamaly", "mahabaty el bilen nädip saklamaly".
Config Catalog: eýesi, shema, okyjylar, täzelenmeleriň ýygylygy, laýyk bellikler.

20) Antipatternler

Git/auditsiz "dolandyryjyda" el bilen düzedişler.
Gyzgyn çalyşmak mümkinçiligi bolmazdan, goýberilen artefaktyň kody bilen garylan konfigiler.
Parsingde shemalaryň/tassyklamalaryň ýoklugy.
Kanareýalarsyz global bir gezeklik aýlaw.
Konfigadaky umumy syrlar; Git-de syrlar.
Ficheflaglarda/TTL/guardrails ýok.
Drift detektorynyň ýoklugy.
SLO geýtlerini "jaň" arkaly we hasaba alynmazdan aýyrmak.

Jemi

Konfigurasiýalary ýerleşdirmek dolandyrylýan konweýer: shemalary bolan maglumatlar → syýasatlar we oýunlar → GitOps we progressiw eltip bermek → gyzgyn ýüklemek we yzyna gaýtarmak → gözegçilik we gözegçilik → howpsuzlyk we çykdajy. Şeýle çarçuwa, SLO-ny, girdejini we kadalaşdyryjy talaplara laýyklygyny saklamak bilen iGaming platformasynyň özüni alyp barşyny çalt we ygtybarly üýtgetmäge mümkinçilik berýär.