Usar manifestos de flag de recurso

Neste guia, mostramos como criar ou exportar flags de um manifesto de flag de recurso do App Lifecycle Manager.

As flags de recurso do App Lifecycle Manager permitem controlar a disponibilidade e o comportamento dos recursos nos seus aplicativos sem exigir novas implantações de código ou mudanças na infraestrutura. Os manifestos de flag de recurso permitem criar flags em grupos, para que você não precise criar e sincronizar flags manualmente no plano de gerenciamento e no ambiente de desenvolvimento local. Os manifestos fornecem um utilitário de gerenciamento em massa que permite gerenciar suas flags usando arquivos JSON que estão em conformidade com o esquema de manifesto de flag de código aberto do OpenFeature.

Pré-requisitos

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

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

Criar flags com base em um manifesto

O comando push permite criar várias flags de uma só vez fornecendo um arquivo de manifesto JSON local.

  1. Crie um arquivo chamado my_flags.json com as definições de flag. Esse arquivo serve como a fonte de verdade local do seu manifesto.

    my_flags.json de exemplo:

    {
      "flags": {
        "my-flag": {
          "defaultValue": "foo-bar",
          "description": "A description of the flag.",
          "flagType": "string"
        }
      }
    }
    
    1. Execute o comando push especificando o arquivo de manifesto e o UnitKind de destino.
    gcloud beta app-lifecycle-manager flags push \
        --file="my_flags.json" \
        --location="global" \
        --unit-kind="UNIT_KIND_NAME"
    

Criar um manifesto com base nas configurações de flag atuais

O comando pull busca as configurações de flag atuais da API App Lifecycle Manager e gera um arquivo de manifesto JSON local. Isso permite manter um registro local das flags ou prepará-las para uso com as ferramentas de geração de código do OpenFeature.

  1. Execute o comando pull especificando o caminho de saída escolhido.

     gcloud beta app-lifecycle-manager flags pull \
         --location="global" \
         --output-file="manifest.json" \
         --unit-kind="UNIT_KIND_NAME" \
         --overwrite-output-file
    
  2. Se você estiver usando acessadores de flag com segurança de tipos, execute o utilitário de geração de código da CLI do OpenFeature no novo manifest.json para atualizar os acessadores de flag com segurança de tipos do aplicativo. Isso garante que os manifestos correspondam às chaves e aos tipos no plano de gerenciamento.

A seguir