使用功能标志清单

本指南介绍了如何从 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. 运行 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 代码生成实用程序，以更新应用的类型安全的标志访问器。这可确保清单与管理平面中的密钥和类型相匹配。

后续步骤