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

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

אתם יכולים להשתמש במסוף Firebase כדי לשנות ולנהל את תבנית השרת. עוברים אל DevOps & Engagement (פיתוח אפליקציות ואינטראקציה עם משתמשים) > 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-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 (עוברים אל DevOps & Engagement > הגדרת תצורה מרחוק):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. במסוף Firebase, עוברים אל DevOps & מעורבות > הגדרת תצורה מרחוק > הדף היסטוריית שינויים.

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

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

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

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

1. במסוף Firebase, עוברים אל DevOps & מעורבות > הגדרת תצורה מרחוק > הדף היסטוריית שינויים.

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

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

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

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

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

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

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

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

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 (פיתוח אפליקציות ואינטראקציה עם משתמשים) > Remote Config (הגדרת תצורה מרחוק) > הדף Parameters or Conditions (פרמטרים או תנאים).

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

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

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

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

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

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

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

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

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

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

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

3. כשמופיעה בקשה לכך, לוחצים על Browse, עוברים אל קובץ Remote Config שרוצים לפרסם ובוחרים אותו, ואז לוחצים על Select.

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

השלבים הבאים

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