Adición de Azure App Configuration mediante Servicios conectados de Visual Studio
En este tutorial, aprenderá a agregar fácilmente todo lo que necesita para empezar a usar Azure App Configuration para administrar la configuración y las marcas de características para proyectos web en Visual Studio. Gracias a la característica Servicios conectados de Visual Studio, esta aplicación puede agregar automáticamente todo el código, las opciones de configuración y los paquetes de NuGet que necesita para conectarse al recurso de App Configuration en Azure. Para usar esta característica, debe usar Visual Studio 2019, versión 16.9 o posterior.
La característica Servicios conectados de App Configuration se puede usar en los siguientes tipos de proyecto:
- ASP.NET Core
- Consola de .NET Core
- Proyectos de .NET Framework.
Requisitos previos
- Visual Studio (consulte [Descargas de Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) con la carga de trabajo Desarrollo de Azure instalada.
- Un proyecto de uno de los tipos admitidos
- Una cuenta de Azure. Si no tiene una cuenta de Azure, active las ventajas de Azure para suscriptores de Visual Studio o regístrese para obtener una evaluación gratuita.
Conexión a Azure App Configuration mediante Servicios conectados
Abra el proyecto en Visual Studio.
En el Explorador de soluciones, haga clic con el botón derecho en el nodo Servicios conectados y, en el menú contextual, seleccione Agregar servicio conectado.
En la pestaña Servicios conectados, seleccione el icono + de Dependencias de servicio.
En la página Agregar dependencia, seleccione Azure App Configuration.
Si aún no ha iniciado sesión en su cuenta de Azure, hágalo ahora. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita.
En la pantalla Configurar Azure App Configuration, seleccione la suscripción y un almacén de configuración existente. Luego, seleccione Siguiente.
Si necesita crear un almacén de App Configuration, vaya al paso siguiente. De lo contrario, vaya al paso 6.
Para crear un almacén de configuración de aplicaciones:
Seleccione el icono + situado a la derecha del encabezado Almacenes de App Configuration.
Rellene el cuadro de diálogo Azure App Configuration: Crear nuevo y seleccione Crear. Tenga en cuenta que el campo Nombre del recurso debe ser único.
Cuando se muestra el cuadro de diálogo Azure App Configuration, el nuevo almacén de configuración aparece en la lista. Seleccione este nuevo almacén y, a continuación, seleccione Siguiente.
Escriba un nombre de cadena de conexión y elija si desea que la cadena de conexión se almacene en un archivo de secretos local o en Azure Key Vault.
En la pantalla Resumen de cambios se muestran todas las modificaciones que se realizarán en el proyecto si completa el proceso. Si los cambios parecen correctos, seleccione Finalizar.
Una vez finalizado el proceso de configuración de dependencias, Azure App Configuration aparece ahora en el nodo Dependencias de servicio del proyecto.
Abra el proyecto en Visual Studio.
En el Explorador de soluciones, haga clic con el botón derecho en el nodo Servicios conectados y, en el menú contextual, seleccione Agregar para abrir el menú de servicios disponibles.
Elija Azure App Configuration. Aparece la página Conectarse a la dependencia.
Si aún no ha iniciado sesión en su cuenta de Azure, hágalo ahora. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita.
En la pantalla Configurar Azure App Configuration, seleccione la suscripción y un almacén de configuración existente. Luego, seleccione Siguiente.
Si necesita crear un almacén de App Configuration, vaya al paso siguiente. De lo contrario, vaya al paso 6.
Para crear un almacén de configuración de aplicaciones:
Seleccione el icono + situado a la derecha del encabezado Almacenes de App Configuration.
Rellene el cuadro de diálogo Azure App Configuration: Crear nuevo y seleccione Crear. Tenga en cuenta que el campo Nombre del recurso debe ser único.
Cuando se muestra el cuadro de diálogo Azure App Configuration, el nuevo almacén de configuración aparece en la lista. Seleccione este nuevo almacén y, a continuación, seleccione Siguiente.
Escriba un nombre de cadena de conexión y elija si desea que la cadena de conexión se almacene en un archivo de secretos local o en Azure Key Vault.
En la pantalla Resumen de cambios se muestran todas las modificaciones que se realizarán en el proyecto si completa el proceso. Si los cambios parecen correctos, seleccione Finalizar.
Una vez finalizado el proceso de configuración de dependencias, Azure App Configuration aparece ahora en el nodo Dependencias de servicio del proyecto.
En Explorador de soluciones, haga doble clic en el nodo Servicios conectados para abrir la pestaña Servicios conectados. La conexión aparece en la sección Dependencias del servicio:
También hay una entrada Secrets.json que admite el almacenamiento seguro de la cadena de conexión localmente. Para saber cómo funciona, consulte Captura de pantalla que muestra el almacenamiento seguro de secretos de la aplicación en desarrollo en ASP.NET Core.
Si hace clic en los puntos suspendidos situados junto a las dependencias que agregó, puede ver varias opciones, como Conectar para volver a abrir el asistente y cambiar la conexión, y para Secrets.json, la opción para administrar secretos. También puede hacer clic en los tres puntos situados en la parte superior derecha de la ventana para ver las opciones para iniciar dependencias locales, cambiar la configuración, etc.