Inicio rápido: Creación de una aplicación de Azure Functions con Azure App Configuration

En este inicio rápido se incorpora el servicio Azure App Configuration en una aplicación de Azure Functions para centralizar el almacenamiento y la administración de toda la configuración de la aplicación de forma independiente del código.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.
• Un almacén de App Configuration. Crear un almacén.
• Visual Studio con la carga de trabajo de desarrollo de Azure.
• Herramientas de Azure Functions, si no se han instalado ya con Visual Studio.

Agregar un par clave-valor

Agregue el siguiente par clave-valor al almacén de App Configuration y deje Etiqueta y Tipo de contenido con sus valores predeterminados. Para obtener más información sobre cómo agregar pares clave-valor a un almacén mediante Azure Portal o la CLI, vaya a Creación de un par clave-valor.

Clave	Value
TestApp:Settings:Message	Datos de Azure App Configuration

Creación de una aplicación de Functions

La plantilla del proyecto de Azure Functions de Visual Studio crea un proyecto de biblioteca de clases de C# que puede publicar en una aplicación de funciones en Azure. Una aplicación de funciones permite agrupar funciones como una unidad lógica para facilitar la administración, la implementación, el escalado y el uso compartido de recursos.

1. En el menú de Visual Studio, seleccione Archivo>Nuevo>Proyecto.

2. En Crear un proyecto, escriba functions en el cuadro de búsqueda, elija la plantilla Azure Functions y seleccione Siguiente.

3. En Configurar el nuevo proyecto, escriba un nombre de proyecto para el proyecto y, a continuación, seleccione Crear. El nombre de la aplicación de función debe ser válido como espacio de nombres de C#, por lo que no debe usar guiones bajos, guiones u otros caracteres no alfanuméricos.

4. En la configuración de Crear aplicación de Azure Functions, use los valores de la tabla siguiente:

   Proceso aislado

   Configuración	valor	Descripción
   Versión de .NET	.NET 6 aislado	Este valor crea un proyecto de función que se ejecuta en un proceso de trabajo aislado. El proceso de trabajo aislado admite otras versiones que no sean LTS de .NET y también .NET Framework. Para más información, consulte Selección de un destino para versiones de runtime de Azure Functions.
   Plantilla de función	desencadenador HTTP	Este valor crea una función desencadenada por una solicitud HTTP.
   Cuenta de almacenamiento (AzureWebJobsStorage)	Emulador de Storage	Dado que una aplicación de funciones de Azure necesita una cuenta de almacenamiento, se asigna o se crea una cuando publica su proyecto en Azure. Un desencadenador HTTP no utiliza una cadena de conexión de cuenta de Azure Storage; todos los demás tipos de desencadenador requieren una cadena de conexión de cuenta de Azure Storage válida.
   Nivel de autorización	Anónimo	Cualquier cliente puede desencadenar una función creada sin tener que proporcionar una clave. Esta configuración de autorización facilita probar la función nueva. Para más información sobre las claves y la autorización, consulte Claves de autorización e Introducción a los enlaces y desencadenadores HTTP de Azure Functions.

   

   En proceso

   Importante

   El soporte técnico del modelo en proceso finalizará el 10 de noviembre de 2026. Se recomienda encarecidamente migrar las aplicaciones al modelo de trabajo aislado para obtener soporte técnico completo.

   Configuración	valor	Descripción
   Versión de .NET	.NET 6	Este valor crea un proyecto de función que se ejecuta dentro de proceso con la versión 4.x del entorno de ejecución de Azure Functions. Para más información, consulte Selección de un destino para versiones de runtime de Azure Functions.
   Plantilla de función	desencadenador HTTP	Este valor crea una función desencadenada por una solicitud HTTP.
   Cuenta de almacenamiento (AzureWebJobsStorage)	Emulador de Storage	Dado que una aplicación de funciones de Azure necesita una cuenta de almacenamiento, se asigna o se crea una cuando publica su proyecto en Azure. Un desencadenador HTTP no utiliza una cadena de conexión de cuenta de Azure Storage; todos los demás tipos de desencadenador requieren una cadena de conexión de cuenta de Azure Storage válida.
   Nivel de autorización	Anónimo	Cualquier cliente puede desencadenar una función creada sin tener que proporcionar una clave. Esta configuración de autorización facilita probar la función nueva. Para más información sobre las claves y la autorización, consulte Claves de autorización e Introducción a los enlaces y desencadenadores HTTP de Azure Functions.

   

   Asegúrese de establecer el Nivel de autorización en Anónimo. Al elegir el nivel predeterminado de Función, tiene que presentar la tecla de función en las solicitudes para acceder al punto de conexión de la función.

5. Seleccione Crear para crear el proyecto de función y la función con desencadenador HTTP.

Conexión a un almacén de App Configuration

En este proyecto se usa la inserción de dependencias en Azure Functions para .NET y se agrega Azure App Configuration como origen de configuración adicional. Azure Functions admite la ejecución en proceso o en un proceso aislado. Elija la que se ajuste a sus requisitos.

1. Haga clic con el botón derecho en el proyecto y seleccione Administrar paquetes NuGet. En la pestaña Examinar, busque los siguientes paquetes NuGet y agréguelos al proyecto.

   En proceso

   • Microsoft.Extensions.Configuration.AzureAppConfiguration, versión 4.1.0 o posterior
   • Microsoft.Azure.Functions.Extensions, versión 1.1.0 o posterior

   Proceso aislado

   • Microsoft.Azure.AppConfiguration.Functions.Worker

2. Agregue código para conectarse a Azure App Configuration.

   En proceso

   Agregue un nuevo archivo, Startup.cs, con el código siguiente. Se define una clase denominada Startup que implementa la clase abstracta FunctionsStartup. Para especificar el nombre de tipo empleado durante el inicio de Azure Functions, se usa un atributo de ensamblado.

   El método ConfigureAppConfiguration se invalida y se llama a AddAzureAppConfiguration() para agregar el proveedor de Azure App Configuration como origen de configuración adicional. El método Configure se deja vacío, ya que no es necesario registrar ningún servicio en este 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)
           {
           }
       }
   }
   

   Proceso aislado

   Abra Program.cs y actualice el método Main() de la siguiente manera. Llame a AddAzureAppConfiguration() para agregar el proveedor de Azure App Configuration como origen de configuración adicional.

   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 y agregue el siguiente espacio de nombres si aún no está presente.

   using Microsoft.Extensions.Configuration;
   

   Agregue o actualice un constructor utilizado para obtener instancias de IConfiguration mediante la inserción de dependencias.

   En proceso

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

   Proceso aislado

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

4. Actualice el método Run para que lea los valores de la configuración.

   En proceso

   [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

   La clase Function1 y el método Run no deben ser estáticos. Quite el modificador static si se ha generado automáticamente.

   Proceso aislado

   [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;
   }
   

Prueba local de la función

1. Establezca una variable de entorno llamada ConnectionString y defínala como la clave de acceso a su almacén de App Configuration. Si usa el símbolo del sistema de Windows, ejecute el siguiente comando y reinícielo para que se aplique el cambio:

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

   Si usa Windows PowerShell, ejecute el siguiente comando:

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

   Si usa macOS o Linux, ejecute el siguiente comando:

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

2. Presione F5 para probar la función. Si se le solicita, acepte la solicitud de Visual Studio para descargar e instalar las herramientas de Azure Functions Core (CLI) . También es preciso que habilite una excepción de firewall para que las herramientas para controlen las solicitudes de HTTP.

3. Copie la dirección URL de la función de los resultados del runtime de Azure Functions.

   

4. Pegue la dirección URL de la solicitud HTTP en la barra de direcciones del explorador. La siguiente imagen muestra la respuesta en el explorador para la solicitud GET local devuelta por la función.

   

Limpieza de recursos

Si no quiere seguir usando los recursos que se han creado en este artículo, elimine el grupo de recursos que creó aquí para evitar cargos.

Importante

La eliminación de un grupo de recursos es irreversible. El grupo de recursos y todos los recursos que contiene se eliminan permanentemente. Asegúrese de que no elimina por accidente el grupo de recursos o los recursos equivocados. Si creó los recursos para este artículo en un grupo de recursos que contenga los recursos que desee conservar, elimine cada recurso de forma individual desde su panel respectivo, en lugar de eliminar el grupo de recursos.

1. Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
2. En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
3. En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
4. Seleccione Eliminar grupo de recursos.
5. Se le pedirá que confirme la eliminación del grupo de recursos. Escriba el nombre del grupo de recursos para confirmar y seleccione Eliminar.

Transcurridos unos instantes, el grupo de recursos y todos sus recursos se eliminan.

Pasos siguientes

En este inicio rápido, ha creado un almacén de App Configuration y lo ha usado con una aplicación de Azure Functions a través del proveedor de App Configuration. Para aprender a actualizar una aplicación de Azure Functions para poner al día dinámicamente la configuración, continúe con el siguiente tutorial.

Habilitación de la configuración dinámica en Azure Functions

Para obtener información sobre cómo usar una identidad administrada de Azure para simplificar el acceso a App Configuration, vaya al siguiente tutorial.

Acceso a App Configuration mediante una identidad administrada