Usa manifiestos de marcas de funciones

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

Los indicadores de funciones de App Lifecycle Manager te permiten controlar la disponibilidad y el comportamiento de las funciones dentro de tus aplicaciones sin necesidad de implementar código nuevo ni realizar 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 en tu plano de administración y entorno de desarrollo local de forma manual. Los manifiestos proporcionan una utilidad de administración masiva que te permite administrar tus marcas con archivos JSON que se ajustan al 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 los recursos de App Lifecycle Manager
  2. Haber completado la guía de inicio rápido para implementar marcas de funciones

Crea marcas a partir de un manifiesto

El comando push te permite crear varios parámetros de configuración a la vez proporcionando un archivo de manifiesto JSON local.

  1. Crea un archivo llamado my_flags.json con las definiciones de tus marcas. Este archivo funciona como la fuente de información local de tu manifiesto.

    Ejemplo my_flags.json:

    {
      "flags": {
        "my-flag": {
          "defaultValue": "foo-bar",
          "description": "A description of the flag.",
          "flagType": "string"
        }
      }
    }
    
    1. Ejecuta el comando push especificando tu archivo de manifiesto y el UnitKind de destino.
    gcloud beta app-lifecycle-manager flags push \
        --file="my_flags.json" \
        --location="global" \
        --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 generación de código de OpenFeature.

  1. Ejecuta el comando pull especificando la ruta de acceso de salida que elegiste.

     gcloud beta app-lifecycle-manager flags pull \
         --location="global" \
         --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 generación de código 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?