使用 CEL 设置目标标志

通用表达式语言 (CEL) 为基于规则的复杂标志评估提供逻辑。您可以使用逻辑运算符组合多个用户或请求属性,从而创建精确的定位规则。

本指南介绍了如何使用 CEL 规则定义标志以及如何更新评估规范。

前提条件

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

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

逻辑运算符和语法

CEL 支持使用标准逻辑运算符来构建复杂条件:

  • && 逻辑与
  • || 逻辑或
  • ! 逻辑非
  • in 检查列表中是否存在某个值

定义属性

CEL 属性是布尔表达式中使用的特定数据点(例如 source_ip、请求标头或路径),用于定义安全或路由政策。

CEL 条件中使用的任何特性都必须在 EvaluationSpec 的特性数组中明确定义和列出。如果某个属性在条件中使用,但未出现在列表中,则 API 将拒绝该请求。

创建属性

您可以使用 App Lifecycle Manager 创建 CEL 属性。

如需创建方案属性,请运行以下命令:

gcloud beta app-lifecycle-manager flags attributes create "plan-attr" \
    --key="plan" \
    --attribute-value-type="STRING" \
    --location=global

如需创建国家/地区属性,请运行以下命令:

gcloud beta app-lifecycle-manager flags attributes create "country-attr" \
    --key="country" \
    --attribute-value-type="STRING" \
    --location=global

如需创建平台属性,请运行以下命令:

gcloud beta app-lifecycle-manager flags attributes create "platform-attr" \
    --key="platform" \
    --attribute-value-type="STRING" \
    --location=global

使用 CEL 规则配置标志

创建或更新标志时,请在 evaluation-spec 中定义评估逻辑。

例如,此代码段为德国境内使用移动应用的付费客户启用了一项功能。

gcloud beta app-lifecycle-manager flags create "advanced-reporting-flag" \
    --key="advanced-reporting-flag" \
    --flag-value-type=bool \
    --unit-kind="UNIT_KIND_NAME" \
    --location=global \
    --variants='[
      {"id": "enabled", "booleanValue": true},
      {"id": "disabled", "booleanValue": false}
    ]' \
    --evaluation-spec='{
      "rules": [{
        "id": "premium_mobile_users_in_germany",
        "condition": "plan == \"premium\" && country == \"DE\" && platform == \"mobile\"",
        "variantId": "enabled"
      }],
      "defaultVariant": "disabled",
      "attributes": [
        "projects/PROJECT_ID/locations/global/flagAttributes/plan-attr",
        "projects/PROJECT_ID/locations/global/flagAttributes/country-attr",
        "projects/PROJECT_ID/locations/global/flagAttributes/platform-attr"
      ]
    }'

将 PROJECT_ID 和 UNIT_KIND_NAME 替换为您的值。

应用集成

您的应用必须在运行时将这些属性注入到评估上下文中。

Python 示例:

from openfeature.evaluation_context import EvaluationContext

eval_ctx = EvaluationContext(
    targeting_key=user_id,
    attributes={
        "plan": "premium",
        "country": "DE",
        "platform": "mobile"
    }
)

is_enabled = client.get_boolean_value("advanced-reporting-flag", False, eval_ctx)

最佳做法

  • 评估顺序:系统会按顺序评估规则。第一个评估结果为 true 的规则决定了标志的值。
  • 安全默认值:如果用户上下文缺少条件所需的属性,评估引擎将跳过该特定规则。
  • 字符数限制:CEL 表达式的大小上限为 4,096 字节 (4kB)。

后续步骤