إعداد خادم معاينة خاص

هذا الدليل مخصَّص للمطوّرين الذين يستخدمون Cloud Run لوضع العلامات من جهة الخادم الذين يريدون إعداد خادم معاينة خاص.

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

نظرة عامة

عند نشر وضع العلامات من جهة الخادم على Cloud Run، يمكنك نشره مع جهاز موازنة الحمل أو بدونه. بالنسبة إلى عمليات النشر متعددة المناطق، ستحتاج إلى جهاز موازنة الحمولة لتوجيه حركة البيانات إلى أقرب مثيل.

بدون جهاز موازنة الحمل

بدون استخدام جهاز موازنة الحمل

الشكل 1: النشر بدون جهاز موازنة الحمل.

مع جهاز موازنة الحمل

باستخدام جهاز موازنة الحمل

الشكل 2: النشر باستخدام جهاز موازنة الحمل.

وفي كلتا عمليتَي النشر، تكون نقطة الدخول لكل من خادم المعاينة وبيئة وضع علامات الإنتاج هي عنوان URL نفسه (مثل sgtm.example.com)، حيث يتم نشر خادم وضع العلامات مع متغيّر بيئة يُسمى PREVIEW_SERVER_URL الذي يمثّل عنوان URL لخادم المعاينة.

عند الانتقال إلى tagmanager.google.com وفتح وضع المعاينة، تنتقل أداة "إدارة العلامات من Google" إلى sgtm.example.com?id=[gtm_server_id]&gtm_auth=[auth_id]&gtm_preview=[env_id] وتضبط ملف تعريف ارتباط. عند استخدام المتصفّح نفسه لاستكشاف الموقع الإلكتروني المستهدَف، إنّ الطلبات المرسَلة إلى sgtm.example.com تعيد أيضًا توجيه ملف تعريف الارتباط. وبسبب ملف تعريف الارتباط، يعرف خادم وضع العلامات أن هذه هي أحداثك، لذا فهو يعيد توجيه الأحداث فقط إلى خادم المعاينة لتتمكن من الاطّلاع عليها وتحديد المشاكل فيها وحلّها.

يعيد خادم وضع العلامات توجيه هذه الأحداث من خلال تقديم طلبات HTTP إلى عنوان URL المحدَّد في متغيّر بيئة PREVIEW_SERVER_URL.

معلومات عن خوادم المعاينة المتاحة للجميع

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

  • إمكانية تحكُّم إضافية في الميزات، مثل سياسات طبقة المقابس الآمنة (SSL) لحظر مجموعات الرموز
  • الدمج الأصلي مع Cloud Armor للجدار الناري لتطبيقات الويب (WAF) أو لهجمات الحرمان من الخدمات الموزَّعة (DDoS).
  • إمكانات متقدمة لإدارة الزيارات

توجيه خادم المعاينة من خلال جهاز موازنة الحمل

لإنشاء خادم معاينة خاص، استخدِم التوجيه المستند إلى المضيف من خلال موازن التحميل مع نطاق فرعي إضافي. يوضّح هذا الدليل كيفية توجيه خادم المعاينة من خلال موازن تحميل.

المتطلبات الأساسية

  • يتم نشر خادم وضع العلامات على Cloud Run باستخدام جهاز موازنة الحمل.
  • الوصول إلى مشروع Google Cloud
  • الوصول إلى نطاق فرعي جديد لخادم المعاينة، على سبيل المثال، preview.sgtm.example.com.

الخطوة 1: تعديل متغيّر البيئة باستخدام نطاق فرعي جديد

لاستخدام نطاق خادم المعاينة الجديد، عليك تعديل متغيّر بيئة خادم وضع العلامات من جهة الخادم PREVIEW_SERVER_URL:

  1. افتح Cloud Run.
  2. اختَر خادم وضع العلامات.
  3. انقر على تعديل ونشر نسخة جديدة.
  4. ضمن علامة التبويب المتغيّرات والأسرار، في قسم الحاويات، غيِّر PREVIEW_SERVER_URL إلى النطاق الجديد. مثلاً: preview.sgtm.example.com.

الخطوة 2: ضبط جهاز موازنة الحمل الحالي لاستخدام التوجيه المستند إلى المضيف

لضبط جهاز موازنة الحمل الحالي، استخدِم التوجيه المستند إلى المضيف وأرسِل حركة البيانات إلى الخادم الصحيح:

  1. في Cloud Run، افتح صفحة موازنة الحمل وانقر على اسم جهاز موازنة الحمل.
  2. انقر على الزر تعديل.
  3. انقر على صفحة تهيئة الخلفية وافتح القائمة المنسدلة خدمات الخلفية ومجموعات بيانات الخلفية.
  4. انقر على إنشاء خدمة خلفية وأكمل ما يلي:
    1. امنحه اسمًا مناسبًا (على سبيل المثال، preview-backend-service).
    2. اختَر نوع الخلفية على أنّه مجموعة نقاط نهاية الشبكة بدون خادم.
  5. في قسم الخلفية، أنشئ مجموعة جديدة لنقاط نهاية الشبكة بدون خادم وأكمل ما يلي:
    1. أدخِل اسمًا واختَر المنطقة التي تتم استضافة خادم المعاينة فيها.
    2. اختَر Cloud Run كنوع مجموعة نقطة نهاية الشبكة بدون خادم، واختَر خادم المعاينة باعتباره الخدمة.
    3. انقر على إنشاء.
  6. غيّر الإعدادات الأخرى حسب الحاجة أو احتفظ بالإعدادات الافتراضية، وانقر على إنشاء.

الخطوة 3: إضافة قاعدة جديدة وتعديل عنصر تحكُّم الدخول

لإضافة قاعدة لعنوان URL للمضيف الجديد وتعديل عنصر تحكّم الدخول:

  1. افتح صفحة قواعد المضيف والمسار.
  2. أضِف قاعدة جديدة حيث:
    • المضيف هو عنوان URL الجديد: preview.sgtm.example.com
    • المسار هو: /*
    • الخلفية هي: preview-backend-service
  3. انقر على الزر تعديل لإعادة تفعيل جهاز موازنة الحمل.
  4. ارجع إلى Cloud Run، افتح خادم المعاينة، ثم اختَر علامة التبويب Networking (الشبكات).
  5. غيِّر عنصر التحكم في الدخول إلى داخلي واختَر السماح بالزيارات من أجهزة موازنة حمل التطبيقات الخارجية حتى لا يمكن للجميع الوصول إليها.

النتيجة: من المفترض أن تظهر بنية الخادم الآن على النحو الشكل 3، حيث يتم توجيه جميع طلبات الزيارات إلى خادم وضع العلامات، ويصبح بإمكان خادم وضع العلامات إعادة توجيه الطلبات إلى خادم المعاينة.

التوجيه المستند إلى المضيف

الشكل 3: استخدام التوجيه المستند إلى المضيف.

التحقّق من الإعدادات

للتحقّق من الإعدادات:

  1. افتح أداة "إدارة العلامات من Google".
  2. افتح حاوية الخادم.
  3. انقر على المشرف > إعدادات الحاوية واضبط عنوان URL لحاوية الخادم على عنوان URL لخادم المعاينة.
  4. أغلق النافذة وعاين مساحة العمل. ستفتح نافذة تصحيح الأخطاء. أثناء التنقّل في موقعك الإلكتروني، من المفترض أن تظهر أحداثك في نافذة تصحيح الأخطاء.