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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

השלבים הבאים

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