使用功能旗標資訊清單

本指南說明如何從 App Lifecycle Manager 功能旗標資訊清單建立或匯出旗標。

應用程式生命週期管理工具的功能旗標可讓您控管應用程式內的功能可用性和行為，不必部署新程式碼或變更基礎架構。功能旗標資訊清單可讓您在群組中建立旗標，因此不必手動在管理平面和本機開發環境中建立及同步處理旗標。資訊清單提供大量管理公用程式，可讓您使用符合開放原始碼 OpenFeature 旗標資訊清單結構定義的 JSON 檔案管理旗標。

必要條件

開始前，請先確認下列事項：

  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. 如果您使用類型安全旗標存取子，請對新的 manifest.json 執行 OpenFeature CLI 程式碼產生公用程式，更新應用程式的類型安全旗標存取子。這可確保資訊清單與管理層中的鍵和型別相符。

後續步驟