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

בחירת סוג התבנית: תבניות בצד הלקוח תבניות בצד השרת


תבניות Remote Config הן קבוצות של פרמטרים ותנאים בפורמט JSON שנוצרו בשביל פרויקט Firebase שלכם. תבניות השרת מספקות הגדרות למכונות השרת באמצעות Firebase Admin SDK ל-Remote Config (זמין ל-Node.js, ל-Java, ל-Python ול-Go).

אפשר להשתמש במסוף Firebase כדי לשנות ולנהל את תבנית השרת. עוברים אל DevOps & Engagement (DevOps ומעורבות) > Remote Config (הגדרת תצורה מרחוק) כדי לראות את תוכן התבנית בפורמט גרפי בדף 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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

אתם יכולים לבצע את המשימות הבאות לניהול גרסאות במסוף Firebase (עוברים אל DevOps & Engagement > הגדרת תצורה מרחוק):

  • הצגת רשימה של כל גרסאות התבניות השמורות
  • אחזור של גרסה ספציפית
  • חזרה לגרסת שרת ספציפית
  • מוחקים Remote Config תבניות מדף היסטוריית השינויים.

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

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

אפשר למחוק תבניות של Remote Config לפי הצורך בדף DevOps & Engagement (פיתוח ותפעול ומעורבות) > Remote Config (הגדרת תצורה מרחוק) > Change history (היסטוריית שינויים) במסוף Firebase.

ניהול גרסאות של תבניות ב-Remote Config

בקטע הזה מוסבר איך לנהל גרסאות של תבנית השרת ב-Remote Config.

הצגת רשימה של כל הגרסאות השמורות של התבנית Remote Config

אתם יכולים לאחזר רשימה של כל הגרסאות השמורות של התבנית Remote Config. כך עושים את זה:

  1. במסוף Firebase, נכנסים לדף DevOps & Engagement ‏> הגדרת תצורה מרחוק ‏> Parameters.

  2. לוחצים על סמל השעון שמוצג בפינה השמאלית העליונה.

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

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

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

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

  1. במסוף Firebase, נכנסים לדף DevOps & Engagement >‏ Remote Config >‏ Change history.

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

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

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

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

  1. במסוף Firebase, נכנסים לדף DevOps & Engagement >‏ Remote Config >‏ Change history.

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

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

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

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

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

  1. במסוף Firebase, נכנסים לדף DevOps & Engagement ‏> הגדרת תצורה מרחוק ‏> Parameters.

  2. לוחצים על היסטוריית שינויים.

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

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

הורדה ופרסום של 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

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

  1. במסוף Firebase, נכנסים לדף DevOps & Engagement (DevOps ומעורבות) > Remote Config (הגדרת תצורה מרחוק) > Parameters or Conditions (פרמטרים או תנאים).

  2. פותחים את תפריט ובוחרים באפשרות הורדת קובץ התצורה הנוכחי.

  3. כשמופיעה בקשה, לוחצים על הורדת קובץ תצורה, בוחרים את המיקום שבו רוצים לשמור את הקובץ ולוחצים על שמירה.

אימות התבנית של Remote Config

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

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

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

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

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

כדי לפרסם את התבנית:

  1. במסוף Firebase, נכנסים לדף DevOps & Engagement (DevOps ומעורבות) > Remote Config (הגדרת תצורה מרחוק) > Parameters or Conditions (פרמטרים או תנאים).

  2. פותחים את התפריט ובוחרים באפשרות פרסום מקובץ.

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

  4. הקובץ מאומת. אם האימות מצליח, לוחצים על Publish כדי שההגדרות יהיו זמינות מיד לאפליקציות ולמשתמשים.

השלבים הבאים