نماذج "الإعداد عن بُعد" وتحديد الإصدارات


قوالب Remote Config هي مجموعات من المَعلمات والشروط المنسَّقة بتنسيق JSON والتي أنشأتها لمشروع Firebase. يمكنك إنشاء نماذج العميل التي يسترد منها تطبيقك القيم، ونماذج الخادم التي يمكن لعملاء الخادم استرداد القيم منها.

يناقش هذا القسم نماذج الخادم. للتعرّف على نماذج خاصة بالعملاء، انقر على نماذج العملاء.

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

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

{
  "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، انتقِل إلى صفحة عمليات تطوير البرامج وإشراك المستخدمين > الإعداد عن بُعد > المَعلمات.

  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، انتقِل إلى صفحة عمليات تطوير البرامج وإشراك المستخدمين > الإعداد عن بُعد > المَعلمات.

  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 النشط بتنسيق JSON:

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

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

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

التحقّق من صحة نموذج الإعداد عن بُعد

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

نشر نموذج Remote Config

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

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

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

استخدِم الأوامر التالية لنشر النموذج:

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

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

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

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

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