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.

Nota

Este tema se aplica a Visual Studio para Windows. En Visual Studio para Mac, vea Servicios conectados en Visual Studio para Mac.

Requisitos previos

Conexión a Azure App Configuration mediante Servicios conectados

  1. Abra el proyecto en Visual Studio.

  2. 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.

    Screenshot showing

  3. En la pestaña Servicios conectados, seleccione el icono + de Dependencias de servicio.

    Screenshot showing

  4. En la página Agregar dependencia, seleccione Azure App Configuration.

    Screenshot showing

    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.

  5. 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.

    Screenshot showing

  6. Para crear un almacén de configuración de aplicaciones:

    1. Seleccione el icono + situado a la derecha del encabezado Almacenes de App Configuration.

    2. 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.

      Screenshot showing New Azure app config store.

    3. 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.

  7. 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.

    Screenshot showing

  8. 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.

    Screenshot showing summary of changes.

  9. Una vez finalizado el proceso de configuración de dependencias, Azure App Configuration aparece ahora en el nodo Dependencias de servicio del proyecto.

  1. Abra el proyecto en Visual Studio.

  2. 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.

    Screenshot showing Connected Services context menu options.

  3. Elija Azure App Configuration. Aparece la página Conectarse a la dependencia.

    Screenshot showing Connect to dependency for 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.

  4. 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.

    Screenshot showing 'Add existing configuration account to project

  5. Para crear un almacén de configuración de aplicaciones:

    1. Seleccione el icono + situado a la derecha del encabezado Almacenes de App Configuration.

    2. 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.

      Screenshot showing new Azure app config store.

    3. 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.

  6. 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.

    Screenshot showing

  7. 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.

    Screenshot showing summary of changes.

    Una vez finalizado el proceso de configuración de dependencias, Azure App Configuration aparece ahora en el nodo Dependencias de servicio del proyecto.

  8. 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:

    Screenshot of Service Dependencies section showing Azure App Configuration connection.

    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.