フィーチャー トグル マニフェストを使用する

このガイドでは、App Lifecycle Manager のフィーチャー トグル マニフェストからフィーチャー トグルを作成またはエクスポートする方法について説明します。

App Lifecycle Manager の機能フラグを使用すると、新しいコードのデプロイや インフラストラクチャの変更を必要とせずに、アプリケーション内の 機能の可用性と動作を制御できます。フィーチャー トグル マニフェストを使用すると、フラグをグループで作成できるため、管理プレーンとローカル開発環境でフィーチャー トグルを手動で作成して同期する必要はありません。マニフェストには、オープンソースのOpenFeature フラグ マニフェスト スキーマに準拠した JSON ファイルを使用してフラグを管理できる一括管理 ユーティリティが用意されています。

前提条件

始める前に、次のものを用意してください。

  1. App Lifecycle Manager リソースを管理するように構成された gcloud 環境。
  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. マニフェスト ファイルとターゲットの UnitKind を指定して、push コマンドを実行します。
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

既存のフラグ構成からマニフェストを作成する

pull コマンドは、App Lifecycle Manager API から既存のフラグ構成を取得し、ローカル JSON マニフェスト ファイルを生成します。これにより、フラグのローカル レコードを維持したり、OpenFeature codegen ツールで使用できるように準備したりできます。

  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 codegen ユーティリティを実行して、アプリケーションのタイプセーフ フラグ アクセサーを更新します。これにより、マニフェストが管理プレーンのキーとタイプに一致します。

次のステップ