תבניות הגדרת תצורה מרחוק וניהול גרסאות

Remote Config תבניות הן קבוצות של פרמטרים ותנאים בפורמט JSON שיצרתם עבור פרויקט Firebase. אפשר ליצור תבניות לקוח, שהאפליקציה מאחזרת מהן ערכים, ותבניות שרת, ששרתי לקוחות יכולים לאחזר מהן ערכים.

אפשר לשנות את התבנית ולנהל אותה באמצעות מסוף Firebase, שבו מוצגים התוכן של התבנית בפורמט גרפי בכרטיסיות Parameters (פרמטרים) ו-Conditions (תנאים).

דוגמה לקובץ תבנית של שרת:

{
  "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 מהדף היסטוריית השינויים

יש מגבלה כוללת של 300 גרסאות מאוחסנות לכל סוג תבנית (300 תבניות לקוח ו-300 תבניות שרת), כולל מספרי גרסאות מאוחסנים של תבניות שנמחקו. אם מפרסמים יותר מ-300 גרסאות של תבנית לכל סוג תבנית במהלך חיי הפרויקט, הגרסאות המוקדמות ביותר נמחקות, כך שיישארו לכל היותר 300 גרסאות מהסוג הזה.

בכל פעם שמעדכנים פרמטרים, 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. מחפשים את לחצן האפשרויות בפינה השמאלית העליונה של הדף היסטוריית השינויים. צריך ללחוץ על האפשרות הזו ולאשר אותה רק אם בטוחים שרוצים לחזור לגרסה הזו ולהשתמש בערכים האלה באופן מיידי בכל האפליקציות והמשתמשים.

שימו לב: פעולת החזרה לגרסה קודמת יוצרת למעשה גרסה חדשה עם מספר. לדוגמה, אם מבצעים חזרה מגרסה 10 לגרסה 6, נוצרת למעשה עותק חדש של גרסה 6, ששונה מהגרסה המקורית רק במספר הגרסה שלה, שהוא 11. גרסה 6 המקורית עדיין מאוחסנת, בהנחה שהיא לא הגיעה לתאריך התפוגה שלה, וגרסה 11 הופכת לתבנית הפעילה.

מחיקה של תבנית Remote Config

אפשר למחוק תבניות של Remote Config ממסוף Firebase. כדי למחוק תבנית Remote Config:

1. עוברים לתבנית שרוצים למחוק, לוחצים על more_vertאפשרויות נוספות ובוחרים באפשרות מחיקה.

2. כשמופיעה בקשה לאישור המחיקה, לוחצים על מחיקה.

הורדה ופרסום של תבניות Remote Config

אפשר להוריד ולפרסם תבניות של Remote Config כדי לשלב אותן במערכות לניהול גרסאות ובמערכות build, להפוך עדכוני הגדרות לאוטומטיים ולשמור על סנכרון בין פרמטרים וערכים בכמה פרויקטים.

אפשר להוריד את תבנית Remote Configממסוף Firebase. אחר כך תוכלו לעדכן את קובץ ה-JSON שייצאתם ולפרסם אותו באותו פרויקט, או לפרסם אותו בפרויקט חדש או קיים.

נניח שיש לכם כמה פרויקטים שמייצגים שלבים שונים במחזור החיים של פיתוח התוכנה, כמו סביבות פיתוח, בדיקה, Staging וייצור. במקרה כזה, תוכלו להעביר תבנית שנבדקה באופן מלא מסביבת הבדיקה לסביבת הייצור. לשם כך, תצטרכו להוריד אותה מפרויקט הבדיקה ולפרסם אותה בפרויקט הייצור.

אפשר גם להשתמש בשיטה הזו כדי להעביר הגדרות מפרויקט אחד לפרויקט אחר, או כדי לאכלס פרויקט חדש בפרמטרים ובערכים מפרויקט קיים.

פרמטרים וערכי פרמטרים שנוצרו במיוחד כווריאציות בניסוי A/B Testing לא נכללים בתבניות שמיוצאות.

כדי לייצא ולייבא תבניות של Remote Config:

1. מורידים את תבנית ההגדרות הנוכחית של Remote Config.
2. מאמתים את התבנית Remote Config.
3. מפרסמים את התבנית של Remote Config.

הורדת התבנית הנוכחית של הגדרת התצורה מרחוק

כדי להוריד את תבנית Remote Config הפעילה בפורמט JSON:

1. בכרטיסייה Remote Config Parameters or Conditions (פרמטרים או תנאים), פותחים את more_vertהתפריט ובוחרים באפשרות Download current config file (הורדת קובץ ההגדרות הנוכחי).
2. כשמופיעה בקשה, לוחצים על Download config file, בוחרים את המיקום שבו רוצים לשמור את הקובץ ואז לוחצים על Save.

אימות תבנית ההגדרה מרחוק

תבניות שרת עוברות אימות כשמנסים לפרסם מהמסוף Firebase. שימו לב: אפשר לייבא תנאים של 'משתמש באחוז אקראי', אבל כל תנאי לא נתמך ייצור שגיאה במהלך ההעלאה. אם אתם מנסים לפרסם תבנית שיוצאה במקור מתבנית של לקוח, הקפידו להסיר קודם את כל התנאים שספציפיים ללקוח.

פרסום תבנית Remote Config

אחרי שמורידים תבנית, מבצעים את השינויים הנדרשים בתוכן ה-JSON ומאמתים אותו, אפשר לפרסם אותו בפרויקט.

כשמפרסמים תבנית, היא מחליפה את כל תבנית ההגדרות הקיימת בקובץ המעודכן, והגרסה של התבנית עולה באחת. מכיוון שההגדרה כולה מוחלפת, אם מוחקים פרמטר מקובץ ה-JSON ומפרסמים אותו, הפרמטר נמחק מהשרת ולא זמין יותר ללקוחות.

אחרי הפרסום, השינויים בפרמטרים ובערכים זמינים באופן מיידי באפליקציות שלכם ולמשתמשים. במידת הצורך, אפשר לחזור לגרסה קודמת.

כדי לפרסם את התבנית, משתמשים בפקודות הבאות:

1. בכרטיסייה Remote Config פרמטרים או תנאים, פותחים את more_vertהתפריט ובוחרים באפשרות פרסום מקובץ.
2. כשמופיעה בקשה לכך, לוחצים על עיון, עוברים אל קובץ Remote Config שרוצים לפרסם ובוחרים אותו, ואז לוחצים על בחירה.
3. המערכת תאמת את הקובץ, ואם האימות יצליח, תוכלו ללחוץ על פרסום כדי שההגדרה תהיה זמינה באופן מיידי לאפליקציות ולמשתמשים.

השלבים הבאים

• מידע נוסף על שימוש ב-Remote Config בסביבות שרת
• אפשר לנסות תיוג בצד השרת Remote Config עם Cloud Functions ו-Vertex AI.