Flags de destino com CEL

A Common Expression Language (CEL) fornece a lógica para avaliações sofisticadas de sinalizações com base em regras. Ele permite criar regras de segmentação precisas combinando vários atributos de usuário ou solicitação usando operadores lógicos.

Este guia mostra como definir flags com regras CEL e atualizar as especificações de avaliação.

Pré-requisitos

Antes de começar, verifique se você atende a estes requisitos:

  1. Concluiu o guia de início rápido sobre como implantar flags de recurso.
  2. Um ambiente do gcloud configurado para gerenciar recursos do App Lifecycle Manager.

Operadores lógicos e sintaxe

A CEL é compatível com operadores lógicos padrão para criar condições complexas:

  • && AND lógico
  • || OR lógico
  • ! NOT lógico
  • in: verifica se um valor existe em uma lista.

Definir atributos

Os atributos da CEL são pontos de dados específicos, como source_ip, cabeçalhos de solicitação ou caminhos, usados em expressões booleanas para definir políticas de segurança ou roteamento.

Qualquer atributo usado em uma condição CEL precisa ser explicitamente definido e listado na matriz de atributos do EvaluationSpec. Se um atributo for usado em uma condição, mas estiver ausente da lista, a API rejeitará a solicitação.

Criar um atributo

É possível usar o App Lifecycle Manager para criar atributos CEL.

Para criar um atributo de plano, execute o comando:

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

Para criar um atributo de país, execute o comando:

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

Para criar um atributo de plataforma, execute o comando:

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

Configurar uma flag com regras CEL

Ao criar ou atualizar uma flag, defina a lógica de avaliação no evaluation-spec.

Por exemplo, este snippet ativa um recurso para clientes premium na Alemanha que usam o app para dispositivos móveis.

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"
      ]
    }'

Substitua PROJECT_ID e UNIT_KIND_NAME pelos seus valores.

Application Integration

O aplicativo precisa injetar os atributos no contexto de avaliação no momento da execução.

Exemplo em 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)

Práticas recomendadas

  • Ordem de avaliação: as regras são avaliadas sequencialmente. A primeira regra que for avaliada como verdadeira determina o valor da flag.
  • Padrões seguros: se um contexto de usuário não tiver um atributo obrigatório para uma condição, o mecanismo de avaliação vai pular essa regra específica.
  • Limites de caracteres: as expressões CEL podem ter até 4.096 bytes (4 kB).

A seguir