Quickstart: Adicione bandeiras de recurso a uma aplicação .NET Framework

Neste arranque rápido, incorpora-se Azure App Configuration numa aplicação .NET Framework para criar uma implementação de ponta a ponta da gestão de funcionalidades. Pode utilizar o serviço App Configuration para armazenar centralmente todas as suas bandeiras de recurso e controlar os seus estados.

As bibliotecas de Gestão de Recursos .NET estendem o quadro com suporte de bandeira de recurso. Estas bibliotecas são construídas em cima do sistema de configuração .NET. Integram-se com App Configuration através do seu fornecedor de configuração .NET.

Pré-requisitos

Criar uma loja App Configuration

  1. Para criar uma nova loja de App Configuration, inscreva-se no portal do Azure.

  2. No canto superior esquerdo da página inicial, selecione Criar um recurso.

  3. Nos serviços de Pesquisa e caixa de mercado, introduza App Configuration e selecione Enter.

    Screenshot que mostra a página Search for App Configuration.

  4. Selecione App Configuration dos resultados da pesquisa e, em seguida, selecione Criar.

    Screenshot que mostra a página Criar.

  5. No painel De criação App Configuration, introduza as seguintes definições:

    Definição Valor sugerido Descrição
    Subscrição A sua subscrição Selecione a subscrição Azure que pretende utilizar para testar App Configuration. Se a sua conta tiver apenas uma subscrição, é selecionada automaticamente e a lista de Assinaturas não é apresentada.
    Grupo de recursos AppConfigTestResources Selecione ou crie um grupo de recursos para o seu recurso App Configuration loja. Este grupo é útil para organizar múltiplos recursos que você pode querer eliminar ao mesmo tempo, eliminando o grupo de recursos. Para obter mais informações, veja Utilizar grupos de recursos para gerir os recursos do Azure.
    Nome de recurso Nome globalmente exclusivo Introduza um nome de recurso único para usar para o recurso App Configuration loja. O nome deve ser uma corda entre 5 e 50 caracteres e conter apenas números, letras e o - personagem. O nome não pode começar ou terminar com o - personagem.
    Localização E.U.A. Central Utilize a Localização para especificar a localização geográfica em que a sua loja de configuração de aplicações está hospedada. Para obter o melhor desempenho, crie o recurso na mesma região que outros componentes da sua aplicação.
    Escalão de preço Gratuito Selecione o nível de preços pretendido. Para mais informações, consulte a página de preços App Configuration.
  6. Selecione Rever + criar para validar as suas definições.

  7. Selecione Criar. A implantação pode demorar alguns minutos.

  8. Depois de terminar a implantação, vá ao App Configuration recurso. Selecione Definições>Chaves de acesso. Tome nota da ligação principal apenas para leitura. Mais tarde, utilizará esta cadeia de ligação para configurar a sua aplicação para comunicar com a loja App Configuration que criou.

  1. Selecione Feature Manager>+Adicione para adicionar uma bandeira de recurso chamada Beta.

    Ativar a bandeira de recurso chamada Beta

    Deixe label indefinida por enquanto.

Criar uma aplicação de consola .NET

  1. Inicie o Estúdio Visual e selecione o File>New>Project.

  2. In Create a new project, filter on the Console project type and click on Console App (.NET Framework). Clique em Seguinte.

  3. Em Configurar o seu novo projeto, insira um nome de projeto. No Quadro, selecione .NET Framework 4.8 ou superior. Clique em Criar.

Conecte-se a uma loja App Configuration

  1. Clique com o botão direito no seu projeto e selecione Gerir pacotes NuGet. No separador Procurar, procure e adicione os seguintes pacotes NuGet ao seu projeto.

    Microsoft.Extensions.DependencyInjection
    Microsoft.Extensions.Configuration.AzureAppConfiguration
    Microsoft.FeatureManagement
    
  2. Programa Aberto.cs e adicione as seguintes declarações:

    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    using Microsoft.FeatureManagement;
    using System.Threading.Tasks;
    
  3. Atualize o Main método de ligação à App Configuration, especificando a opção UseFeatureFlags para que as bandeiras de recurso sejam recuperadas. Em seguida, apresente uma mensagem se a bandeira de Beta funcionalidade estiver ativada.

        public static async Task Main(string[] args)
        {         
            IConfigurationRoot configuration = new ConfigurationBuilder()
                .AddAzureAppConfiguration(options =>
                {
                    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                           .UseFeatureFlags();
                }).Build();
    
            IServiceCollection services = new ServiceCollection();
    
            services.AddSingleton<IConfiguration>(configuration).AddFeatureManagement();
    
            using (ServiceProvider serviceProvider = services.BuildServiceProvider())
            {
                IFeatureManager featureManager = serviceProvider.GetRequiredService<IFeatureManager>();
    
                if (await featureManager.IsEnabledAsync("Beta"))
                {
                    Console.WriteLine("Welcome to the beta!");
                }
            }
    
            Console.WriteLine("Hello World!");
            Console.WriteLine("Press any key to continue ...");
            Console.Read();
        }
    

Construa e execute a app localmente

  1. Desaprova uma variável ambiental chamada ConnectionString para a cadeia de ligação da sua loja App Configuration. Se utilizar o pedido de comando do Windows, executar o seguinte comando:

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

    Se utilizar Windows PowerShell, executar o seguinte comando:

        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    
  2. Reinicie o Estúdio Visual para permitir que a mudança entre em vigor.

  3. Prima Ctrl + F5 para construir e executar a aplicação da consola.

    App com bandeira de recurso ativada

Limpar os recursos

Se não quiser continuar a utilizar os recursos criados neste artigo, elimine o grupo de recursos que criou aqui para evitar encargos.

Importante

A eliminação de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos nele são permanentemente eliminados. Certifique-se de que não apaga acidentalmente o grupo ou recursos errados. Se criou os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que pretende manter, elimine cada recurso individualmente do seu respetivo painel em vez de eliminar o grupo de recursos.

  1. Inscreva-se no portal do Azure e selecione grupos de recursos.
  2. Na caixa de identificação filter by name , insira o nome do seu grupo de recursos.
  3. Na lista de resultados, selecione o nome do grupo de recursos para ver uma visão geral.
  4. Selecione Eliminar grupo de recursos.
  5. É-lhe pedido que confirme a eliminação do grupo de recursos. Introduza o nome do seu grupo de recursos para confirmar e selecione Delete.

Após alguns momentos, o grupo de recursos e todos os seus recursos são eliminados.

Passos seguintes

Neste arranque rápido, criou uma bandeira de recurso em App Configuration e utilizou-a com uma aplicação de consola .NET Framework. Para aprender a atualizar dinamicamente as bandeiras de funcionalidades e outros valores de configuração sem reiniciar a aplicação, continue para o próximo tutorial.