Inicio rápido: Crear una aplicación .NET con App Configuration

Artículo
04/08/2024

En este inicio rápido incorporará Azure App Configuration a una aplicación de consola de .NET para centralizar el almacenamiento y la administración de 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.
SDK de .NET 6.0 o posterior: también disponible en Azure Cloud Shell.

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 consola de .NET

Puede usar la interfaz de la línea de comandos (CLI) de .NET para crear un proyecto de aplicación de consola de .NET. La ventaja de usar la CLI de .NET frente a Visual Studio es que está disponible en las plataformas Windows, macOS y Linux. También puede usar las herramientas preinstaladas disponibles en Azure Cloud Shell.

Cree una carpeta nueva para su proyecto.
En la nueva carpeta, ejecute el siguiente comando para crear un nuevo proyecto de aplicación de la consola de .NET:
```
dotnet new console
```

Conexión a un almacén de App Configuration

Para agregar una referencia al paquete NuGet Microsoft.Extensions.Configuration.AzureAppConfiguration, ejecute el comando siguiente:
```
dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
```
Ejecute el siguiente comando para restaurar los paquetes para el proyecto:
```
dotnet restore
```

Abra el archivo Program.cs y agregue las siguientes instrucciones:

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

Use App Configuration Actualice mediante la llamada al método AddAzureAppConfiguration en el archivo Program.cs.

var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));

var config = builder.Build();
Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");

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

Establezca una variable de entorno llamada ConnectionString y defínala como la clave de acceso a su almacén de App Configuration. En la línea de comandos, ejecute el siguiente comando:
Para compilar y ejecutar la aplicación de forma local mediante el símbolo del sistema de Windows, ejecute el siguiente comando:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Reinicie el símbolo del sistema para permitir que el cambio surta efecto. Imprima el valor de la variable de entorno para comprobar que se ha establecido correctamente.
Si usa Windows PowerShell, ejecute el siguiente comando:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Si usa macOS, ejecute el siguiente comando:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Si usa Linux, ejecute el siguiente comando:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Ejecute el siguiente comando para compilar la aplicación de consola:
```
dotnet build
```
Una vez que la compilación se haya realizado correctamente, ejecute el siguiente comando para ejecutar la aplicación localmente:
```
dotnet run
```

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.

Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
Seleccione Eliminar grupo de recursos.
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 consola de .NET a través del proveedor de App Configuration. Para aprender a configurar una aplicación de .NET para actualizar dinámicamente la configuración, vaya al siguiente tutorial.

Habilitación de la configuración dinámica