Neste guia, mostramos como agrupar flags, criar versões com base em conjuntos e configurar flags para se inscrever em conjuntos de flags.
Os conjuntos de flags são contêineres lógicos para gerenciar grupos de flags de recursos relacionados. À medida que seus aplicativos crescem e o número de flags individuais aumenta, gerenciá-las em uma lista simples pode se tornar complicado e propenso a erros.
Os conjuntos de flags permitem organizar as flags com base na área funcional, no componente do aplicativo ou em qualquer outro critério lógico, fornecendo uma abstração de nível mais alto para operações de flag.
Pré-requisitos
Antes de começar, verifique se você atende a estes requisitos:
- Um ambiente do
gcloudconfigurado para gerenciar recursos do App Lifecycle Manager. - Concluiu o guia de início rápido sobre como implantar flags de recurso.
Agrupar flags de recursos
Para agrupar flags, associe-as a um identificador flag_set durante a criação ou atualize uma flag atual. Esse identificador cria um limite claro de
propriedade e permite que você use as sinalizações definidas como um único recurso.
Criar uma flag em um conjunto de flags
gcloud beta app-lifecycle-manager flags create "auth-flag" \
--key="auth-flag" \
--flag-value-type=bool \
--location=global \
--unit-kind="UNIT_KIND_NAME" \
--flag-set="auth-module-flags" \
--description="Flag for the core authentication service."
Atualizar uma flag para adicionar a um conjunto de flags
gcloud beta app-lifecycle-manager flags update "auth-flag" \
--location="global" \
--flag-set="auth-module-flags"
Criar uma versão com base em um conjunto de flags
Em vez de criar manualmente snapshots pontuais (FlagRevisions) para cada
flag, é possível criar um FlagRelease que faça referência a um ou mais conjuntos.
O App Lifecycle Manager processa automaticamente a criação de todos os snapshots imutáveis necessários.
gcloud beta app-lifecycle-manager flags releases create "auth-release-v1.2" \
--location=global \
--flag-sets="auth-module-flags" \
--unit-kind="UNIT_KIND_NAME"
Substitua UNIT_KIND_NAME pelo tipo de unidade.
Criar uma versão para todas as flags
Defina o booleano all_flags como true para buscar todas as flags vinculadas ao
tipo de unidade do lançamento:
gcloud beta app-lifecycle-manager flags releases create "all-flags-release" \
--location=global \
--all-flags \
--unit-kind="UNIT_KIND_NAME"
Como usar um conjunto de flags
Para se inscrever em um conjunto de flags, use um seletor ao inicializar o provedor do OpenFeature.
Exemplo em Go:
O seletor informa à origem da flag para filtrar esse conjunto específico:
provider := flagd.NewProvider(
// The selector tells the flag source to filter for this specific set
flagd.WithSelector("flagSetId=auth-module-flags"),
// ... other options
)
Comportamento do seletor:
- Seletor vazio: seleciona apenas as flags que não têm um ID de conjunto de flags.
flagSetId=*: seleciona todas as flags associadas à unidade.flagSetId=X: seleciona apenas as sinalizações em que o conjunto é exatamenteX.
A seguir
- Aprenda mais sobre a segmentação complexa com CEL.
- Saiba mais sobre a arquitetura multilocatária.