שימוש במניפסטים של feature flag

במדריך הזה מוסבר איך ליצור או לייצא דגלים ממניפסט של דגלי תכונות ב-App Lifecycle Manager.

דגלי התכונות של App Lifecycle Manager מאפשרים לכם לשלוט בזמינות ובהתנהגות של תכונות באפליקציות שלכם בלי שתצטרכו לפרוס קוד חדש או לבצע שינויים בתשתית. מניפסטים של feature flag מאפשרים ליצור דגלים בקבוצות, כך שלא צריך ליצור ולסנכרן דגלים באופן ידני במישור הניהול ובסביבת הפיתוח המקומית. קובצי מניפסט מספקים כלי לניהול בכמות גדולה, שמאפשר לכם לנהל את ההגדרות באמצעות קובצי JSON שתואמים לסכימת המניפסט של OpenFeature בקוד פתוח.

דרישות מוקדמות

לפני שמתחילים, חשוב לוודא שיש לכם:

  1. סביבת gcloud שמוגדרת לניהול משאבים של App Lifecycle Manager.
  2. השלמתם את המדריך למתחילים בנושא פריסת דגלים של תכונות.

יצירת דגלים ממניפסט

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

  1. יוצרים קובץ בשם my_flags.json עם הגדרות הדגלים. הקובץ הזה משמש כמקור האמת המקומי למניפסט.

    דוגמה my_flags.json:

    {
  "flags": {
    "my-flag": {
      "defaultValue": "foo-bar",
      "description": "A description of the flag.",
      "flagType": "string"
    }
  }
}
    1. מריצים את הפקודה push ומציינים את קובץ המניפסט ואת UnitKind היעד.
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

יצירת קובץ מניפסט מהגדרות קיימות של דגלים

הפקודה pull מאחזרת הגדרות קיימות של דגלים מ-App Lifecycle Manager API ויוצרת קובץ מניפסט מקומי בפורמט JSON. כך תוכלו לשמור רשומה מקומית של הדגלים או להכין אותם לשימוש עם כלי יצירת קוד של OpenFeature.

  1. מריצים את הפקודה pull ומציינים את נתיב הפלט שבחרתם.

     gcloud beta app-lifecycle-manager flags pull \
     --output-file="manifest.json" \
     --unit-kind="UNIT_KIND_NAME" \
     --overwrite-output-file

  2. אם אתם משתמשים ב-type-safe flag accessors, מריצים את כלי OpenFeature CLI codegen מול manifest.json החדש כדי לעדכן את ה-type-safe flag accessors של האפליקציה. כך מוודאים שהמניפסטים תואמים למפתחות ולסוגים במישור הניהול.

המאמרים הבאים