قالب های پیکربندی از راه دور و نسخه سازی


قالب‌های 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 انجام دهید:

  • فهرست کردن تمام نسخه‌های قالب ذخیره شده
  • بازیابی یک نسخه خاص
  • بازگشت به یک نسخه کلاینت خاص
  • قالب‌های Remote Config را از صفحه Change history حذف کنید

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

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

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

مدیریت نسخه‌های قالب Remote Config

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

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

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

  1. از کنسول Firebase ، Remote Config باز کنید.

  2. سپس، از تب پارامترها ، آیکون "ساعت" که در بالا سمت راست نمایش داده می‌شود را انتخاب کنید.

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

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

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

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

  1. پنجره جزئیات تغییر تاریخچه را باز کنید.

  2. برای مشاهده جزئیات نسخه دیگری در لیست، آن را از منوی سمت راست انتخاب کنید.

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

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

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

  1. دکمه‌ی option را در بالا سمت راست صفحه‌ی Change history پیدا کنید. فقط در صورتی که مطمئن هستید می‌خواهید به آن نسخه برگردید و فوراً از آن مقادیر برای همه برنامه‌ها و کاربران استفاده کنید، روی آن کلیک کرده و آن را تأیید کنید.

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

حذف یک الگوی Remote Config

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

۱. از صفحه پارامترهای Remote Config ، روی کلیک کنید. تغییر تاریخچه .

  1. برای انتخاب الگویی که می‌خواهید حذف کنید، روی More کلیک کنید، سپس Delete را انتخاب کنید.

  2. وقتی از شما خواسته شد حذف را تأیید کنید، روی «حذف» کلیک کنید.

قالب‌های Remote Config را دانلود و منتشر کنید

قالب‌های Remote Config را دانلود و منتشر کنید تا آنها را در سیستم‌های کنترل منبع و ساخت خود ادغام کنید، به‌روزرسانی‌های پیکربندی را خودکار کنید و پارامترها و مقادیر را در چندین پروژه همگام‌سازی کنید.

می‌توانید الگوی Remote Config که در حال حاضر فعال است را دانلود کنید.از کنسول Firebase .سپس می‌توانید فایل JSON خروجی گرفته شده را به‌روزرسانی کرده و آن را در همان پروژه منتشر کنید، یا آن را در یک پروژه جدید یا موجود منتشر کنید.

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

همچنین می‌توانید از این روش برای انتقال پیکربندی‌ها از یک پروژه به پروژه دیگر یا پر کردن یک پروژه جدید با پارامترها و مقادیر از یک پروژه از پیش تعیین‌شده استفاده کنید.

پارامترها و مقادیر پارامتری که به طور خاص به عنوان گونه‌های مختلف در یک آزمایش A/B Testing ایجاد شده‌اند، در قالب‌های صادر شده لحاظ نمی‌شوند.

برای خروجی گرفتن و وارد کردن قالب‌های Remote Config :

  1. الگوی فعلی Remote Config Config را دانلود کنید .
  2. الگوی Remote Config را اعتبارسنجی کنید .
  3. الگوی Remote Config را منتشر کنید .

الگوی پیکربندی از راه دور فعلی را دانلود کنید

برای دانلود الگوی فعال Remote Config با فرمت JSON از دستور زیر استفاده کنید:

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

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

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

الگوی Remote Config منتشر کنید

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

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

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

برای انتشار قالب خود از دستورات زیر استفاده کنید:

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

مراحل بعدی