يجب ألا تعتمد الخدمة (Serving) على Manager
يبقى مسار الاستعلام (Query path) على عقدة DNS وآخر حالة تم التحقق منها.

AUTHORITATIVE DNS / GLOBAL TRAFFIC
تجتمع إدارة API-first للحالة المطلوبة في DNS و Validation و Immutable Revision و Blue/Green Delivery و Health-aware Routing و DNSSEC ودورة حياة العقد في عملية واحدة، بينما يبقى Query Path مستقلاً عن Manager.
مكوّنات 4SO GeoDNS: مسار الاستعلام مستقل عن مسار التحكم
تأتي إجابات 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 ومرونة واسعة النطاق |
المعمارية
يجب أن يمر تغيير 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 غير المرتبطة. |
دورة الحياة
الانتقال من Edit إلى Publish ليس مجرد بضع نقرات؛ فلكلٍّ من Validation و Revision و Stage وقراءة الحالة والاستعادة حالة محددة.
مسار الفشل والاستعادة
ملفات القدرات
لكل طبقة، من Authoritative Data إلى Global Traffic و Security، Profile تشغيلي مستقل.
إدارة Zone و RRset عبر Revision.
إجابة مبنية على Endpoint و Policy.
Trust و Transfer security داخل المنتج.
دورة حياة عقد Serving.
إطلاق آمن وقابل للتراجع.
حماية حالة الإدارة.
تدفق Job و Cutover و Recovery
عمليات 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 غير النشط.
تُحاكى Geo/Network policy قبل publish.
لا تنضم Node إلى fleet إلا بعد trust و serving verification.
تجري Key lifecycle مع overlap و serving acknowledgement.
يرتبط Restore و site failover بـ readiness evidence.
تؤثر Health و Node replacement مباشرةً في جودة Serving، ولذلك يجب أن يكون لكل منهما Flow مستقل.
تُجمع Health خارج Query hot path وتتحول إلى snapshot ذات إصدار.
لا تخرج Node القديمة إلا بعد جاهزية Replacement و Serving verification.
| 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.