أدلة عملية

Cloud SQL يبقي Admin API داخل المنطقة، لكن العنوان يجب أن يتغير

|الكاتب: فريق تحرير QUASA|5 دقيقة للقراءة| 2
Cloud SQL يبقي Admin API داخل المنطقة، لكن العنوان يجب أن يتغير

أتاحت Google في 8 سبتمبر 2026 نقاط النهاية الإقليمية عمومًا لـCloud SQL for MySQL Admin API. وتوضح ملاحظات إصدار Cloud SQL for MySQL أن الطلبات تستطيع الآن المرور عبر واجهة أمامية وموازن حمل في منطقة المثيل، بما يبقي حركة الشبكة المعنية داخلها ويقلل الاعتماد على الواجهة العالمية.

يعني ذلك أن إبقاء مسار الإدارة داخل المنطقة يتطلب تغيير عنوان الخدمة من sqladmin.googleapis.com إلى sqladmin.{region}.rep.googleapis.com. ويؤكد تقرير Beyond the News المنشور في 9 سبتمبر 2026 انتقال الميزة إلى الإتاحة العامة في اليوم السابق، مع بقاء نطاقها محصورًا في حركة Admin API لا في اتصال التطبيق بقاعدة MySQL أو مكان تخزين صفوفها.

ما الذي يبقى داخل المنطقة؟

فصل مسار Cloud SQL Admin API الإقليمي عن اتصال التطبيق المباشر بمثيل MySQL

التغيير يخص مسار طلبات الإدارة المستخدمة لإنشاء مثيلات Cloud SQL أو تعديل إعداداتها أو الاستعلام عن الموارد والعمليات. النقطة العالمية تمرر هذه الطلبات عبر موازن حمل عالمي قبل وصولها إلى المنطقة المناسبة، بينما تستقبل النقطة الإقليمية الطلب في البنية الأمامية الخاصة بالمنطقة المحددة.

تشمل العزلة الإقليمية الواجهة الأمامية وموازن الحمل ومستوى التحكم الخاص به، كما تحدث إدارة الشهادات وإنهاء اتصال TLS على موازن الحمل الإقليمي. ووفق وصف Google، لا يؤدي تعطل واجهة أمامية أو موازن حمل في منطقة إلى تعطيل نقاط المناطق الأخرى.

هذه الحدود مهمة عند صياغة متطلبات الإقامة والسيادة. الميزة تغطي بيانات Admin API أثناء النقل ومعالجتها في الواجهة الأمامية الإقليمية، لكنها لا تجعل جميع مكونات Cloud SQL إقليمية تلقائيًا؛ فقد تظل بعض تبعيات الواجهة الخلفية والبيانات الوصفية معتمدة على مكونات عالمية، كما تبقى شبكات اتصال MySQL والأسرار والسجلات والمراقبة مسارات مستقلة.

صيغة العنوان تفرض مطابقة منطقة المورد

تحدد وثائق النقاط الإقليمية من Google الصيغة sqladmin.{region}.rep.googleapis.com، وتدرج مناطق الشرق الأوسط me-central1 وme-central2 وme-west1 ضمن المناطق المدعومة. لذلك يستخدم مثيل في me-central1 العنوان sqladmin.me-central1.rep.googleapis.com، فيما لا تدعم الخدمة عنوانًا متعدد المناطق مثل sqladmin.us.rep.googleapis.com.

تتحقق الخدمة من تطابق منطقة نقطة النهاية مع منطقة المورد في طلبات مثل GET وINSERT وUPDATE وPATCH وDELETE. إذا اختلفتا، يُرفض الطلب بخطأ من فئة 4xx؛ ومن ثم لا يصلح عنوان إقليمي واحد لإدارة مثيلات موزعة على مناطق متعددة.

يتغير نطاق عملية Instances.List أيضًا. يعيد العنوان العالمي المثيلات الموجودة في مختلف المناطق التي يملك المستخدم حق الوصول إليها، بينما تعرض النقطة الإقليمية مثيلات منطقتها فقط. أما طرق المصادقة ومسارات API وأجسام الطلبات وإصدارات v1 وv1beta4 فتبقى دون تغيير.

الجرد يبدأ من الشفرة ويمتد إلى CI/CD

جرد العنوان العالمي في الشفرة وCI/CD وربط كل عميل بنقطة Cloud SQL الإقليمية المناسبة

لا تتم الهجرة بتغيير DNS داخلي فقط، لأن العميل نفسه يجب أن يرسل الطلب إلى اسم المضيف الإقليمي. يبدأ الجرد بالبحث عن sqladmin.googleapis.com وعن حقول endpoint وbase URL في مستودعات الشفرة وقوالب البنية التحتية ومتغيرات البيئات ومديري الأسرار وصور الحاويات ووظائف CI/CD وأدوات التشغيل والاستجابة للحوادث.

ينبغي ربط كل موضع مكتشف بالمثيلات التي يديرها وبمناطقها. يشمل ذلك عملاء HTTP المخصصين وأوامر curl والمكتبات التي تسمح بتجاوز عنوان الخدمة، إضافة إلى المهام التي تجمع قائمة مثيلات المشروع أو تنفذ عمليات على موارد في أكثر من منطقة.

تحتاج gcloud CLI وTerraform إلى تجاوز يدوي بدل اختيار المنطقة تلقائيًا. تستخدم gcloud الخاصية api_endpoint_overrides/sql مع URL الإقليمي، بينما يستخدم Terraform متغير GOOGLE_SQL_CUSTOM_ENDPOINT متبوعًا بالمسار المناسب.

  1. احصر كل عميل أو مهمة تصدر طلبات Cloud SQL Admin API، وحدد الموارد والمناطق التي تستهدفها.
  2. استبدل عنوان الأساس فقط، مع إبقاء المصادقة ومسار API وإصدار الواجهة وجسم الطلب كما هي.
  3. قسّم المهام متعددة المناطق بحيث تستخدم كل مجموعة نقطة النهاية المطابقة لمواردها.
  4. احتفظ بإعداد قابل للعكس يعيد العميل إلى العنوان العالمي إذا ظهرت مشكلة تشغيلية أو تبعية غير متوافقة.

التحقق يقيس الطلب الفعلي لا نجاح DNS

اختبار تطابق منطقة Cloud SQL وظهور خطأ 4xx عند توجيه الطلب إلى منطقة مختلفة

حل اسم المضيف ونجاح اتصال TLS لا يثبتان أن النقل اكتمل. يبدأ الاختبار بطلبات قراءة منخفضة المخاطر، مع التحقق من ظهور المورد عبر المنطقة الصحيحة، واستمرار صلاحيات IAM والرموز المميزة، وتعامل العميل بوضوح مع خطأ 4xx عند تعمد استخدام منطقة غير مطابقة.

يجب مقارنة نتيجة Instances.List بالمخزون المتوقع داخل المنطقة، لا بالقائمة التي كان يعيدها العنوان العالمي. وإذا كانت أداة التدقيق تحتاج رؤية شاملة، فعليها استدعاء نقطة كل منطقة ثم تجميع النتائج بدل افتراض أن الطلب الإقليمي يعرض المشروع كاملًا.

بعد نجاح القراءة، يمكن اختبار الإنشاء والتعديل والحذف في بيئة غير إنتاجية. وتساعد سجلات الشبكة وسجلات التنفيذ في إثبات اسم المضيف الذي استدعته كل مهمة ومصدر خروج الطلب؛ كما ينبغي تجربة الرجوع إلى العنوان العالمي فعليًا، لأن تغيير متغير رئيسي لا يضمن أن جميع العمليات الفرعية والمكتبات التابعة تستخدمه.

الإتاحة العامة لا تلغي القيود التشغيلية

تقتصر إمكانية الوصول إلى نقطة Admin API الإقليمية حاليًا على اتصالات الشبكة العامة؛ فلا يمكن الاتصال بها من VPC أو عبر اتصال شبكة خاصة. ولا توفر Google Cloud Console أو Kubernetes Config Connector دعمًا لاختيارها، كما لا يدعمها Cloud SQL remote MCP server.

للنسخ الاحتياطية نطاق مختلف: تعاملها Cloud SQL كموارد عالمية كي تظل قابلة للاستعادة عبر المناطق، وتوصي باستخدام العنوان العالمي للوصول إليها تفاديًا للتعقيدات، رغم إمكان استخدام النقاط الإقليمية. أما BackupRuns فتُخدم من النقطة الإقليمية التابعة لمنطقة المثيل.

الحالة المؤكدة الآن هي إتاحة مسار إقليمي للإنتاج لطلبات Cloud SQL for MySQL Admin API، لا تحويل Cloud SQL كله إلى خدمة محصورة إقليميًا. نجاح النقل يعتمد على تغيير العنوان في كل عميل، ومطابقة منطقة كل مورد، وفصل المخزون والمهام متعددة المناطق، مع إبقاء الاستثناءات العالمية وخطة الرجوع واضحة.

اقرأ أيضًا:

مشاركة:

اشترك في نشرتنا الإخبارية

احصل على أحدث أخبار الويب 3 والذكاء الاصطناعي والعملات المشفرة مباشرة في بريدك.

0