Utilizzare i manifest dei flag funzionalità

Questa guida mostra come creare o esportare flag da un manifest dei flag funzionalità di App Lifecycle Manager.

I flag funzionalità di App Lifecycle Manager consentono di controllare la disponibilità e il comportamento delle funzionalità all'interno delle applicazioni senza richiedere nuove implementazioni di codice o modifiche dell'infrastruttura. I manifest dei flag funzionalità consentono di creare flag in gruppi, in modo da non dover creare e sincronizzare manualmente i flag nel piano di gestione e nell'ambiente di sviluppo locale. I manifest forniscono un'utilità di gestione collettiva che consente di gestire i flag utilizzando file JSON conformi allo schema del manifest dei flag OpenFeature open source.

Prerequisiti

Prima di iniziare, assicurati di avere:

  1. Un ambiente gcloud configurato per gestire le risorse di App Lifecycle Manager.
  2. Completato la guida rapida Deploy feature flags.

Crea flag da un manifest

Il comando push consente di creare più flag contemporaneamente fornendo un file manifest JSON locale.

  1. Crea un file denominato my_flags.json con le definizioni dei flag. Questo file funge da fonte di verità locale per il manifest.

    Esempio di my_flags.json:

    {
  "flags": {
    "my-flag": {
      "defaultValue": "foo-bar",
      "description": "A description of the flag.",
      "flagType": "string"
    }
  }
}
    1. Esegui il comando push specificando il file manifest e il UnitKind di destinazione.
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

Crea un manifest dalle configurazioni dei flag esistenti

Il comando pull recupera le configurazioni dei flag esistenti dall'API App Lifecycle Manager e genera un file manifest JSON locale. In questo modo puoi mantenere un record locale dei flag o prepararli per l'utilizzo con gli strumenti di generazione del codice OpenFeature.

  1. Esegui il comando pull specificando il percorso di output scelto.

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

  2. Se utilizzi gli accessor dei flag con sicurezza dei tipi, esegui l'utilità di generazione del codice della CLI OpenFeature sul nuovo manifest.json per aggiornare gli accessor dei flag con sicurezza dei tipi dell'applicazione. In questo modo, i manifest corrispondono alle chiavi e ai tipi nel piano di gestione.

Passaggi successivi