مدیریت الگوهای سرور «پیکربندی از راه دور» و نسخه‌گذاری

نوع الگو را انتخاب کنید: الگوهای کارخواه الگوهای سرور


Remote Config الگوها مجموعه‌ای از پارامترها و شرایط با قالب JSON هستند که برای پروژه Firebase شما ایجاد شده‌اند. الگوهای سرور پیکربندی‌ها را بااستفاده از Firebase Admin SDK برای Remote Config (دردسترس برای Node.js،‏ Java،‏ Python، و Go) به نمونه‌های سرور ارائه می‌دهند.

می‌توانید از کنسول Firebase برای اصلاح و مدیریت الگوی سرور استفاده کنید. به DevOps و تعامل > پیکربندی از راه دور بروید تا محتوای الگو را در قالب گرافیکی در صفحه پارامترها و صفحه شرایط مشاهده کنید.

در اینجا نمونه‌ای از فایل الگوی سرور آورده شده است:

{
  "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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

می‌توانید این تکالیف مدیریت نسخه را در کنسول Firebase انجام دهید (به DevOps و تعامل > پیکربندی از راه دور بروید):

درمجموع محدودیت ۳۰۰ نسخه ذخیره‌شده مادام‌العمر برای هر نوع الگو وجود دارد (۳۰۰ الگوی کارخواه و ۳۰۰ الگوی سرور)، که شامل شماره نسخه‌های ذخیره‌شده برای الگوهای حذف‌شده می‌شود. اگر در طول عمر پروژه بیش‌از ۳۰۰ نسخه الگو برای هر نوع الگو منتشر کنید، نسخه‌های اولیه حذف می‌شوند و حداکثر ۳۰۰ نسخه از آن نوع حفظ می‌شود.

هربار که پارامترها را به‌روز می‌کنید، Remote Config الگوی Remote Config نسخه‌دار جدیدی ایجاد می‌کند و الگوی قبلی را به‌عنوان نسخه‌ای ذخیره می‌کند که می‌توانید درصورت نیاز آن را بازیابی کنید یا به آن برگردید. شماره‌های نسخه به‌صورت متوالی از مقدار اولیه ذخیره‌شده توسط Remote Config افزایش می‌یابند. همه الگوها شامل یک فیلد version هستند که فراداده مربوط به آن نسخه خاص را دربرمی‌گیرد.

درصورت نیاز می‌توانید الگوهای Remote Config را در صفحه DevOps و تعامل > پیکربندی از راه دور > سابقه تغییر در کنسول Firebase حذف کنید.

مدیریت کردن نسخه‌های الگوی Remote Config

این بخش نحوه مدیریت نسخه‌های الگوی سرور Remote Config را شرح می‌دهد.

فهرست کردن همه نسخه‌های ذخیره‌شده الگوی Remote Config

می‌توانید فهرستی از همه نسخه‌های ذخیره‌شده الگوی Remote Config را بازیابی کنید. برای این کار:

  1. در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید.

  2. نماد «ساعت» را که در بالا سمت چپ نمایش داده می‌شود انتخاب کنید.

    با این کار، صفحه سابقه تغییرات باز می‌شود که همه نسخه‌های ذخیره‌شده الگو را در منو فهرستی در سمت چپ فهرست می‌کند.

    فهرست الگوها شامل فراداده برای همه نسخه‌های ذخیره‌شده است، ازجمله زمان به‌روزرسانی، کاربری که آن را انجام داده است، و نحوه انجام آن.

بازیابی نسخه خاصی از الگوی Remote Config

می‌توانید هر نسخه ذخیره‌شده خاصی از الگوی Remote Config را بازیابی کنید. در اینجا نحوه بازیابی نسخه الگوی ذخیره‌شده آمده است:

  1. در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > سابقه تغییر بروید.

  2. به‌طور پیش‌فرض، صفحه الگوی فعال فعلی را نمایش می‌دهد. برای مشاهده نسخه‌ای دیگر، آن را از بخش جزئیات در سمت چپ انتخاب کنید.

  3. با نگه داشتن نشانگر روی منوِ بافت برای هر نسخه انتخاب‌نشده و انتخاب مقایسه با نسخه انتخاب‌شده، تفاوت دقیق الگوی فعال و هر نسخه ذخیره‌شده دیگری را مشاهده کنید.

برگشتن به نسخه ذخیره‌شده خاصی از الگوی Remote Config

می‌توانید به هر نسخه ذخیره‌شده‌ای از الگو عقب‌گرد کنید. نحوه عقب‌گرد کردن الگو در اینجا آمده است:

  1. در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > سابقه تغییر بروید.

  2. دکمه گزینه را در بالا سمت چپ صفحه برای نسخه‌های قبلی الگو که واجدشرایط بازگشت هستند پیدا کنید.

  3. فقط درصورتی روی این گزینه کلیک و آن را تأیید کنید که مطمئن باشید می‌خواهید به آن نسخه برگردید و از آن مقادیر بلافاصله برای همه برنامه‌ها و کاربران استفاده کنید.

توجه داشته باشید که این عملیات بازگرداندن درواقع نسخه شماره‌دار جدیدی ایجاد می‌کند. برای مثال، بازگرداندن از نسخه ۱۰ به نسخه ۶ به‌طور مؤثری کپی جدیدی از نسخه ۶ ایجاد می‌کند که تنها تفاوت آن با نسخه اصلی این است که شماره نسخه آن ۱۱ است. نسخه اصلی ۶ هنوز ذخیره است، با فرض اینکه به تاریخ انقضایش نرسیده باشد، و نسخه ۱۱ به الگوی فعال تبدیل می‌شود.

حذف کردن الگوی Remote Config

می‌توانید الگوهای Remote Config را بااستفاده از کنسول Firebase حذف کنید. نحوه حذف کردن الگو:

  1. در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید.

  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، به صفحه DevOps & Engagement (توسعه و تعامل) > Remote Config (پیکربندی از راه دور) > Parameters or Conditions (پارامترها یا شرایط) بروید.

  2. منو را باز کنید و بارگیری فایل پیکربندی فعلی را انتخاب کنید.

  3. وقتی درخواست شد، روی بارگیری فایل پیکربندی کلیک کنید، مکانی را که می‌خواهید فایل در آن ذخیره شود انتخاب کنید، سپس روی ذخیره کلیک کنید.

اعتبارسنجی الگوی Remote Config

وقتی می‌خواهید از کنسول Firebase منتشر کنید، الگوهای سرور اعتبارسنجی می‌شوند. شرایطی که از قانون کاربر در درصد تصادفی استفاده می‌کنند می‌توانند وارد شوند، اما هر شرط پشتیبانی‌نشده‌ای درطول بارگذاری خطا ایجاد می‌کند. اگر می‌خواهید الگویی را منتشر کنید که دراصل از الگوی مشتری صادر شده است، حتماً ابتدا هرگونه شرایط خاص مشتری را بردارید.

انتشار الگو Remote Config

پس‌از بارگیری الگو، اعمال تغییرات لازم در محتوای JSON، و اعتبارسنجی آن، می‌توانید آن را در پروژه‌ای منتشر کنید.

با انتشار الگو، کل الگوی پیکربندی موجود با فایل به‌روزشده جایگزین می‌شود و نسخه الگو یک عدد افزایش می‌یابد. چون کل پیکربندی جایگزین می‌شود، اگر پارامتری را از فایل JSON حذف کنید و آن را منتشر کنید، پارامتر از سرور حذف می‌شود و دیگر برای مشتریان دردسترس نخواهد بود.

پس‌از انتشار، تغییرات پارامترها و مقادیر بلافاصله برای برنامه‌ها و کاربران شما دردسترس قرار می‌گیرند. درصورت لزوم، می‌توانید به نسخه قبلی برگردید.

برای انتشار الگوی خود، مراحل زیر را دنبال کنید:

  1. در کنسول Firebase، به صفحه DevOps & Engagement (توسعه و تعامل) > Remote Config (پیکربندی از راه دور) > Parameters or Conditions (پارامترها یا شرایط) بروید.

  2. منو را باز کنید و انتشار از فایل را انتخاب کنید.

  3. وقتی از شما خواسته شد، روی مرور کلیک کنید، به فایل Remote Config که می‌خواهید منتشر کنید بروید و آن را انتخاب کنید، سپس روی انتخاب کلیک کنید.

  4. فایل اعتبارسنجی شده است. اگر اعتبارسنجی موفقیت‌آمیز بود، روی انتشار کلیک کنید تا پیکربندی فوراً برای برنامه‌ها و کاربران دردسترس قرار گیرد.

مراحل بعدی