Inicio rápido: Creación de una aplicación ASP.NET Core con Azure App Configuration

En este inicio rápido usará Azure App Configuration para centralizar el almacenamiento y la administración de la configuración de la aplicación de una aplicación de ASP.NET Core. ASP.NET Core genera un solo objeto de configuración basado en un par clave-valor mediante el uso de la configuración de uno o varios orígenes de datos especificados por una aplicación. Estos orígenes de datos se conocen como proveedores de configuración. Dado que el cliente .NET Core de App Configuration se implementa como un proveedor de configuraciones, el servicio parece como cualquier otro origen de datos.

Prerrequisitos

• Una suscripción a Azure: cree una cuenta gratuita
• SDK de .NET Core

Creación de un almacén de App Configuration

1. Para crear un almacén de App Configuration, inicie sesión en Azure Portal. En la esquina superior izquierda de la página principal, seleccione Crear un recurso. En el cuadro Buscar en Marketplace, escriba App Configuration y presione Entrar.

   

2. Seleccione Configuración de la aplicación en los resultados de la búsqueda y, después, Crear.

   

3. En el panel Crear de App Configuration, introduzca la siguiente configuración:

   Configuración	Valor sugerido	Descripción
   Suscripción	Su suscripción	Seleccione la suscripción de Azure que desee usar para probar App Configuration. Si su cuenta solo tiene una suscripción, se selecciona automáticamente y la lista Suscripción no aparece.
   Grupos de recursos	AppConfigTestResources	Seleccione o cree un grupo de recursos para el recurso del almacén de App Configuration. Este grupo es útil para organizar los distintos recursos que quiera eliminar al mismo tiempo mediante la eliminación del grupo de recursos. Para más información, consulte Administración de los recursos de Azure a través del Portal.
   Nombre del recurso	Nombre único globalmente	Escriba un nombre de recurso único para usarlo como recurso de almacén de App Configuration. El nombre debe ser una cadena de entre 5 y 50 caracteres y solo puede contener números, letras y el carácter -. El nombre no puede comenzar ni terminar con el carácter -.
   Ubicación	Centro de EE. UU.	Use Ubicación para especificar la ubicación geográfica en la que se hospeda el almacén de App Configuration. Para optimizar el rendimiento, cree el recurso en la misma región que los demás componentes de la aplicación.
   Plan de tarifa	Gratis	Seleccione el plan de tarifa deseado. Para más información, consulte la página de precios de App Configuration.

4. Seleccione Revisar y crear para validar la configuración.

5. Seleccione Crear. La implementación puede tardar unos minutos.

6. Una vez finalizada la implementación, vaya al recurso de App Configuration. Seleccione Configuración > Claves de acceso. Tome nota de la cadena de conexión de la clave de solo lectura principal. Usará esta cadena de conexión más adelante para configurar la aplicación y que se comunique con el almacén de Azure App Configuration que ha creado.

7. Seleccione Operaciones > Explorador de configuración > Crear > Clave-valor para agregar los siguientes pares clave-valor:

   Clave	Value
   TestApp:Settings:BackgroundColor	#FFF
   TestApp:Settings:FontColor	#000
   TestApp:Settings:FontSize	24
   TestApp:Settings:Message	Datos de Azure App Configuration

   Deje Etiqueta y Tipo de contenido en blanco, por ahora. Seleccione Aplicar.

Cree una aplicación web ASP.NET Core

Utilice la interfaz de la línea de comandos (CLI) de .NET Core para crear un proyecto de ASP.NET Core MVC. Azure Cloud Shell proporciona estas herramientas. También están disponibles en las plataformas Windows, macOS y Linux.

Ejecute el siguiente comando para crear un proyecto de ASP.NET Core MVC en una nueva carpeta TestAppConfig:

dotnet new mvc --no-https --output TestAppConfig

Incorporación de Secret Manager

Una herramienta denominada Administrador de secretos almacena información confidencial para el trabajo de desarrollo fuera de su árbol de proyecto. Este enfoque ayuda a evitar el uso compartido accidental de secretos de la aplicación en el código fuente. Complete los pasos siguientes para habilitar el uso del Administrador de secretos en el proyecto de ASP.NET Core:

dotnet user-secrets init

<Project Sdk="Microsoft.NET.Sdk.Web">
    
    <PropertyGroup>
        <TargetFramework>net5.0</TargetFramework>
        <UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId>
    </PropertyGroup>

</Project>

dotnet user-secrets init

<Project Sdk="Microsoft.NET.Sdk.Web">
    
    <PropertyGroup>
        <TargetFramework>netcoreapp3.1</TargetFramework>
        <UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId>
    </PropertyGroup>

</Project>

Conexión al almacén de App Configuration

1. Ejecute el siguiente comando para agregar un paquete NuGet Microsoft.Azure.AppConfiguration.AspNetCore de referencia:

   dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
   

2. Ejecute el siguiente comando en el mismo directorio que el archivo .csproj. El comando usa el Administrador de secretos para almacenar un secreto denominado ConnectionStrings:AppConfig, que almacena la cadena de conexión para el almacén de App Configuration. Reemplace el marcador de posición <your_connection_string> por la cadena de conexión del almacén de App Configuration. Puede encontrar la cadena de conexión en Claves de acceso en Azure Portal.

   dotnet user-secrets set ConnectionStrings:AppConfig "<your_connection_string>"
   

   Importante

   Algunos shells truncarán la cadena de conexión, salvo que esté entre comillas. Asegúrese de que la salida del comando dotnet user-secrets list muestra toda la cadena de conexión. Si no lo hace, vuelva a ejecutar el comando y escriba la cadena de conexión entre comillas.

   Secret Manager solo se utiliza para probar la aplicación web localmente. Cuando la aplicación se implementa en Azure App Service, usará el valor de la aplicación configuración de la aplicación Cadenas de conexión en App Service, en lugar de Administrador de secretos para almacenar la cadena de conexión.

   Obtenga acceso a este secreto mediante la API de configuración de .NET Core. Un signo de dos puntos (:) funciona en el nombre de configuración con la API de configuración en todas las plataformas compatibles. Para más información, vea Claves y valores de configuración.

3. En Program.cs, agregue una referencia al espacio de nombres de la API de configuración de .NET Core:

   using Microsoft.Extensions.Configuration;
   

4. Actualice el método CreateWebHostBuilder para usar App Configuration; para ello, llame al método AddAzureAppConfiguration.

   Importante

   CreateHostBuilder reemplaza a CreateWebHostBuilder en .NET Core 3.x. Seleccione la sintaxis correcta en función de su entorno.

   • .NET 5.x
   • .NET Core 3.x
   • .NET Core 2.x

   public static IHostBuilder CreateHostBuilder(string[] args) =>
       Host.CreateDefaultBuilder(args)
           .ConfigureWebHostDefaults(webBuilder =>
               webBuilder.ConfigureAppConfiguration(config =>
               {
                   var settings = config.Build();
                   var connection = settings.GetConnectionString("AppConfig");
                   config.AddAzureAppConfiguration(connection);
               }).UseStartup<Startup>());
   

   Con el cambio anterior, el proveedor de configuración de App Configuration se ha registrado con la API de configuración de .NET Core.

Lectura desde el almacén de App Configuration

Complete los pasos siguientes para leer y mostrar los valores almacenados en el almacén de App Configuration. La API de configuración de .NET Core se usará para tener acceso al almacén. Sintaxis Razor se usará para mostrar los valores de las claves.

Abra el archivo <app root>/Views/Home/Index.cshtml y reemplace el contenido por el código siguiente:

@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<style>
    body {
        background-color: @Configuration["TestApp:Settings:BackgroundColor"]
    }
    h1 {
        color: @Configuration["TestApp:Settings:FontColor"];
        font-size: @Configuration["TestApp:Settings:FontSize"]px;
    }
</style>

<h1>@Configuration["TestApp:Settings:Message"]</h1>

En el código anterior, las claves del almacén de App Configuration se usan como sigue:

• El valor de la clave TestApp:Settings:BackgroundColor se asigna a la propiedad background-color de CSS.
• El valor de la clave TestApp:Settings:FontColor se asigna a la propiedad color de CSS.
• El valor de la clave TestApp:Settings:FontSize se asigna a la propiedad font-size de CSS.
• El valor de la clave TestApp:Settings:Message se muestra como un título.

Compilación y ejecución de la aplicación en un entorno local

1. Para compilar la aplicación mediante la CLI de .NET Core, desplácese hasta el directorio raíz del proyecto. Ejecute el comando siguiente en el shell de comandos:

   dotnet build
   

2. Una vez que la compilación se haya realizado correctamente, ejecute el siguiente comando para ejecutar la aplicación web localmente:

   dotnet run
   

3. Si trabaja en un equipo local, use un explorador para ir a http://localhost:5000. Esta es la dirección URL predeterminada de la aplicación web hospedada localmente. Si trabajando en Azure Cloud Shell, seleccione el botón Vista previa web y después Configurar.

   

   Cuando se le pida que configure el puerto para la versión preliminar, escriba 5000 y seleccione Abrir y examinar. En la página web aparecerá "Data from Azure App Configuration" (Datos de Azure App Configuration).

Limpieza de recursos

Si no desea seguir usando los recursos creados 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 esta guía de inicio rápido:

• Ha aprovisionado un nuevo almacén de App Configuration.
• Ha registrado el proveedor de configuración de .NET Core del almacén de App Configuration.
• Ha leído las claves del almacén de App Configuration con el proveedor de configuración.
• Ha mostrado los valores de la clave del almacén de App Configuration mediante sintaxis Razor.

Para aprender a configurar una aplicación de ASP.NET Core para actualizar dinámicamente la configuración, vaya al siguiente tutorial.