إعداد وضع العلامات من جهة الخادم باستخدام Cloud Run

يوضّح هذا الدليل كيفية:

  • يُرجى توفير خادم معاينة لتفعيل ميزة المعاينة للحاوية.
  • توفير خادم وضع العلامات للتعامل مع حركة المرور المباشرة
  • زيادة أو تقليل عدد الخوادم التي تشغّل حاويتك على أداة "إدارة العلامات من Google".
  • الحفاظ على تحديث إصدار خادم وضع العلامات بعد توفير الخادم.

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

  1. تحتاج إلى حساب Google Cloud Platform (GCP). إذا لم يكن لديك حساب، أنشئ حسابًا جديدًا على Google Cloud Platform.
  2. تحتاج إلى حساب فوترة Google Cloud Platform. إذا لم يكن لديك حساب، يمكنك إنشاء حساب فوترة Google Cloud Platform (يتطلّب ذلك دور "منشئ حساب الفوترة").
  3. ستحتاج إلى دور "منشئ المشروع" و"مستخدم حساب الفوترة". مزيد من المعلومات حول إضافة الأدوار

توفير خادم للمعاينة ووضع العلامات

يمكنك توفير خدمة Cloud Run إما تلقائيًا في "إدارة العلامات من Google" أو يدويًا في Google Cloud.

تعديل إعدادات الخدمة

لتغيير إعدادات الخدمة، اتّبِع الخطوات التالية:

  1. فتح Cloud Run
  2. اختَر الخدمة التي تريد تعديلها.
  3. انقر على تعديل النسخة الجديدة ونشرها.
  4. أجرِ التغييرات وانقر على نشر.

تكلفة تشغيل السحابة الإلكترونية

في إعدادات Cloud Run هذه، تبلغ تكلفة كل خادم 45 دولارًا أمريكيًا تقريبًا في الشهر (دولار أمريكي). ويمثّل كل خادم مثيلاً في Cloud Run مع وحدة معالجة مركزية افتراضية واحدة (vCPU) وذاكرة بسعة 0.5 غيغابايت باستخدام نموذج الأسعار المخصّص دائمًا لوحدة المعالجة المركزية (CPU).

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

سيتغير Cloud Run بشكل ديناميكي مع التحميل. الإعداد max-instances هو أسوأ سيناريو للمبلغ الذي ستحتاج إلى دفعه مقابل الموارد. لن يقوم Cloud Run بتوفير هذه المثيلات إلا عند الضرورة.

حاسبة التشغيل على السحابة الإلكترونية

اختياري: النقل من App Engine

إذا سبق لك إنشاء نشر App Engine وتأكدت من أنه لم يعد يتلقى أي زيارات، فعطّل تطبيق App Engine لمنع رسوم الفوترة غير المتوقعة.

اختياري: النشر متعدد المناطق

إذا كان لموقعك الإلكتروني حضورًا عالميًا أو كنت تريد زيادة التكرار في الخدمة، انشر خوادم وضع العلامات في مناطق متعدّدة.

قبل البدء:

  1. إنشاء جهاز لموازنة الحمل
  2. دوِّن BACKEND_NAME الذي اخترته.

لإضافة المزيد من المناطق إلى عملية النشر:

  1. استبدِل REGION بالمنطقة التي يتم نشر خادم المعاينة فيها. ربما يكون قد تم ملء هذا مسبقًا إذا اتّبعت خيارات سطر الأوامر لتوفير خادم المعاينة ووضع العلامات.
  2. استبدِل CONTAINER_CONFIG بسلسلة إعدادات الحاوية من "إدارة العلامات من Google". ربما يكون قد تم ملء هذا بالفعل إذا اتّبعت خيارات سطر الأوامر لتوفير خادم المعاينة ووضع العلامات.
  3. استبدِل NEW_REGION بالمنطقة الجديدة التي تريد تفعيل خادم وضع العلامات فيها.
  4. استبدِل BACKEND_NAME بالاسم الذي اخترته أثناء توفير جهاز موازنة الحمل.
  5. اختياري: لإضافة منطقة أخرى، استبدِل المتغيّر NEW_REGION وأعِد تشغيل مقتطف الرمز.
    gcloud run deploy "server-side-tagging" \
    --region NEW_REGION \
    --image gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable \
    --platform managed \
    --ingress all \
    --min-instances 2 \
    --max-instances 10 \
    --timeout 60 \
    --allow-unauthenticated \
    --no-cpu-throttling \
    --update-env-vars PREVIEW_SERVER_URL="$(
      gcloud run services describe server-side-tagging-preview \--region "REGION" \
      --format="value(status.url)")",CONTAINER_CONFIG="CONTAINER_CONFIG" && \

    gcloud compute network-endpoint-groups create server-side-tagging-neg \
    --region=NEW_REGION \
    --network-endpoint-type=SERVERLESS \
    --cloud-run-service="server-side-tagging" && \

    gcloud compute backend-services add-backend --global "BACKEND_NAME" \
    --network-endpoint-group-region=NEW_REGION \
    --network-endpoint-group=server-side-tagging-neg

اختياري: إيقاف التسجيل

طلب التسجيل

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

لإيقاف تسجيل الطلبات:

  1. في Google Cloud Platform، افتح جهاز توجيه السجلات. يُرجى التأكّد من أنّك ضمن المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشروع Google Cloud Platform، وتعرض نموذج رقم تعريف حاوية أداة "إدارة العلامات من Google".
  2. بالنسبة إلى النوع: حزمة تسجيل Cloud، والسطر الاسم: _Default، اختَر القائمة الكاملة، ثم انقر على تعديل المستودع.
  3. ضمن وجهة الوعاء، اختَر حزمة السجلات _Default.

  4. ضمن اختيار السجلات لتضمينها في المستودع، أضِف سطرًا جديدًا. أدخِل القاعدة التالية في فلتر الإدراج الحالي:

    NOT LOG_ID("run.googleapis.com/requests")

  5. لإيقاف التسجيل من جهاز موازنة الحمل أيضًا، أضِف سطرًا جديدًا وأدخِل القاعدة التالية إلى فلتر الإدراج الحالي:

    NOT LOG_ID("requests")

  6. عدِّل مصدر البيانات لتطبيق التغييرات. سيتم الآن استبعاد الطلبات من التسجيل.

  7. تأكَّد من عدم ظهور أي طلبات جديدة في سجلّات مستكشف السجلات.

تسجيل وحدة التحكّم

يمكن لخادم وضع العلامات أو العملاء أو العلامات الموجودة في الحاوية تسجيل الرسائل في وحدة التحكّم التي قد تتكبد رسوم تسجيل. لتقليل رسوم التسجيل أو إلغائها، يمكنك إيقاف رسائل سجلّ وحدة التحكّم غير المرغوب فيها.

تحديد سجلات وحدة التحكم غير المرغوب فيها:

  1. في Google Cloud Platform، افتح مستكشف السجلات.

  2. ابحث عن أي رسائل سجلّ غير مرغوب فيها تنشأ من علاماتك. على سبيل المثال:

    يمكن أن ترسل العلامة السجلّات التالية:

    const logToConsole = require('logToConsole');

logToConsole('Custom message: ' + data.param1);
logToConsole('An important message to keep around!');
data.gtmOnSuccess()

    ابحث عن رسائل السجلّ المقابلة في الحقل textPayload:
    لقطة شاشة لأداة "مستكشف سجلات Google Cloud Platform" تعرض نماذج للسجلات.

لإيقاف رسالة سجلّ وحدة التحكّم:

  1. في Google Cloud Platform، افتح جهاز توجيه السجلات. يُرجى التأكّد من أنّك ضمن المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشروع Google Cloud Platform، وتعرض نموذج رقم تعريف حاوية أداة "إدارة العلامات من Google".
  2. بالنسبة إلى النوع: حزمة تسجيل Cloud، والسطر الاسم: _Default، اختَر القائمة الكاملة، ثم انقر على تعديل المستودع.
  3. ضمن وجهة الوعاء، اختَر حزمة السجلات _Default.

  4. ضمن اختيار السجلات لتضمينها في المستودع، أضِف سطرًا جديدًا. أدخِل القاعدة التالية في فلتر الإدراج الحالي:

    NOT textPayload:"Custom message:"

    بالنسبة إلى سجلّات وحدة التحكّم، استبدِل نص "Custom message:" بسلسلة فرعية من سجلّ وحدة التحكّم الذي تريد إيقافه. للحصول على فلاتر أكثر تفصيلاً، استخدِم لغة طلب البحث لتسجيل الدخول.

  5. عدِّل مصدر البيانات لتطبيق التغييرات. يجب استبعاد رسالة logToConsole المتطابقة من التسجيل.

  6. تحقَّق من عدم ظهور أي رسائل جديدة في سجلّ وحدة التحكّم في مستكشف السجلات.

2- ربط عملية النشر بنطاقك الخاص

لإعداد نطاق خاص، استخدِم موازن حمل التطبيقات الخارجي العام.

3. إضافة عنوان URL الخاص بالخادم إلى أداة "إدارة العلامات من Google"

الآن بعد أن أصبح لديك خادم، عليك التأكّد من أنّ أداة "إدارة العلامات من Google" تعلم أنّه يجب أن تستخدم خادمك.

  1. افتح أداة "إدارة العلامات من Google".

  2. انقر على حاوية الخادم التي تريد أن توجّهها إلى خادم وضع العلامات.

  3. افتح إعدادات حاوية الخادم في علامة التبويب المشرف > إعدادات الحاوية.

  4. انقر على إضافة عنوان URL والصِق عنوان URL للخادم.

  5. حفظ والرجوع إلى مساحة العمل

4- التحقّق من الصحة

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

معاينة عناوين URL متعددة

في حال ربط عدة نطاقات بخادم وضع علامات واحد، احرص على إضافة كل عنوان URL إلى إعدادات الحاوية.

وإذا قدّمت عناوين URL متعدّدة، يجب أن تتطابق جميع المسارات (السلسلة التي تلي اسم النطاق).

الأعمال لا يعمل
عنوان URL 1: example.com/abc
عنوان URL 2: example2.com/abc		 عنوان URL 1: example.com/abc
عنوان URL 2: example2.com/def

في حال إضافة عدة عناوين URL، سيظهر لك رمز بجانب الزر معاينة يتيح لك اختيار عنوان URL لمعاينته.

تعديل إصدار خادم وضع العلامات

تحتوي التحديثات الجديدة لخادم وضع العلامات على إصلاحات للثغرات الأمنية وميزات جديدة. ننصحك بتحديث خادم وضع العلامات على الأقل لكل إصدار رئيسي في الإصدار (على سبيل المثال، الترقية من الإصدار 1.x.x إلى 2.x.x) عندما ترسل إليك أداة "إدارة العلامات من Google" إشعارًا بالتحديث.

لتحديث خادم وضع العلامات، انشر نسخة سابقة باستخدام الإعدادات نفسها التي استخدمتها سابقًا.

  1. افتح Cloud Run.
  2. اختَر الخدمة التي تريد تعديلها.
  3. انقر على تعديل النسخة الجديدة ونشرها.
  4. تأكَّد من ضبط عنوان URL لصورة الحاوية على gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable، ثمّ انقر على نشر.

للتحقّق من نجاح عملية التحديث:

  1. في حاوية الخادم، انقر على الزر معاينة لبدء جلسة تصحيح أخطاء جديدة وإرسال طلب في علامة تبويب منفصلة.
  2. في "الملخّص"، اختَر علامة التبويب وحدة التحكّم وتأكّد من عدم ظهور أيّ رسائل تطلب منك تحديث خادم وضع العلامات.

قد تعرض أداة "إدارة العلامات من Google" رسائل تطلب منك تعديل خادم وضع العلامات لمدة تصل إلى يوم واحد بعد تعديل الخادم بنجاح. ومع ذلك، ستعرض صفحة المعاينة رسالة حديثة حول إصدار خادم وضع العلامات.