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

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

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

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

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

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

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

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

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

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

تكلفة Cloud Run

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

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

ستتم زيادة عدد عمليات Cloud Run ديناميكيًا حسب عدد عمليات التحميل. يمثّل الإعداد max-instances أسوأ سيناريو للمبلغ الذي عليك دفعه مقابل الموارد. لن تنشئ أداة Cloud Run هذا العدد الكبير من النُسخ إلا إذا لزم الأمر.

أداة احتساب تكلفة Cloud Run

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

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

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

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

قبل البدء:

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

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

  1. استبدِل REGION بالمنطقة التي تم فيها نشر خادم المعاينة. قد يكون هذا الحقل مملوءًا في حال اتّباع خطوات خيارات سطر الأوامر لتوفير خادم المعاينة ووضع العلامات.
  2. استبدِل CONTAINER_CONFIG بسلسلة 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، افتح Logs Router. تأكَّد من أنّك في المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشاريع Google Cloud Platform، تعرِض عيّنة من رقم تعريف حاوية "إدارة العلامات من Google"
  2. بالنسبة إلى النوع: حزمة Cloud Logging، الاسم: سطر _Default، اختَر القائمة المنسدلة، ثم انقر على تعديل نقطة الربط.
  3. ضمن وجهة التصدير، اختَر حزمة السجلات _Default.

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

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

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

    NOT LOG_ID("requests")

  6. عدِّل "الوحدة المستهلكة" لتطبيق التغييرات. سيتم الآن استبعاد الطلبات من التسجيل.

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

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

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

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

  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، افتح Logs Router. تأكَّد من أنّك في المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشاريع Google Cloud Platform (منصة Google السحابية العامة) تعرِض نموذجًا لـ IDE لـ "إدارة العلامات من 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" رسائل تطلب منك تعديل خادم وضع العلامات لعدة أيام بعد تعديل الخادم بنجاح. ومع ذلك، ستعرض صفحة المعاينة رسالة محدّثة عن إصدار خادم وضع العلامات.