Usa manifiestos de marcas de funciones

En esta guía, se muestra cómo crear o exportar marcas desde un manifiesto de marcas de funciones de App Lifecycle Manager.

Las marcas de funciones de App Lifecycle Manager te permiten controlar la disponibilidad y el comportamiento de las funciones dentro de tus aplicaciones sin requerir implementaciones de código nuevas ni cambios en la infraestructura. Los manifiestos de marcas de funciones te permiten crear marcas en grupos, por lo que no tienes que crear y sincronizar marcas de forma manual en tu plano de administración y entorno de desarrollo local. Los manifiestos proporcionan una utilidad de administración masiva que te permite administrar tus marcas con archivos JSON que cumplen con el esquema de manifiesto de marcas de OpenFeature de código abierto.

Requisitos previos

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

  1. Un entorno de gcloud configurado para administrar recursos de App Lifecycle Manager
  2. Completaste la guía de inicio rápido Implementa marcas de funciones

Crea marcas a partir de un manifiesto

El comando push te permite crear varias marcas a la vez si proporcionas un archivo de manifiesto JSON local.

  1. Crea un archivo llamado my_flags.json con tus definiciones de marcas. Este archivo actúa como la fuente de información local para tu manifiesto.

    Ejemplo de my_flags.json:

    {
  "flags": {
    "my-flag": {
      "defaultValue": "foo-bar",
      "description": "A description of the flag.",
      "flagType": "string"
    }
  }
}
    1. Ejecuta el comando push y especifica tu archivo de manifiesto y el UnitKind objetivo.
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

Crea un manifiesto a partir de configuraciones de marcas existentes

El comando pull recupera las configuraciones de marcas existentes de la API de App Lifecycle Manager y genera un archivo de manifiesto JSON local. Esto te permite mantener un registro local de tus marcas o prepararlas para usarlas con las herramientas de codegen de OpenFeature.

  1. Ejecuta el comando pull y especifica la ruta de acceso de salida elegida.

     gcloud beta app-lifecycle-manager flags pull \
     --output-file="manifest.json" \
     --unit-kind="UNIT_KIND_NAME" \
     --overwrite-output-file

  2. Si usas descriptores de acceso de marcas con seguridad de tipos, ejecuta la utilidad de codegen de la CLI de OpenFeature en el nuevo manifest.json para actualizar los descriptores de acceso de marcas con seguridad de tipos de tu aplicación. Esto garantiza que los manifiestos coincidan con las claves y los tipos en el plano de administración.

¿Qué sigue?