使用标志集

本指南介绍了如何对标志进行分组、通过标志集创建发布版本,以及如何配置标志以订阅标志集。

标志集是用于管理相关功能标志组的逻辑容器。 随着应用不断发展,各个标志的数量也会增加,在平面列表中管理这些标志可能会变得繁琐且容易出错。

通过标志集,您可以根据功能区域、应用组件或任何其他逻辑条件来整理标志,从而为标志操作提供更高级别的抽象。

前提条件

开始之前,请确保您满足以下方面的要求:

  1. 配置为管理 App Lifecycle Manager 资源的 gcloud 环境。
  2. 已完成部署功能标志快速入门。

对功能标志进行分组

如需对标志进行分组,您可以在创建标志时将其与 flag_set 标识符相关联,也可以更新现有标志。此标识符可创建明确的所有权边界,并让您将设置的标志用作单个资源。

在标志集中创建标志

gcloud beta app-lifecycle-manager flags create "auth-flag" \
    --key="auth-flag" \
    --flag-value-type=bool \
    --location=global \
    --unit-kind="UNIT_KIND_NAME" \
    --flag-set="auth-module-flags" \
    --description="Flag for the core authentication service."

更新现有标志,将其添加到标志集

gcloud beta app-lifecycle-manager flags update "auth-flag" \
    --location="global" \
    --flag-set="auth-module-flags"

基于标志集创建发布

您可以创建一个引用一个或多个集的 FlagRelease,而不是为每个标志手动创建时间点快照 (FlagRevisions)。App Lifecycle Manager 会自动处理所有必要的不可变快照的创建。

gcloud beta app-lifecycle-manager flags releases create "auth-release-v1.2" \
    --location=global \
    --flag-sets="auth-module-flags" \
    --unit-kind="UNIT_KIND_NAME"

将 UNIT_KIND_NAME 替换为您的单位类型。

为所有标志创建发布

您可以将 all_flags 布尔值设置为 true,以提取与发布单元类型关联的所有标志:

gcloud beta app-lifecycle-manager flags releases create "all-flags-release" \
    --location=global \
    --all-flags \
    --unit-kind="UNIT_KIND_NAME"

使用标志集

如需订阅标志集,请在初始化 OpenFeature 提供程序时使用选择器。

Go 示例:

选择器会指示标志来源过滤出此特定集合:

provider := flagd.NewProvider(
    // The selector tells the flag source to filter for this specific set
    flagd.WithSelector("flagSetId=auth-module-flags"),
    // ... other options
)

选择器行为:

  • 空选择器:仅选择没有标志集 ID 的标志。
  • flagSetId=*:选择与该单元关联的所有标记。
  • flagSetId=X:仅选择集合恰好为 X 的标志。

后续步骤