Guia de início rápido: criar um aplicativo do Azure Functions com a Configuração do Aplicativo do Azure

Neste início rápido, você incorpora o serviço de Configuração de Aplicativo do Azure em um aplicativo do Azure Functions para centralizar o armazenamento e o gerenciamento de todas as configurações do aplicativo separadamente do seu código.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Crie um gratuitamente.
• Uma loja de configuração de aplicativos. Crie uma loja.
• Visual Studio com a carga de trabalho de desenvolvimento do Azure.
• Ferramentas do Azure Functions, se ainda não as tiver instaladas com o Visual Studio.

Adicionar um valor-chave

Adicione o seguinte valor-chave à loja de Configuração de Aplicativos e deixe Rótulo e Tipo de Conteúdo com seus valores padrão. Para obter mais informações sobre como adicionar valores-chave a uma loja usando o portal do Azure ou a CLI, vá para Criar um valor-chave.

Key	valor
TestApp:Configurações:Mensagem	Dados da Configuração do Aplicativo do Azure

Criar um aplicativo Functions

O modelo de projeto do Azure Functions no Visual Studio cria um projeto de biblioteca de classes C# que você pode publicar em um aplicativo de função no Azure. Você pode usar um aplicativo de função para agrupar funções como uma unidade lógica para facilitar o gerenciamento, a implantação, o dimensionamento e o compartilhamento de recursos.

1. No menu Visual Studio, selecione Arquivo>Novo>Projeto.

2. Em Criar um novo projeto, insira funções na caixa de pesquisa, escolha o modelo Azure Functions e selecione Avançar.

3. Em Configurar seu novo projeto, insira um nome de projeto para seu projeto e selecione Criar. O nome da aplicação de funções deve ser válido como um espaço de nomes C#. Portanto, não use sublinhados, hífenes ou outros carateres não alfanuméricos.

4. Para criar uma nova configuração do aplicativo Azure Functions, use os valores na tabela a seguir:

   Processo isolado

   Definição	valor	Description
   Versão .NET	.NET 6 isolado	Esse valor cria um projeto de função que é executado em um processo de trabalho isolado. O processo de trabalho isolado suporta outra versão não-LTS do .NET e também do .NET Framework. Para obter mais informações, consulte Visão geral das versões de tempo de execução do Azure Functions.
   Modelo de função	Acionador HTTP	Esse valor cria uma função acionada por uma solicitação HTTP.
   Conta de armazenamento (AzureWebJobsStorage)	Emulador de armazenamento	Como um aplicativo de função no Azure requer uma conta de armazenamento, uma é atribuída ou criada quando você publica seu projeto no Azure. Um gatilho HTTP não usa uma cadeia de conexão de conta de Armazenamento do Azure; todos os outros tipos de gatilho exigem uma cadeia de conexão de conta de Armazenamento do Azure válida.
   Nível de autorização	Anônimo	A função criada pode ser acionada por qualquer cliente sem fornecer uma chave. Esta definição de autorização torna mais fácil testar a função nova. Para obter mais informações sobre chaves e autorização, consulte Chaves de autorização e Ligações HTTP e webhook.

   

   Em processo

   Importante

   O suporte para o modelo em processo terminará em 10 de novembro de 2026. É altamente recomendável que você migre seus aplicativos para o modelo de trabalho isolado para obter suporte total.

   Definição	valor	Description
   Versão .NET	.NET 6	Esse valor cria um projeto de função que é executado em processo com a versão 4.x do tempo de execução do Azure Functions. Para obter mais informações, consulte Visão geral das versões de tempo de execução do Azure Functions.
   Modelo de função	Acionador HTTP	Esse valor cria uma função acionada por uma solicitação HTTP.
   Conta de armazenamento (AzureWebJobsStorage)	Emulador de armazenamento	Como um aplicativo de função no Azure requer uma conta de armazenamento, uma é atribuída ou criada quando você publica seu projeto no Azure. Um gatilho HTTP não usa uma cadeia de conexão de conta de Armazenamento do Azure; todos os outros tipos de gatilho exigem uma cadeia de conexão de conta de Armazenamento do Azure válida.
   Nível de autorização	Anônimo	A função criada pode ser acionada por qualquer cliente sem fornecer uma chave. Esta definição de autorização torna mais fácil testar a função nova. Para obter mais informações sobre chaves e autorização, consulte Chaves de autorização e Ligações HTTP e webhook.

   

   Certifique-se de definir o nível de Autorização como Anônimo. Se você escolher o nível padrão de Função, será necessário apresentar a tecla de função em solicitações para acessar seu ponto de extremidade de função.

5. Selecione Criar para criar o projeto de função e a função de gatilho HTTP.

Conectar-se a uma loja de configuração de aplicativos

Este projeto usará a injeção de dependência no .NET Azure Functions e adicionará a Configuração do Aplicativo do Azure como uma fonte de configuração extra. O Azure Functions dá suporte à execução em processo ou processo isolado. Escolha o que corresponde às suas necessidades.

1. Clique com o botão direito do mouse em seu projeto e selecione Gerenciar pacotes NuGet. Na guia Procurar, procure e adicione os seguintes pacotes NuGet ao seu projeto.

   Em processo

   • Microsoft.Extensions.Configuration.AzureAppConfiguration versão 4.1.0 ou posterior
   • Microsoft.Azure.Functions.Extensions versão 1.1.0 ou posterior

   Processo isolado

   • Microsoft.Azure.AppConfiguration.Functions.Worker

2. Adicione código para se conectar à Configuração do Aplicativo do Azure.

   Em processo

   Adicione um novo arquivo, Startup.cs, com o código a seguir. Ele define uma classe chamada Startup que implementa a FunctionsStartup classe abstrata. Um atributo assembly é usado para especificar o nome do tipo usado durante a inicialização do Azure Functions.

   O ConfigureAppConfiguration método é substituído e o provedor de Configuração de Aplicativo do Azure é adicionado como uma fonte de configuração extra chamando AddAzureAppConfiguration(). O Configure método é deixado vazio, pois você não precisa registrar nenhum serviço neste momento.

   using System;
   using Microsoft.Azure.Functions.Extensions.DependencyInjection;
   using Microsoft.Extensions.Configuration;
   
   [assembly: FunctionsStartup(typeof(FunctionApp.Startup))]
   
   namespace FunctionApp
   {
       class Startup : FunctionsStartup
       {
           public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
           {
               string cs = Environment.GetEnvironmentVariable("ConnectionString");
               builder.ConfigurationBuilder.AddAzureAppConfiguration(cs);
           }
   
           public override void Configure(IFunctionsHostBuilder builder)
           {
           }
       }
   }
   

   Processo isolado

   Abra Program.cs e atualize o Main() método da seguinte forma. Você adiciona o provedor de Configuração de Aplicativo do Azure como uma fonte de configuração extra chamando AddAzureAppConfiguration().

   public static void Main()
   {
       var host = new HostBuilder()
           .ConfigureAppConfiguration(builder =>
           {
               string cs = Environment.GetEnvironmentVariable("ConnectionString");
               builder.AddAzureAppConfiguration(cs);
           })
           .ConfigureFunctionsWorkerDefaults()
           .Build();
   
       host.Run();
   }
   

3. Abra Function1.cs e adicione o namespace a seguir se ele ainda não estiver presente.

   using Microsoft.Extensions.Configuration;
   

   Adicione ou atualize o construtor usado para obter uma instância de IConfiguration through dependency injection.

   Em processo

   private readonly IConfiguration _configuration;
   
   public Function1(IConfiguration configuration)
   {
       _configuration = configuration;
   }
   

   Processo isolado

   private readonly IConfiguration _configuration;
   
   public Function1(ILoggerFactory loggerFactory, IConfiguration configuration)
   {
       _logger = loggerFactory.CreateLogger<Function1>();
       _configuration = configuration;
   }
   

4. Atualize o Run método para ler valores da configuração.

   Em processo

   [FunctionName("Function1")]
   public async Task<IActionResult> Run(
       [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, ILogger log)
   {
       log.LogInformation("C# HTTP trigger function processed a request.");
   
       // Read configuration data
       string keyName = "TestApp:Settings:Message";
       string message = _configuration[keyName];
   
       return message != null
           ? (ActionResult)new OkObjectResult(message)
           : new BadRequestObjectResult($"Please create a key-value with the key '{keyName}' in App Configuration.");
   }
   

   Nota

   A Function1 classe e o Run método não devem ser estáticos. Remova o static modificador se ele tiver sido gerado automaticamente.

   Processo isolado

   [Function("Function1")]
   public HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req)
   {
       _logger.LogInformation("C# HTTP trigger function processed a request.");
   
       var response = req.CreateResponse(HttpStatusCode.OK);
       response.Headers.Add("Content-Type", "text/plain; charset=utf-8");
   
       // Read configuration data
       string keyName = "TestApp:Settings:Message";
       string message = _configuration[keyName];
   
       response.WriteString(message ?? $"Please create a key-value with the key '{keyName}' in Azure App Configuration.");
   
       return response;
   }
   

Testar localmente a função

1. Defina uma variável de ambiente chamada ConnectionString e defina-a como a chave de acesso à sua loja de configuração de aplicativos. Se você usar o prompt de comando do Windows, execute o seguinte comando e reinicie o prompt de comando para permitir que a alteração entre em vigor:

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

   Se você usar o Windows PowerShell, execute o seguinte comando:

       $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
   

   Se você usa macOS ou Linux, execute o seguinte comando:

       export ConnectionString='connection-string-of-your-app-configuration-store'
   

2. Pressione F5 para testar sua função. Se solicitado, aceite a solicitação do Visual Studio para baixar e instalar as ferramentas CLI (Azure Functions Core). Também pode ser necessário habilitar uma exceção de firewall para que as ferramentas possam lidar com solicitações HTTP.

3. Copie o URL da sua função na saída do tempo de execução das funções do Azure.

   

4. Cole o URL do pedido HTTP na barra de endereço do browser. A imagem a seguir mostra a resposta no navegador para a solicitação GET local retornada pela função.

   

Clean up resources (Limpar recursos)

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

Importante

A eliminação de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos nele contidos são excluídos permanentemente. Certifique-se de não excluir acidentalmente o grupo de recursos ou recursos errados. Se você criou os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que deseja manter, exclua cada recurso individualmente de seu respetivo 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, introduza 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. Insira o nome do grupo de recursos a ser confirmado e selecione Excluir.

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

Próximos passos

Neste início rápido, você criou uma nova loja de Configuração de Aplicativo e a usou com um aplicativo do Azure Functions por meio do provedor de Configuração de Aplicativo. Para saber como atualizar seu aplicativo Azure Functions para atualizar dinamicamente a configuração, continue para o próximo tutorial.

Ativar a configuração dinâmica nas Funções do Azure

Para saber como usar uma identidade gerenciada do Azure para simplificar o acesso à Configuração do Aplicativo, continue para o próximo tutorial.

Acessar a configuração do aplicativo usando identidade gerenciada