Tutorial: Uso de la configuración dinámica en una aplicación de Azure Functions

En este tutorial se muestra cómo habilitar las actualizaciones de configuración dinámica en la aplicación de Azure Functions. Se basa en la aplicación de Azure Functions introducida en los inicios rápidos. Antes de continuar, primero finalice la creación de una aplicación de Azure Functions con Azure App Configuration.

En este tutorial, aprenderá a:

Prerrequisitos

• Finalización del inicio rápido Creación de una aplicación de Azure Functions con Azure App Configuration

Recarga de datos de App Configuration

El proveedor .NET de Azure App Configuration admite el almacenamiento en caché y la actualización dinámica de las opciones de configuración en función de la actividad de la aplicación. En esta sección, configurará el proveedor para actualizar la configuración dinámicamente y habilitará la actualización automática de la configuración mediante el middleware de App Configuration, Microsoft.Azure.AppConfiguration.Functions.Worker, cada vez que se ejecute una función.

1. Abra el archivo Program.cs y actualice la llamada a AddAzureAppConfiguration para incluir el ConfigureRefresh método . Este método configura las condiciones para actualizar las opciones de configuración, incluida la especificación de las claves que se van a supervisar y el intervalo entre las comprobaciones de actualización.

   • Microsoft Entra ID (recomendado)
   • Cadena de conexión

   // Connect to Azure App Configuration
   builder.Configuration.AddAzureAppConfiguration(options =>
   {
       Uri endpoint = new(Environment.GetEnvironmentVariable("AZURE_APPCONFIG_ENDPOINT") ?? 
           throw new InvalidOperationException("The environment variable 'AZURE_APPCONFIG_ENDPOINT' is not set or is empty."));
       options.Connect(endpoint, new DefaultAzureCredential())
              // Load all keys that start with `TestApp:` and have no label
              .Select("TestApp:*")
              // Reload configuration if any selected key-values have changed.
              // Use the default refresh interval of 30 seconds. It can be overridden via AzureAppConfigurationRefreshOptions.SetRefreshInterval.
              .ConfigureRefresh(refreshOptions =>
              {
                  refreshOptions.RegisterAll();
              });
   });
   

   Llame al método RegisterAll para indicar al proveedor de App Configuration que vuelva a cargar toda la configuración siempre que detecte un cambio en cualquiera de los valores clave seleccionados (aquellos que comienzan con TestApp: y que no tienen etiqueta). Para obtener más información sobre la supervisión de los cambios de configuración, consulte Procedimientos recomendados para la actualización de la configuración.

   De forma predeterminada, el intervalo de actualización se establece en 30 segundos. Puede personalizar este intervalo llamando al AzureAppConfigurationRefreshOptions.SetRefreshInterval método .

2. Actualice el archivo Program.cs para habilitar la actualización automática de la configuración tras cada ejecución de función agregando el middleware de App Configuration:

   // Connect to Azure App Configuration
   builder.Configuration.AddAzureAppConfiguration(options =>
   {
       // Omitted the code added in the previous step.
   });
   
   // Add Azure App Configuration middleware to the service collection.
   builder.Services.AddAzureAppConfiguration()
   
   // Use Azure App Configuration middleware for dynamic configuration refresh.
   builder.UseAzureAppConfiguration();
   
   builder.ConfigureFunctionsWebApplication();
   
   builder.Build().Run();
   

Prueba local de la función

1. Establezca la variable de entorno .

   • Microsoft Entra ID (recomendado)
   • Cadena de conexión

   Establezca la variable de entorno denominada AZURE_APPCONFIG_ENDPOINT en el punto de conexión del almacén de App Configuration que se encuentra en la Información general del almacén en Azure Portal.

   Si usa el símbolo del sistema de Windows, ejecute el siguiente comando y reinícielo para que se aplique el cambio:

   setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
   

   Si usa PowerShell, ejecute el siguiente comando:

   $Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
   

   Si usa macOS o Linux, ejecute el siguiente comando:

   export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
   

2. Para probar la función, presione F5. 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.

   

5. Seleccione el almacén de App Configuration en Azure Portal y actualice el valor de la siguiente clave en el Explorador de configuración.

   Clave	Importancia
   TestApp:Settings:Message	Datos de Azure App Configuration, actualizados

6. Actualice el explorador varias veces. Después de pasar el intervalo de actualización predeterminado de 30 segundos, la página muestra el valor actualizado recuperado de la aplicación de Azure Functions.

   

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.

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 tutorial, ha habilitado la aplicación de Azure Functions para actualizar dinámicamente las opciones de configuración desde App Configuration.

Para obtener información sobre cómo usar marcas de características desde Azure App Configuration dentro de la aplicación de Azure Functions, continúe con el tutorial siguiente.

Para aprender a usar una identidad administrada de Azure para simplificar el acceso a App Configuration, continúe con el siguiente tutorial.