本指南介绍了如何对标志进行分组、通过标志集创建发布版本,以及如何配置标志以订阅标志集。
标志集是用于管理相关功能标志组的逻辑容器。 随着应用不断发展,各个标志的数量也会增加,在平面列表中管理这些标志可能会变得繁琐且容易出错。
通过标志集,您可以根据功能区域、应用组件或任何其他逻辑条件来整理标志,从而为标志操作提供更高级别的抽象。
前提条件
开始之前,请确保您满足以下方面的要求:
- 配置为管理 App Lifecycle Manager 资源的
gcloud环境。 - 已完成部署功能标志快速入门。
对功能标志进行分组
如需对标志进行分组,您可以在创建标志时将其与 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的标志。
后续步骤
- 了解使用 CEL 进行复杂定位。
- 了解多租户架构。