Añadir ficheros y otros orígenes de configuración en una aplicación Web o Api

Ahora que tenemos .Net 6 disponible para desarrollar, es necesario que nos acostumbremos a ciertos cambios relativos a la configuración y ubicación de determinados fragmentos de código así como a nueva nomenclatura y significativos cambios que tienen el fin de simplificar el desarrollo.

Entre estos cambios, se encuentra el especificar los ficheros y otros orígenes de configuración de nuestras aplicaciones, es decir, de dónde se tomarán los valores de las variables de entorno y configuración a la hora de ejecutar las aplicaciones.

¿Dónde especificamos los orígenes de configuración de la aplicación?

Como ya vimos en un artículo anterior, el fichero Program.cs es resultado de la fusión con el antiguo Startup.cs  que ha cambiado bastante su apariencia y la forma de escribir código en él. No obstante, lo que no ha cambiado es que sigue siendo el lugar adecuado para especificar y configurar los ficheros y otros orígenes de configuración de las aplicaciones desarrolladas con .Net 6

¿Cómo se hacía en versiones anteriores?

Si echamos un vistazo a lo que hacíamos en versiones anteriores de .Net, aprovechábamos la declaración de una propiedad pública y estática de tipo IConfiguration donde definíamos los orígenes de la configuración.

En el código que os adjunto a continuación, correspondiente a .Net Core 3.1, establecemos que se busque en el fichero actual de la aplicación el fichero appsettings.json, indicando que es opcional su existencia. Posteriormente se, carga el fichero appsettings correspondiente al entorno de ejecución definido en una variable de entorno llamada ASPNETCORE_ENVIRONMENT o, en su defecto Production, que, en caso de contener variables ya cargadas anteriormente las sobreescribiría. Por último, se define un HostBuilder al que se le indica que levante el fichero que contiene la clase Startup que corresponde a Startup.cs

public static IConfiguration Configuration { get; } = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production"}.json", optional: true)
    .AddEnvironmentVariables()
    .Build();
 
public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
         .ConfigureWebHostDefaults(webBuilder =>
         {
             webBuilder
                 .UseContentRoot(Directory.GetCurrentDirectory())
                 .UseStartup<Startup>();
         });

Agregar el código con los ficheros y otros orígenes de configuración en .Net 6

Con el nuevo Program.cs, aunque el concepto es el mismo, la forma de trabajar es algo diferente. Vamos a analizar el código antes de ver cómo añadir los orígenes de configuración.

Tenemos una variable llamada builder que es la encargada de inicializar el constructor de la aplicación con los valores por defecto, en caso de que no se especifique lo contrario. Por lo tanto, la aplicación cargará el fichero appsettings.json y su variante appsettings.Development.json si estamos depurando. Pero, ¿qué ocurre si queremos cambiar este comportamiento y añadir nuevos ficheros?

Teniendo en cuenta que ya disponemos de un builder, sólo será necesario indicarle que debe cargar la configuración de la forma que queremos. Para ello, crearenos un ConfigurationBuilder donde establezcamos el orden como hacíamos en versiones anteriores de .Net

var configBuilder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production"}.json", optional: true)
    .AddEnvironmentVariables()
    .Build();

builder.WebHost.UseConfiguration(configBuilder);

if (!builder.Environment.IsDevelopment())
{
    builder.Configuration.AddAzureAppConfiguration(options =>
    {
        options.Connect(builder.Configuration["AzureAppConfigurationUri"])
            .Select(KeyFilter.Any, null)
            .Select(KeyFilter.Any, "MY_APP_LABEL")
            .ConfigureRefresh(refresh =>
            {
                refresh.Register("Sentinel", refreshAll: true)
                    .SetCacheExpiration(new TimeSpan(0, 10, 0));
            });
    });
}