Usar manifestos de flag de recurso

Este guia mostra como criar ou exportar flags de um manifesto de flag de recurso do App Lifecycle Manager.

Com as flags de recursos do App Lifecycle Manager, você controla a disponibilidade e o comportamento de recursos nos seus aplicativos sem precisar de novas implantações de código ou mudanças na infraestrutura. Com os manifestos de flags de recursos, é possível criar flags em grupos. Assim, você não precisa criar e sincronizar flags manualmente no plano de gerenciamento e no ambiente de desenvolvimento local. Os manifestos oferecem um utilitário de gerenciamento em massa que permite gerenciar flags usando arquivos JSON compatíveis com o esquema de manifesto de flag OpenFeature de código aberto.

Pré-requisitos

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

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

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 suas definições de flag. Esse arquivo serve como a fonte local da verdade para 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" \
    --unit-kind="UNIT_KIND_NAME"

Criar um manifesto com base em configurações de flags 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 suas flags ou prepará-las para uso com ferramentas de codegen do OpenFeature.

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

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

  2. Se você estiver usando acessadores de flags com segurança de tipo, execute o utilitário de geração de código da CLI do OpenFeature no novo manifest.json para atualizar os acessadores de flags com segurança de tipo do seu aplicativo. Isso garante que os manifestos correspondam às chaves e aos tipos no plano de gerenciamento.

A seguir