Início Rápido: adicionar sinalizadores de recursos a um aplicativo de console do .NET/.NET Framework

  • Artigo

Neste início rápido, você incorporará a Configuração de Aplicativos do Azure a um aplicativo de console .NET Framework para criar uma implementação de ponta a ponta do gerenciamento de recursos. Você pode usar a Configuração de Aplicativos para armazenar centralmente todos os sinalizadores de recursos e controlar seus estados.

As bibliotecas do Gerenciamento de Recursos do .NET estendem a estrutura com suporte a sinalizadores de recursos. Essas bibliotecas se baseiam no sistema de configuração do .NET. Elas são integradas à Configuração de Aplicativos por meio do provedor de configuração do .NET.

Pré-requisitos

Adicionar um sinalizador de recursos

Adicione um sinalizador de recurso chamado Beta ao repositório da Configuração de Aplicativos e deixe o Rótulo e a Descrição com seus valores padrão. Para mais informações sobre como adicionar sinalizadores de recursos a um repositório usando o portal do Azure ou a CLI, acesse Criar um sinalizador de recurso.

Habilitar o sinalizador de recurso chamado Beta

Criar um aplicativo de console

Você pode usar o Visual Studio para criar um novo projeto de aplicativo de console.

  1. Inicie o Visual Studio e selecione Arquivo>Novo>Projeto.

  2. Em Criar um novo projeto, filtre Console no tipo de projeto e selecione Aplicativo de Console. Se você quiser criar um aplicativo .NET Framework, selecione Aplicativo de Console (.NET Framework). Clique em Avançar.

  3. Em Configurar seu novo projeto, insira um nome de projeto. Se você estiver criando um aplicativo .NET Framework, selecione .NET Framework 4.7.2 ou superior em Framework. Clique em Criar.

Usar o sinalizador de recurso

  1. Clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes do NuGet. Na guia Navegar, pesquise e adicione os seguintes pacotes do NuGet ao projeto.

    Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement

    Verifique se a versão de Microsoft.FeatureManagement é maior que 3.1.0.

  2. Abra Program.cs e adicione as instruções a seguir.

    using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;
using Microsoft.FeatureManagement;

  3. Conecte-se à Configuração de Aplicativos especificando a opção UseFeatureFlags para que os sinalizadores de recursos sejam recuperados. Crie um ConfigurationFeatureDefinitionProvider para fornecer a definição de sinalizador de recurso da configuração e FeatureManager para avaliar o estado dos sinalizadores de recursos. Em seguida, exiba uma mensagem se o sinalizador de recursos Beta estiver habilitado.

    IConfiguration configuration = new ConfigurationBuilder()
    .AddAzureAppConfiguration(options =>
    {
        options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
            .UseFeatureFlags();
    }).Build();

IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);

IFeatureManager featureManager = new FeatureManager(
    featureDefinitionProvider, 
    new FeatureManagementOptions());

if (await featureManager.IsEnabledAsync("Beta"))
{
    Console.WriteLine("Welcome to the beta!");
}

Console.WriteLine("Hello World!");

Compilar e executar o aplicativo localmente

  1. Defina uma variável de ambiente chamada ConnectionString como a cadeia de conexão do repositório de Configuração de Aplicativos.

    Se você usar o prompt de comando do Windows, execute o comando a seguir.

    setx ConnectionString "connection-string-of-your-app-configuration-store"

    Reinicie o prompt de comando para permitir que a alteração entre em vigor. Imprima o valor da variável de ambiente para validar que ele está definido corretamente.

  2. Reinicie o Visual Studio para permitir que a alteração tenha efeito.

  3. Pressione Ctrl + F5 para compilar e executar o aplicativo.

  4. Você deve ver as seguintes saídas no console.

    Aplicativo com sinalizador de recursos desabilitado

  5. Entre no portal do Azure. Escolha Todos os recursos e escolha o repositório de Configuração de Aplicativos que você criou anteriormente.

  6. Selecione Gerenciador de recursos e localize o sinalizador de recurso Beta. Habilite o sinalizador marcando a caixa de seleção abaixo de Habilitado.

  7. Execute o aplicativo novamente. Você deve ver a mensagem Beta no console.

    Aplicativo com sinalizador de recursos habilitado

Limpar os recursos

Se não deseja continuar usando os recursos criados neste artigo, exclua o grupo de recursos que você criou aqui para evitar encargos.

Importante

A exclusão de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos contidos nele são excluídos permanentemente. Não exclua acidentalmente grupo de recursos ou recursos incorretos. Se tiver criado os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que você deseja manter, exclua cada um individualmente do respectivo painel em vez de excluir o grupo de recursos.

  1. Entre no portal do Azure e selecione Grupos de recursos.
  2. Na caixa Filtrar por nome..., digite o nome do seu grupo de recursos.
  3. Na lista de resultados, selecione o nome do grupo de recursos para conferir uma visão geral.
  4. Selecione Excluir grupo de recursos.
  5. Você receberá uma solicitação para confirmar a exclusão do grupo de recursos. Insira o nome do grupo de recursos para confirmar e selecione Excluir.

Após alguns instantes, o grupo de recursos e todos os recursos dele são excluídos.

Próximas etapas

Neste início rápido, você criou um sinalizador de recursos na Configuração de Aplicativos e o usou com um aplicativo de console. Para saber como atualizar dinamicamente os sinalizadores de recursos e outros valores de configuração sem reiniciar o aplicativo, passe para o próximo tutorial.

Habilitar a configuração dinâmica em um aplicativo .NET

Habilitar a configuração dinâmica em um aplicativo .NET Framework