O Azure App Configuration proporciona gestão de funcionalidades através de feature flags, permitindo que as equipas controlem dinamicamente a funcionalidade da aplicação sem terem de redistribuir código. Isto permite lançamentos seguros e direcionados, experimentação mais rápida e redução de riscos, dando aos programadores controlo flexível sobre o comportamento da aplicação e a capacidade de responder rapidamente às necessidades em mudança do negócio ou dos clientes.
O gestor de funcionalidades no portal Azure fornece uma interface para criar e gerir as feature flags que utiliza nas suas aplicações.
Pré-requisitos
Criar um marcador de funcionalidade
Crie uma nova feature flag no portal Azure seguindo os passos abaixo.
Abra a sua loja de configuração de aplicações Azure no portal Azure. No menu de recursos, em Operações, selecione Gestor>de Funcionalidades Criar.
Em Para que vais usar a tua feature flag?, escolhe um dos seguintes propósitos:
-
Interruptor – Ativa/desliga as funcionalidades com um interruptor simples. Utilize para alternâncias operacionais de curta duração e cenários onde um único controle ligar/desligar é suficiente.
-
Implementação – Ative gradualmente a funcionalidade para uma percentagem dos utilizadores. Use para lançamentos graduais de funcionalidades para reduzir o risco e para lançamentos canários ou faseados em ambientes ou segmentos de utilizador.
-
Experiência – Realizar experiências controladas com a alocação de tráfego para determinar a variante com melhor desempenho. Use para testes A/B, experiências multivariadas ou avaliação de características orientada por métricas, e outros cenários que requerem comparação estatística.
Use Switch para ativar ou desativar a funcionalidade instantaneamente para todos os utilizadores.
Configure o Basics para definir as propriedades principais do seu flag de funcionalidade.
| Configuração |
Valor de exemplo |
Descrição |
|
Ativar sinalizador de recurso |
Ativar |
Esta opção ativa o sinalizador de recurso após a criação. Se desativares isto, a configuração da nova feature flag fica guardada, mas a nova feature flag permanece desativada. |
|
Nome do sinalizador de recurso |
Beta |
O nome do indicador de funcionalidade é o que usais para fazer referência ao indicador no vosso código. Ele deve ser exclusivo dentro de um aplicativo. |
|
Chave |
Beta |
Você pode usar a chave para filtrar sinalizadores de recursos que são carregados em seu aplicativo. A chave é gerada por defeito a partir do nome da feature flag, mas também pode adicionar um prefixo ou um namespace para agrupar as suas feature flags, por exemplo, .appconfig.featureflag/Beta. |
|
Etiqueta |
Deixar em branco |
Você pode usar rótulos para criar flags de funcionalidades diferentes para a mesma chave e filtrar as flags carregadas na sua aplicação com base no rótulo. Por padrão, um sinalizador de recurso não tem rótulo. |
|
Descrição |
Deixar em branco |
Deixe em branco ou insira uma descrição para o sinalizador de recursos. |
Configure a Telemetria para recolher eventos de avaliação para este sinalizador de funcionalidade. Quando ativados, os eventos de avaliação são enviados para o editor de telemetria que configura na sua aplicação. Antes de ativar a telemetria, ligue um recurso Application Insights à App Configuration Store no Telemetry>App Insights.
Selecione Revisar + Criar para ver um resumo do seu novo sinalizador de funcionalidades e depois selecione Criar para finalizar a sua operação. Uma notificação indica que o novo sinalizador de recurso foi criado com êxito.
Use o Rollout para expor progressivamente uma funcionalidade a uma percentagem de utilizadores.
Configure o Basics para definir as propriedades principais do seu flag de funcionalidade.
| Configuração |
Valor de exemplo |
Descrição |
|
Ativar sinalizador de recurso |
Ativar |
Esta opção ativa o sinalizador de recurso após a criação. Se desativares isto, a configuração da nova feature flag fica guardada, mas a nova feature flag permanece desativada. |
|
Nome do sinalizador de recurso |
Beta |
O nome do indicador de funcionalidade é o que usais para fazer referência ao indicador no vosso código. Ele deve ser exclusivo dentro de um aplicativo. |
|
Chave |
Beta |
Você pode usar a chave para filtrar sinalizadores de recursos que são carregados em seu aplicativo. A chave é gerada a partir do nome do sinalizador de recurso por padrão, mas você também pode adicionar um prefixo ou um namespace para agrupar seus sinalizadores de recurso, por exemplo, .appconfig.featureflag/myapp/Beta. |
|
Etiqueta |
Deixar em branco |
Você pode usar rótulos para criar flags de funcionalidades diferentes para a mesma chave e filtrar as flags carregadas na sua aplicação com base no rótulo. Por padrão, um sinalizador de recurso não tem rótulo. |
|
Descrição |
Deixar em branco |
Deixe em branco ou insira uma descrição para o sinalizador de recursos. |
Na aba Audiência, ative um sinalizador de funcionalidade para uma percentagem especificada ou inclua ou exclua explicitamente grupos e utilizadores.
| Configuração |
Valor de exemplo |
Descrição |
|
Percentagem de Incumprimento |
0–100 |
Introduza um valor entre 0 e 100 para especificar a percentagem de utilizadores que recebem a funcionalidade por defeito. |
|
Sobreposição por Grupos |
Desligado (não assinalado) |
Selecione para ativar substituições baseadas em grupo. Quando ativado, pode: - Adicione grupos para incluir explicitamente no lançamento e defina a percentagem de membros do grupo que devem receber a funcionalidade.
- Adicione grupos para excluir da implementação.
|
|
Sobrescrição por Utilizadores |
Desligado (não assinalado) |
Selecione para ativar a segmentação baseada no utilizador. Quando ativado, pode especificar utilizadores individuais para incluir ou excluir. |
Na aba de Configuração, defina os valores para o seu flag de feature. A sua aplicação pode obter a configuração apropriada avaliando qual o valor que se aplica a cada utilizador.
| Configuração |
Valor de exemplo |
Descrição |
|
Incluir configuração |
A caixa está marcada |
Selecione para anexar definições de chave-valor ao sinalizador de funcionalidade. Estas definições permitem que a sua aplicação ajuste o comportamento de forma dinâmica sem ter de redistribuir código. |
|
Configuração antiga |
{"color":"blue"} |
Mostra os valores de configuração anteriormente associados à feature flag antes desta atualização. Usa isto para comparar alterações e versões das faixas. |
|
Nova Configuração |
{"color":"green"} |
Mostra os valores de configuração atualizados que estás a aplicar agora. Estes valores vão sobrepor a configuração antiga e definir o novo comportamento quando a feature flag estiver ativada. |
Configure Condições para agendar alterações e gerir restrições personalizadas para servir as suas funcionalidades.
| Configuração |
Valor de exemplo |
Descrição |
|
Adicionar calendário |
Início: 2025-11-01
Fim: 2025-11-15
Fuso horário: (UTC-06:00) Hora Central (EUA e Canadá)
Recidiva: desativado |
Defina um lançamento baseado no tempo especificando datas de início e fim. Opcionalmente, atualize o fuso horário sugerido e ative a recorrência para ativações repetidas. |
|
Adicionar condição personalizada |
User.Subscription == "Premium" |
Criar condições baseadas em atributos personalizados (por exemplo, região, tipo de dispositivo ou nível de subscrição). As condições permitem-lhe definir exatamente quais os utilizadores que recebem a funcionalidade. |
|
Exigir que todos os filtros de funcionalidades estejam ativados |
Ligado (confirmado) |
Esta opção só aparece depois de ativares tanto Adicionar condição personalizada como Adicionar calendário. Quando todos os filtros de funcionalidades ativados são verificados, devem ser avaliados como verdadeiros para que a funcionalidade seja aplicada (E lógico). Quando não estão verificados, os filtros são avaliados independentemente (OR lógico). |
Configure a Telemetria para recolher eventos de avaliação para este sinalizador de funcionalidade. Quando ativados, os eventos de avaliação são enviados para o editor de telemetria que configura na sua aplicação. Antes de ativar a telemetria, ligue um recurso Application Insights à App Configuration Store no Telemetry>App Insights.
Selecione Revisar + Criar para ver um resumo do seu novo sinalizador de funcionalidades e depois selecione Criar para finalizar a sua operação. Uma notificação indica que o novo sinalizador de recurso foi criado com êxito.
Use o Experiment para fazer testes A/B e comparar variantes.
Configure o Basics para definir as propriedades principais do seu flag de funcionalidade.
| Configuração |
Valor de exemplo |
Descrição |
|
Ativar sinalizador de recurso |
Ativar |
Esta opção ativa o sinalizador de recurso após a criação. Se desativares isto, a configuração da nova feature flag fica guardada, mas a nova feature flag permanece desativada. |
|
Nome do sinalizador de recurso |
Beta |
O nome do indicador de funcionalidade é o que usais para fazer referência ao indicador no vosso código. Ele deve ser exclusivo dentro de um aplicativo. |
|
Chave |
Beta |
Você pode usar a chave para filtrar sinalizadores de recursos que são carregados em seu aplicativo. A chave é gerada a partir do nome do sinalizador de recurso por padrão, mas você também pode adicionar um prefixo ou um namespace para agrupar seus sinalizadores de recurso, por exemplo, .appconfig.featureflag/myapp/Beta. |
|
Etiqueta |
Deixar em branco |
Você pode usar rótulos para criar flags de funcionalidades diferentes para a mesma chave e filtrar as flags carregadas na sua aplicação com base no rótulo. Por padrão, um sinalizador de recurso não tem rótulo. |
|
Descrição |
Deixar em branco |
Deixe em branco ou insira uma descrição para o sinalizador de recursos. |
Configure Variantes para comparar comportamentos, alocar tráfego e executar testes direcionados.
| Configuração |
Valor de exemplo |
Descrição |
|
Nome da variante |
Variante 1 |
Insira um nome único para cada variante. |
|
Valor |
<seu-valor-variante-1> |
O valor devolvido para a variante. Pode ser um objeto de string, número, booleano ou JSON. Use Editar valor em multilinha para configurações JSON complexas que a sua aplicação lê ao avaliar a flag. |
|
Variante padrão |
Variante 1 (Padrão) |
Escolha uma variante como opção de recurso estável e referência. Esta variante é devolvida quando nenhuma atribuição específica se aplica ou quando a flag de característica está desativada; É também a base usada para alocação direcionada e testes controlados. |
Configurar Alocação para distribuir o tráfego entre variantes e aplicar substituições para grupos ou utilizadores específicos.
| Configuração |
Valor de exemplo |
Descrição |
|
Distribuição do tráfego entre variantes |
Padrão: 100%
Variante 1: 0%
Variante 2: 0% |
Especifique a percentagem de tráfego alocada a cada variante. A distribuição para todas as variantes deve totalizar 100%. Usa isto para controlar como o público é exposto a diferentes variantes. |
|
Sobreposições de alocação |
Sobreposição por Grupos / Sobreposição por Utilizadores |
Atribuir variantes específicas a grupos selecionados ou utilizadores individuais, independentemente da alocação baseada em percentagem. Quando se aplicam sobrescrições de grupo e de utilizador, a atribuição de utilizador tem prioridade. |
|
Distribuição (semente) |
Utilizar seed personalizado: 12345 |
Por defeito, a distribuição percentil é aleatória. Forneça uma semente fixa para produzir alocações determinísticas (repetíveis) entre flags de funcionalidades que partilhem o mesmo valor de semente. |
Importante
Se avaliações de funcionalidades ocorrerem numa aplicação cliente (por exemplo, um navegador web), os dados de flag de funcionalidade — incluindo nomes de utilizador especificados aqui — podem ser expostos aos utilizadores finais. Para mais informações, consulte Aplicações Cliente na Configuração de Aplicações.
Configure as Condições para limitar a exposição, agendar alterações e gerir restrições personalizadas para servir as suas funcionalidades.
| Configuração |
Valor de exemplo |
Descrição |
|
Limitar a exposição |
A caixa está marcada |
Quando selecionados, opções adicionais parecem controlar a exposição por percentagem, grupos e utilizadores. Se não estiver desmarcada, a feature flag aplica-se globalmente sem estas restrições. |
|
Percentagem de Incumprimento |
100 |
Visível apenas quando está marcado o limite de exposição . Introduza um valor entre 0 e 100 para especificar a percentagem de toda a base de utilizadores que receberá o recurso automaticamente. |
|
Sobreposição por Grupos |
Incluir: Equipa de Marketing (100%)
Excluir: TestGroup |
Visível apenas quando está marcado o limite de exposição . Inclui grupos para ativar a funcionalidade mesmo que estejam fora da percentagem padrão. Exclua grupos para desativar a funcionalidade para eles. |
|
Sobrescrição por Utilizadores |
Incluir: john@example.com
Excluir: jane@example.com |
Visível apenas quando está marcado o limite de exposição . Inclua os utilizadores para ativar a funcionalidade mesmo que estejam fora da percentagem padrão. Exclua utilizadores para desativar a funcionalidade para eles. Para uma longa lista de utilizadores, recomendamos usar grupos em vez de utilizadores, pois as feature flags têm um limite de 10kb. |
|
Adicionar calendário |
Início: 2025-11-01
Fim: 2025-11-15
Fuso horário: (UTC-06:00) Hora Central (EUA e Canadá)
Recorrência: Semanalmente |
Defina um lançamento baseado no tempo especificando horários de início e fim. Opcionalmente, atualize o fuso horário sugerido e ative a recorrência para ativações repetidas (por exemplo, semanal ou mensal). |
|
Adicionar condição personalizada |
User.Region == "EU" |
Criar condições baseadas em atributos personalizados (por exemplo, região, tipo de dispositivo ou nível de subscrição). As condições permitem um direcionamento preciso, para que apenas os utilizadores que cumpram estes critérios recebam a funcionalidade. |
|
Exigir que todos os filtros de funcionalidades estejam ativados |
Ligado (selecionado) |
Esta opção só aparece depois de ativar múltiplas condições. Quando ativados, todos os filtros de funcionalidades devem ser avaliados como verdadeiro para que o sinalizador de funcionalidade seja aplicado (E lógico). Quando não estão verificados, os filtros são avaliados independentemente (OR lógico). |
Configure a Telemetria para recolher eventos de avaliação para este sinalizador de funcionalidade. Quando ativados, os eventos de avaliação são enviados para o editor de telemetria que configura na sua aplicação. Antes de ativar a telemetria, ligue um recurso Application Insights à App Configuration Store no Telemetry>App Insights.
Selecione Revisar + Criar para ver um resumo do seu novo sinalizador de funcionalidades e depois selecione Criar para finalizar a sua operação. Uma notificação indica que o novo sinalizador de recurso foi criado com êxito.
Editar sinalizadores de recursos
Para atualizar um flag de funcionalidade, siga estes passos:
No menu de recursos, vá aoGestor de Funcionalidades>.
Desloque-se para o extremo direito da feature flag que pretende modificar e selecione as reticências Mais ações (...). A partir deste menu, pode visualizar os detalhes da feature flag, editá-la, bloqueá-la ou desbloqueá-la, criar uma etiqueta, atualizar etiquetas, rever o histórico ou eliminá-la.
Selecione Editar para fazer alterações usando o editor visual, ou Edição Avançada para modificar diretamente o JSON bruto da bandeira.
Opcionalmente, altere o estado da feature flag ativando ou desativando a opção Ativada .
Gerir visualização
O menu do gestor de funcionalidades mostra as bandeiras de funcionalidades armazenadas na Configuração de Aplicações do Azure. Você pode alterar a exibição do Gerenciador de recursos no portal do Azure selecionando Gerenciar modo de exibição.
As definições permitem-te escolher quantos feature flags são carregados por ação de Carregar mais.
Carregar mais só será visível se houver mais de 200 sinais de funcionalidades.
Editar Colunas permite adicionar ou remover colunas e alterar a ordem das colunas.
Os sinalizadores de recursos criados com o Gerenciador de recursos são armazenados como valores-chave regulares. Eles são mantidos com o prefixo .appconfig.featureflag/ especial e o tipo de conteúdo application/vnd.microsoft.appconfig.ff+json;charset=utf-8.
Para exibir os valores-chave subjacentes dos sinalizadores de recursos no Configuration explorer, siga as etapas abaixo.
No menu de recursos, selecioneExplorador de Configuração de > e depois selecione Gerir Definições de Visualização>.
Selecione Incluir sinalizadores de recursos no gerenciador de configurações e Aplicar.
Conteúdo relacionado
Para começar a usar sinalizadores de recursos com a Configuração de Aplicativo do Azure, continue para os seguintes inícios rápidos específicos para o idioma ou a plataforma do seu aplicativo.