إدارة نماذج خادم الإعداد عن بُعد وإصداراته

اختيار نوع النموذج: نماذج العميل نماذج الخادم


قوالب Remote Config هي مجموعات من المَعلمات والشروط المنسَّقة بتنسيق JSON والتي تم إنشاؤها لمشروع Firebase الخاص بك. تقدّم نماذج الخادم الإعدادات إلى مثيلات الخادم باستخدام Firebase Admin SDK لـ Remote Config (متاحة للغات Node.js وJava وPython وGo).

يمكنك استخدام وحدة تحكّم Firebase لتعديل نموذج الخادم وإدارته. انتقِل إلى DevOps & Engagement > الإعداد عن بُعد لعرض محتوى النموذج بتنسيق رسومي في صفحة المَعلمات وصفحة الشروط.

في ما يلي مثال على ملف نموذج الخادم:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

يمكنك تنفيذ مهام إدارة الإصدارات هذه في وحدة تحكّم Firebase (انتقِل إلى DevOps ومعدّل الاهتمام بالتطبيق > الإعداد عن بُعد):

  • عرض قائمة بجميع إصدارات النماذج المخزَّنة
  • استرداد إصدار معيّن
  • العودة إلى إصدار خادم معيّن
  • حذف نماذج Remote Config من صفحة سجلّ التغييرات

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

في كل مرة تعدّل فيها المَعلمات، ينشئ Remote Config نموذج Remote Config جديدًا يتضمّن معلومات الإصدار ويخزّن النموذج السابق كإصدار يمكنك استرداده أو الرجوع إليه حسب الحاجة. يتم زيادة أرقام الإصدارات بالتسلسل من القيمة الأولية التي يخزّنها Remote Config. تتضمّن جميع النماذج الحقل version كما هو موضّح، والذي يحتوي على بيانات وصفية حول هذا الإصدار المحدّد.

يمكنك حذف نماذج Remote Config حسب الحاجة في صفحة عمليات DevOps ومعدّل الاهتمام بالتطبيق > الإعداد عن بُعد > سجل التغييرات في وحدة تحكّم Firebase.

إدارة نُسخ نموذج Remote Config

يوضّح هذا القسم كيفية إدارة إصدارات نموذج خادم Remote Config.

عرض جميع الإصدارات المخزَّنة من النموذج Remote Config

يمكنك استرداد قائمة بجميع الإصدارات المخزّنة من النموذج Remote Config. ولإجراء ذلك:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات التطوير والتشغيل والتفاعل > Remote Config > المَعلمات.

  2. انقر على رمز "الساعة" المعروض في أعلى يسار الشاشة.

    يؤدي ذلك إلى فتح صفحة سجلّ التغييرات التي تعرض جميع إصدارات النماذج المخزّنة في قائمة على يسار الصفحة.

    تتضمّن قائمة النماذج بيانات وصفية لجميع النُسخ المخزّنة، بما في ذلك وقت التعديل والمستخدم الذي أجراه وطريقة إجرائه.

استرداد إصدار محدّد من نموذج Remote Config

يمكنك استرداد أي نسخة محدّدة مخزّنة من نموذج Remote Config. في ما يلي كيفية استرداد نسخة نموذج مخزَّنة:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات DevOps ومعدّل الاهتمام بالتطبيق > الإعداد عن بُعد > سجل التغييرات.

  2. تعرض الصفحة النموذج النشط الحالي بشكلٍ تلقائي. لعرض إصدار مختلف، اختَره من لوحة التفاصيل على اليسار.

  3. يمكنك الاطّلاع على اختلاف مفصّل بين النموذج النشط وأي نسخة أخرى مخزّنة من خلال تمرير مؤشر الماوس فوق قائمة السياقات لأي نسخة غير محدّدة واختيار المقارنة مع النسخة المحدّدة.

الرجوع إلى إصدار معيّن مخزَّن من نموذج Remote Config

يمكنك العودة إلى أي نسخة مخزّنة من النموذج. في ما يلي كيفية التراجع عن تغييرات أجريتها على نموذج:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات DevOps ومعدّل الاهتمام بالتطبيق > الإعداد عن بُعد > سجل التغييرات.

  2. ابحث عن زر الخيار في أعلى يسار الصفحة لعرض إصدارات النماذج السابقة المؤهَّلة للتراجع.

  3. يجب النقر على هذا الخيار وتأكيده فقط إذا كنت متأكّدًا من أنّك تريد الرجوع إلى هذا الإصدار واستخدام هذه القيم على الفور لجميع التطبيقات والمستخدمين.

يُرجى العِلم أنّ عملية التراجع هذه تؤدي فعليًا إلى إنشاء إصدار جديد مرقّم. على سبيل المثال، تؤدي عملية الرجوع من الإصدار 10 إلى الإصدار 6 إلى إنشاء نسخة جديدة من الإصدار 6 تختلف عن النسخة الأصلية في رقم الإصدار فقط، أي 11. سيظل الإصدار 6 الأصلي مخزّنًا، ما لم تنتهِ صلاحيته، وسيصبح الإصدار 11 هو النموذج النشط.

حذف نموذج Remote Config

يمكنك حذف نماذج Remote Config باستخدام وحدة تحكّم Firebase. في ما يلي كيفية حذف نموذج:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات التطوير والتشغيل والتفاعل > Remote Config > المَعلمات.

  2. انقر على سجلّ التغييرات.

  3. انتقِل إلى النموذج الذي تريد حذفه، وانقر على المزيد، ثم انقر على حذف.

  4. عندما يُطلب منك تأكيد الحذف، انقر على حذف.

تنزيل نماذج Remote Config ونشرها

نزِّل نماذج Remote Config وانشرها لدمجها في أنظمة التحكّم في المصدر والإنشاء، وأتمِت تعديلات الإعدادات، وحافظ على مزامنة المَعلمات والقيم في مشاريع متعددة.

يمكنك تنزيل نموذج Remote Config النشط حاليًا من وحدة تحكّم Firebase. يمكنك بعد ذلك تعديل ملف JSON الذي تم تصديره ونشره في المشروع نفسه، أو نشره في مشروع جديد أو حالي.

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

يمكنك أيضًا استخدام هذه الطريقة لنقل الإعدادات من مشروع إلى آخر، أو لملء مشروع جديد بالمَعلمات والقيم من مشروع حالي.

لا يتم تضمين المَعلمات وقيم المَعلمات التي تم إنشاؤها خصيصًا كخيارات في تجربة A/B Testing ضمن النماذج التي يتم تصديرها.

لتصدير نماذج Remote Config واستيرادها، اتّبِع الخطوات التالية:

  1. نزِّل نموذج Remote Config الحالي.
  2. تحقَّق من صحة نموذج Remote Config.
  3. انشر نموذج Remote Config.

تنزيل نموذج Remote Config الحالي

استخدِم ما يلي لتنزيل نموذج Remote Config النشط بتنسيق JSON:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات التطوير والتشغيل والتفاعل > الإعداد عن بُعد > المَعلمات أو الشروط.

  2. افتح القائمة، ثم انقر على تنزيل ملف الإعداد الحالي.

  3. عندما يُطلب منك ذلك، انقر على تنزيل ملف الإعداد، واختَر المكان الذي تريد حفظ الملف فيه، ثم انقر على حفظ.

التحقّق من صحة نموذج Remote Config

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

نشر نموذج Remote Config

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

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

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

اتّبِع الخطوات التالية لنشر النموذج:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات التطوير والتشغيل والتفاعل > الإعداد عن بُعد > المَعلمات أو الشروط.

  2. افتح القائمة، ثم اختَر النشر من ملف.

  3. عندما يُطلب منك ذلك، انقر على تصفّح، وانتقِل إلى ملف Remote Config الذي تريد نشره واختَره، ثم انقر على اختيار.

  4. يتم التحقّق من صحة الملف. في حال نجاح عملية التحقّق، انقر على نشر لإتاحة الإعدادات على الفور لتطبيقاتك ومستخدميك.

الخطوات التالية