Usa marcas de funciones para la arquitectura multiusuario

En esta guía, se explica cómo implementar las marcas de funciones de App Lifecycle Manager en un entorno de múltiples usuarios sin modificar el proceso de implementación de objetos binarios existente.

Requisitos previos

Antes de comenzar, asegúrate de contar con los siguientes aspectos:

  1. Haber completado la guía de inicio rápido para implementar marcas de funciones
  2. Un entorno de gcloud configurado para administrar los recursos de App Lifecycle Manager
  3. Una oferta de SaaS existente. Para obtener más información sobre cómo crear una oferta de SaaS, consulta Crea una oferta de SaaS.

Modelado de recursos

En una configuración de varios usuarios, te recomendamos que definas un tipo de unidad para tu servicio o aplicación, y una unidad para cada instancia del servicio o aplicación (que representa un usuario o una implementación).

Para implementar marcas de función en un entorno de múltiples usuarios, define los atributos de Common Expression Language (CEL) que identifican a tus usuarios, configura tu aplicación para que inserte identificadores de usuario en el entorno de ejecución y usa reglas de evaluación para afectar las funciones de usuarios específicos.

En casos más sencillos, también puedes crear de forma manual lanzamientos independientes para cada cliente.

1. Crea una oferta de SaaS (si aún no lo hiciste)

gcloud beta app-lifecycle-manager saas create "SAAS_NAME" \
    --project="PROJECT_ID" \
    --location="global" \
    --locations=name="LOCATION_1"

2. Crea un UnitKind

gcloud beta app-lifecycle-manager unit-kinds create "tenant-service-kind" \
    --project="PROJECT_ID" \
    --location="global" \
    --saas="SAAS_NAME"

3. Crea unidades para los inquilinos

Cuando crees unidades, usa etiquetas para categorizar los servicios de los usuarios en grupos (p.ej., group=beta, group=preview, group=all).

# Create a unit for Tenant A (Beta group)
gcloud beta app-lifecycle-manager units create "tenant-a-service" \
    --unit-kind="tenant-service-kind" \
    --location="LOCATION_1" \
    --labels="group=beta"

# Create a unit for Tenant B (Standard group)
gcloud beta app-lifecycle-manager units create "tenant-b-service" \
    --unit-kind="tenant-service-kind" \
    --location="LOCATION_1" \
    --labels="group=all"

Define atributos y marcas

Debes definir formalmente los atributos (como customerID) para garantizar la seguridad de tipos en las reglas de evaluación.

1. Crea el atributo customerID

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

2. Crea la marca de función

gcloud beta app-lifecycle-manager flags create "enhanced-search" \
    --key="enhanced-search" \
    --flag-value-type=bool \
    --location="global" \
    --unit-kind="tenant-service-kind"

Integración de aplicaciones

Integra el SDK de OpenFeature en tu servicio. Tu aplicación debe insertar el customerID en el contexto durante el tiempo de ejecución.

Ejemplo de Go:

// Inject customerID into the evaluation context
evalCtx := openfeature.NewEvaluationContext(
    currentTenant.ID,
    map[string]any{
        "customerID": currentTenant.ID,
    },
)

// Evaluate the flag
isEnabled, err := client.BooleanValue(
    context.Background(),
    "enhanced-search",
    false,
    evalCtx,
)

Configura la segmentación específica de la instancia

Usa reglas de evaluación para habilitar una función para clientes específicos.

gcloud beta app-lifecycle-manager flags update "enhanced-search" \
    --location="global" \
    --evaluation-spec='{
      "rules": [{
        "id": "allowlist-for-premium-tenants",
        "condition": "customerID in [\"tenant-xyz-123\", \"tenant-abc-789\"]",
        "variantId": "Enabled"
      }],
      "defaultVariant": "Disabled",
      "attributes": ["projects/PROJECT_ID/locations/global/flagAttributes/customer-id-attr"]
    }'

Lanzamiento gradual manual con filtros

En casos de uso más sencillos, puedes emular las olas activando lanzamientos independientes de forma manual para cada etiqueta de cliente.

1. Crea una revisión y una versión

# Create a Revision (Snapshot)
gcloud beta app-lifecycle-manager flags revisions create "enhanced-search-rev-1" \
    --location=global \
    --flag="enhanced-search"

# Create a Release
gcloud beta app-lifecycle-manager flags releases create "release-of-enhanced-search" \
    --location=global \
    --unit-kind="tenant-service-kind" \
    --revisions="enhanced-search-rev-1"

2. Activa lanzamientos manuales

Puedes organizar el lanzamiento de forma manual activando operaciones independientes por grupo de destino con --unit-filter.

# Create a RolloutKind
gcloud beta app-lifecycle-manager rollout-kinds create "rollout-kind-of-enhanced-search" \
    --unit-kind="tenant-service-kind" \
    --rollout-orchestration-strategy="Google.Cloud.Simple.AllAtOnce" \
    --location=global

# Deploy to Beta group first
gcloud beta app-lifecycle-manager rollouts create "beta-rollout" \
    --flag-release="release-of-enhanced-search" \
    --rollout-kind="rollout-kind-of-enhanced-search" \
    --location=global \
    --unit-filter="unit.labels['group'] == 'beta'"

# After verification, deploy to the rest of the fleet
gcloud beta app-lifecycle-manager rollouts create "full-rollout" \
    --flag-release="release-of-enhanced-search" \
    --rollout-kind="rollout-kind-of-enhanced-search" \
    --location=global \
    --unit-filter="unit.labels['group'] == 'all'"

¿Qué sigue?