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


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

הקטע הזה עוסק בתבניות שרתים. למידע על תבניות ספציפיות ללקוח לוחצים על Client templates (תבניות לקוח).

אפשר לשנות ולנהל את התבנית באמצעות המסוף של 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

לכל סוג תבנית יש מגבלה כוללת של 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. לאחר מכן, בכרטיסייה Parameters בוחרים בסמל השעון שמופיע בפינה השמאלית העליונה.

    ייפתח הדף היסטוריית שינויים, שבו מפורטות כל הגרסאות השמורות של התבנית בתפריט רשימה בצד שמאל.

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

אחזור של גרסה ספציפית של התבנית Remote Config

אפשר לאחזר כל גרסה ספציפית שנשמרה של התבנית Remote Config. כדי לאחזר גרסת תבנית שמורה:

  1. פותחים את חלונית הפרטים של היסטוריית השינויים.

  2. כדי להציג פרטים לגבי גרסה אחרת ברשימה, בוחרים בה בתפריט הימני.

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

חזרה לגרסה ספציפית שנשמרה של התבנית Remote Config

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

  1. מאתרים את לחצן האפשרויות בפינה השמאלית העליונה של הדף Change history. צריך ללחוץ ולאשר רק אם רוצים לחזור לגרסה הזו ולהשתמש בערכים האלה באופן מיידי לכל האפליקציות והמשתמשים.

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

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

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

1. בדף Remote Config Parameters, לוחצים על Change history.

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

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

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

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

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

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

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

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

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

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

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

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

  1. בכרטיסייה פרמטרים או תנאים, פותחים את תפריט ובוחרים באפשרות הורדת קובץ התצורה הנוכחי.Remote Config
  2. כשמופיעה בקשה, לוחצים על Download config file, בוחרים את המיקום שבו רוצים לשמור את הקובץ ולוחצים על Save.

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

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

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

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

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

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

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

  1. בכרטיסייה Remote Config Parameters or Conditions, פותחים את Menu ובוחרים באפשרות Publish from a file.
  2. כשמופיעה בקשה לכך, לוחצים על Browse, עוברים לקובץ Remote Config שרוצים לפרסם ובוחרים אותו. לאחר מכן לוחצים על Select.
  3. הקובץ יאומת, ואם התהליך יסתיים בהצלחה, תוכלו ללחוץ על פרסום כדי שההגדרות יהיו זמינות באופן מיידי לאפליקציות ולמשתמשים שלכם.

השלבים הבאים