Stage على Color غير النشط
يتم DNS read-back قبل تبديل Active Color.
BLUE
GREEN
VERIFY
DNS المرجعي وإدارة حركة المرور
تحكّم في DNS بمسار خدمة مستقل.
تجتمع إدارة API-first للحالة المطلوبة في DNS و Validation و Immutable Revision و Blue/Green Delivery و Health-aware Routing و DNSSEC ودورة حياة العقد في عملية واحدة، بينما يبقى Query Path مستقلاً عن Manager.

تأتي إجابات DNS من اللون النشط ولا تعتمد على Manager.
يجب أن يكون Authoritative DNS سريعاً ومتاحاً دائماً، وأن تكون تغييراته في الوقت نفسه دقيقة وقابلة للتدقيق (Audit) والتراجع (Rollback). يفصل GeoDNS مسار الإعداد (Configuration) عن مسار الخدمة (Serving).
يبقى مسار الاستعلام (Query path) على عقدة DNS وآخر حالة تم التحقق منها.
تتحول السجلات (Record) والسياسات (Policy) أولاً إلى Revision، ثم تمر بمرحلتي Stage و Verify.
تأتي صحة Endpoint وأهليته من Observation مقبولة، لا من حالة مصطنعة في المتصفح.
يجب أن تخضع المفاتيح (Key) والتوقيع (Sign) و Rollover والاستعادة لتحكم لا يقل عن إدارة Zone.
إلى جانب Authoritative Records، يعدّ GeoDNS كلاً من Delivery و Traffic Management ودورة حياة العقد جزءاً من المنتج نفسه.
Forward/Reverse Zone، ومجموعات RRset من نوع Typed، و Import/Export مضبوط.
Changeset و Snapshot Hash و Revision لأغراض Audit و Rollback.
Stage على Color غير النشط، ثم قراءة الحالة، ثم Cutover ذرّي.
Endpoint و Pool و Region و Health Perspective وسياسة الإجابة (Policy).
Signing وأدلة DS و Rollover و Restore/Reconcile.
TSIG و AXFR/IXFR و Catalog Zone ودورة حياة Secondary Provider.
Onboard و Drain و Replace و Remove و Fleet rollout.
Health و Metrics و Alert و Incident و Synthetic DNS Probe.
يبقى مسار Query المعتاد قصيراً: Resolver → عقدة DNS → بيئة التشغيل النشطة → الحالة المحلية. ولا يعتمد أي Query عادي في الإجابة على Manager أو على Database عابرة للمناطق.
الحد الأدنى من طوبولوجيا المنتج بسيط، وليس HA أو Multi-region شرطاً للبدء؛ إذ تُضاف العقد والمناطق (Region) تدريجياً.
| الملف | Control Plane | Serving Plane | الاستخدام |
|---|---|---|---|
| أساسي | Manager واحد | عقدة DNS واحدة | إعداد بسيط ومتكامل لـ Authoritative DNS |
| متعدد العقد | Manager مركزي | عدة عقد DNS | تكرار Serving و Rollout مضبوط |
| مواقع (Site) متعددة | Control Plane واحد | عقد في مواقع (Site) متعددة | فصل نطاقات الأعطال والقرب من Resolver |
| Multi-region | إدارة مركزية مع عمليات إقليمية | Serving مستقل في مناطق (Region) متعددة | Global Traffic ومرونة واسعة النطاق |
الانتقال من Edit إلى Publish ليس مجرد بضع نقرات؛ فلكلٍّ من Validation و Revision و Stage وقراءة الحالة والاستعادة حالة محددة.
لكل طبقة، من Authoritative Data إلى Global Traffic و Security، Profile تشغيلي مستقل.
إدارة Zone و RRset عبر Revision.
إجابة مبنية على Endpoint و Policy.
Trust و Transfer security داخل المنتج.
دورة حياة عقد Serving.
إطلاق آمن وقابل للتراجع.
حماية حالة الإدارة.
هذا القسم للمهندسين الذين يريدون معرفة طريقة عمل المنتج في الطبقات الأعمق: المكوّنات والحدود والسلوك عند الأعطال والعمليات القابلة للتنفيذ.
يجب أن يمر تغيير DNS عبر Validation و Revision و Delivery، أما إجابة DNS فتُقدَّم مباشرةً من بيئة التشغيل المُتحقَّق منها على العقدة.
| الطبقة | Component | المسؤولية | Fail-safe behavior |
|---|---|---|---|
| Product API | FastAPI + scoped RBAC | Zone/RRset و traffic policy و node lifecycle و typed validation | لا يعدّل Browser بيئة runtime الخاصة بـ DNS مباشرةً |
| Authority | PostgreSQL + transactional outbox | Desired state و audit وحالة job/revision | Mutation و event publication ضمن حدّ معاملاتي واحد |
| Delivery | Worker + mTLS Node Agent | Stage inactive color و read-back و verify و atomic cutover | يتوقف Failed delivery قبل الوصول إلى serving |
| DNS Edge | dnsdist | Stable serving entry واختيار active PowerDNS color | لا يعتمد Query path على Manager |
| Authoritative Runtime | PowerDNS blue/green + local PostgreSQL | تقديم آخر revision مُتحقَّق منها | عند Control-plane outage تستمر إجابات DNS من آخر state سليمة |
| Security | DNSSEC · TSIG · transfer policy | Signing و rollover و zone-transfer trust | لا تدخل Secret material إلى Panel/Audit/Evidence |
Geo-routing & Health Contract. يُقرأ قرار DNS من policy مُجمَّعة و snapshot محلية؛ ولا ينفّذ Query Path أي health-check شبكي لحظة الإجابة.
| المجال | المُدخل / Mechanism | العقد التقني |
|---|---|---|
| Client locality | ECS أو Recursive Resolver IP | يُستخدم ECS الصالح عندما يكون مسموحاً به؛ وإلا يكون Resolver IP أساس الاختيار. |
| Geo / network match | CIDR، ASN/Organization، Country/Subdivision/Continent/City | تُقيَّم Overrides الدقيقة و geography وفق priority رقمية وترتيب deterministic. |
| Native GeoIP | PowerDNS geoip backend + Country/ASN MMDB | يعمل GeoIP إلى جانب gpgsql؛ ولا تُنقل Zone data من authority الأساسية إلى YAML/GeoIP backend. |
| Health | TCP/UDP/HTTP/HTTPS/TLS/DNS/gRPC/ICMP probes | تُحسب Health خارج Query Path، وتُسجَّل حالات مثل HEALTHY/DEGRADED/SUSPECT/UNHEALTHY في snapshot ذات إصدار. |
| Policy compiler | Structured policy → trusted runtime material | لا يُقبل Arbitrary Lua؛ ويُنتج compiler مخرجات reproducible مع hash مرتبط بـ Revision. |
| Simulation | Resolver/ECS/time/health/dataset inputs | يمكن محاكاة Rule match و selected pool/endpoint و fallback path و answer و TTL قبل publish. |
| ECS cache isolation | Policy-aware cache keying | يجب ألا تتسرّب الإجابات المعتمدة على client network عبر cache بين سياقات ECS غير المرتبطة. |
عمليات Mutation هي idempotent و project-scoped؛ ولا تبقى node mutation و fleet rollout و certificate rotation مفتوحة في وقت واحد على العقدة نفسها. ويُحصَّن Worker ownership عبر lease و execution epoch.
يتم DNS read-back قبل تبديل Active Color.
لا ينفّذ Query path أي probe شبكي في لحظة الطلب.
يرتبط DR action بـ readiness hash و topology freeze.
يُجهَّز التغيير (stage) أولاً على color غير النشط.
العطل والاستعادةلا يغيّر Stage الفاشل Query Path النشط.
تُحاكى Geo/Network policy قبل publish.
العطل والاستعادةيُرفض Arbitrary Lua و priority conflict قبل serving.
لا تنضم Node إلى fleet إلا بعد trust و serving verification.
العطل والاستعادةلا يتحول Bootstrap failure إلى retry أعمى.
تجري Key lifecycle مع overlap و serving acknowledgement.
العطل والاستعادةلا تدخل Secret material إلى Panel/Audit/Evidence العامة.
يرتبط Restore و site failover بـ readiness evidence.
العطل والاستعادةUnknown external state → RECONCILE_REQUIRED، لا replay أعمى.
تؤثر Health و Node replacement مباشرةً في جودة Serving، ولذلك يجب أن يكون لكل منهما Flow مستقل.
تُجمع Health خارج Query hot path وتتحول إلى snapshot ذات إصدار.
العطل والاستعادةلا تُعدّ Health القديمة أو Unknown تلقائياً Healthy، ويجب ألا تنقل Traffic دون سبب.
لا تخرج Node القديمة إلا بعد جاهزية Replacement و Serving verification.
العطل والاستعادةما لم تُقدّم Replacement إجابات Authoritative صحيحة، لا تصل إزالة Node القديمة إلى مرحلتها النهائية.
| Action / Flow | Admission / Preconditions | Execution / Lock | Success Criterion | Failure / Recovery |
|---|---|---|---|---|
| Publish Zone / RRset | Typed validation و revision و policy compile قبل delivery | Stage على inactive color → node read-back → atomic cutover | تأكيد Authoritative answer/TTL و active revision من serving path | لا يغيّر Failed stage حالة serving؛ و rollback إلى color السليم المحفوظ |
| Traffic Policy | Structured policy و priority و simulation دون conflict | Compiler material ذات إصدار؛ وتُستهلك health snapshot خارج query path | تطابق Matched rule/pool/endpoint و synthetic DNS behavior مع revision | يُرفض Arbitrary Lua؛ ويفشل policy conflict قبل publish |
| Node Onboarding / Replace | Identity/mTLS و preflight وتوفّر node mutation | Durable job مع node lock؛ ويُرفض تداخل onboarding/day-2/fleet/cert-rotation | Node مرصودة بحالة healthy و rollout eligibility واضحة | لا يتحول Node onboarding failure إلى generic retry؛ وقد يلزم fresh bootstrap |
| DNSSEC / Certificate | Key/identity lifecycle و approval في العمليات الحساسة | Stage/overlap/ack و rotation workflow خاص بالمالك (owner-specific) | تطابق Signing/serving أو certificate observation مع generation المتوقعة | رفض Stale rotation/fleet mutation المتزامنة؛ وحذف secret material من public job projection |
| Control-plane Restore | يجب أن تكون Backup بحالة READY و repository-verified ومعها snapshot/hash evidence | Preflight → approval → execution → cutover | RESTORED فقط بعد preflight binding و runtime verification | Worker interruption/unknown external state → RECONCILE_REQUIRED؛ ويُمنع blind retry |
| DR Failover / Failback | يلزم Readiness job و topology freeze و fencing و rollback و RPO acknowledgement | يرتبط Action بـ readiness state/hash و profile revision | وصول Active site/traffic/database state إلى phase المتوقعة | رفض Stale readiness أو topology mismatch؛ ولا يُسمح بـ failback إلا من FAILED_OVER |
تصنيف إعادة المحاولة صريح للمشغّل: SAFE_TO_RETRY، RECONCILE_REQUIRED، FRESH_BOOTSTRAP_REQUIRED أو FRESH_HEALTH_REQUEST_REQUIRED. وفقدان Lease في workflows المُخِلّة بالخدمة (disruptive) لا يُعدّ أبداً إذناً بـ replay أعمى.
يستخدم المشغّل العملية نفسها في المنتج و Audit trail ذاته لتغيير Record أو Rollout العقد أو DNSSEC.
يتحكّم 4SO GeoDNS في التغييرات من دون إدخال Control Plane في مسار إجابة DNS.