Implementación de Azure Cosmos DB y Azure App Service con una aplicación web desde GitHub con una plantilla de Azure Resource Manager

SE APLICA A: SQL API

En este tutorial se muestra cómo realizar una implementación "sin tocar" de una aplicación web que se conecta a Azure Cosmos DB en la primera ejecución sin tener que cortar y pegar la información de conexión de Azure Cosmos DB a appsettings.json o a la configuración de Azure App Service en el Azure Portal. Todas estas acciones se realizan con una plantilla de Azure Resource Manager en una sola operación. En el siguiente ejemplo, se implementará la muestra de Azure Cosmos DB ToDo desde un tutorial de aplicación Web.

Las plantillas de Resource Manager son bastante flexibles y permiten crear implementaciones complejas en cualquier servicio de Azure. Esto incluye tareas avanzadas, como la implementación de aplicaciones desde GitHub y la inserción de información de conexión en la configuración de la aplicación de Azure App Service en el Azure Portal. En este tutorial se muestra cómo realizar las siguientes acciones con una sola plantilla de Resource Manager.

  • Implementar una cuenta de Azure Cosmos.
  • Implementar un plan de hospedaje de Azure App Service.
  • Implementar un Azure App Service.
  • Insertar el punto de conexión y las claves de la cuenta de Azure Cosmos en la configuración de la aplicación App Service en el Azure Portal.
  • Implementar una aplicación web desde un repositorio de GitHub en el App Service.

La implementación resultante tiene una aplicación web totalmente funcional que puede conectarse a Azure Cosmos DB sin tener que cortar y pegar la dirección URL del punto de conexión del Azure Cosmos DB o las claves de autenticación de la Azure Portal.

Requisitos previos

Sugerencia

Aunque en este tutorial no se exige experiencia con plantillas de Azure Resource Manager o JSON, si quiere modificar las plantillas o las opciones de implementación a las que se hace referencia, entonces sí es necesario tener conocimientos sobre cada una de estas áreas.

Paso 1: Implementación de la plantilla

En primer lugar, seleccione el botón Implementar en Azure para abrir el Azure Portal para crear una implementación personalizada. También puede ver la plantilla de Azure Resource Manager en la Galería de plantillas de inicio rápido de Azure.

Implementación en Azure

Una vez en el Azure Portal, seleccione la suscripción en la que desea realizar la implementación y seleccione o cree un nuevo grupo de recursos. Después, rellene los siguientes valores.

Captura de pantalla de la interfaz de usuario de implementación de plantillas

  • Región: es necesario para el Resource Manager. Escriba la misma región utilizada por el parámetro de ubicación donde se encuentran los recursos.
  • Nombre de la aplicación: todos los recursos de esta implementación usan este nombre. Asegúrese de elegir un nombre único para evitar conflictos con las cuentas de App Service y Azure Cosmos DB existentes.
  • Ubicación: la región donde se implementan los recursos.
  • El plan de tarifa de App Service: plan de tarifa de plan de App Service.
  • Instancias de plan de App Service: el número de trabajadores para el plan de App Service.
  • URL del repositorio: el repositorio a la aplicación web en GitHub.
  • Rama: la rama para el repositorio de GitHub.
  • Nombre de la base de datos: nombre de la base de datos de Azure Cosmos.
  • Nombre del contenedor: el nombre del contenedor de Cosmos de Azure.

Después de rellenar los valores, seleccione el botón Crear para iniciar la implementación. Este paso debe completarse entre 5 y 10 minutos.

Sugerencia

La plantilla no valida que el nombre del Azure App Service y el nombre de la cuenta de Azure Cosmos especificado en la plantilla sean válidos y estén disponibles. Es muy recomendable comprobar la disponibilidad de los nombres que planea suministrar antes de enviar la implementación.

Paso 2: Explorar los recursos

Ver los recursos implementados

Después de que la plantilla haya implementado los recursos, ahora puede ver cada uno de ellos en el grupo de recursos.

Grupo de recursos

Ver el punto de conexión y las claves de Cosmos DB

Después, abra la cuenta de Azure Cosmos en el portal. En la siguiente captura de pantalla se muestra el punto de conexión y las claves de una cuenta de Azure Cosmos.

Claves de Cosmos

Vea las claves de Azure Cosmos DB en la configuración de la aplicación

Después, vaya al Azure App Service del grupo de recursos. Haga clic en la pestaña Configuración para ver la configuración de la aplicación para el App Service. La Configuración de la aplicación contiene la cuenta Cosmos DB y los valores de clave principal necesarios para conectarse a Cosmos DB así como los nombres de base de datos y contenedor que se pasaron desde la implementación de plantilla.

Configuración de la aplicación

Vea la aplicación web en el centro de implementación

Después, vaya al centro de implementación para el App Service. Aquí verá los puntos del repositorio en el repositorio de GitHub que se pasan a la plantilla. Además, el siguiente estado indica Éxito (Activo), lo que significa que la aplicación se implementó e inició correctamente.

Centro de implementación

Ejecución de la aplicación web

Haga clic en Examinar en la parte superior del Centro de implementación para abrir la aplicación web. La aplicación web se abrirá en la pantalla principal. Haga clic en Crear nuevo y escriba algunos datos en los campos y haga clic en Guardar. La pantalla resultante muestra los datos guardados en Cosmos DB.

Pantalla principal

Paso 3: ¿Cómo funciona?

Hay tres elementos necesarios para que funcione.

Lectura de la configuración de la aplicación en tiempo de ejecución

En primer lugar, la aplicación necesita solicitar el Cosmos DB un punto de conexión y la clave en la clase Startup de la aplicación web MVC de ASP.NET. La Muestra de Cosmos To Do se puede ejecutar localmente, donde puede especificar la información de conexión en appsettings.json. Pero cuando se implementa, este archivo se implementa con la aplicación. Si estas líneas de color rojo no pueden tener acceso a la configuración de appsettings.json, se intentará desde la configuración de la aplicación en Azure App Service.

Captura de pantalla que muestra un método con varias variables de tipo string marcadas en rojo, como databaseName, containerName, account y key.

Uso de funciones especiales de administración de recursos de Azure

Para que estos valores estén disponibles para la aplicación cuando se implementa, la plantilla de Azure Resource Manager puede solicitar esos valores de la cuenta de Cosmos DB al usar funciones especiales de Azure Resource Management que incluyen referencia y listKeys que tome los valores de la cuenta de Cosmos DB e insértelos en los valores de configuración de la aplicación con nombres de clave que coincidan con lo que se usa en la aplicación anterior en un formato "{section:key}". Por ejemplo, CosmosDb:Account.

Claves de plantilla

Implementación de aplicaciones web desde GitHub

Por último, es necesario implementar la aplicación web desde GitHub en el App Service. Esto se hace con el siguiente código JSON. Dos aspectos que se deben tener en consideración son el tipo y el nombre de este recurso. Los valores de propiedad "type": "sourcecontrols" y "name": "web" están codificados y no deben cambiarse.

Implementación desde GitHub

Pasos siguientes

Felicidades. Ha implementado Azure Cosmos DB, Azure App Service y una aplicación web de muestra que tiene automáticamente la información de conexión necesaria para conectarse a Cosmos DB, todo en una sola operación y sin tener que cortar y pegar información confidencial. Con esta plantilla como punto de partida, puede modificarla para implementar sus propias aplicaciones web de la misma manera.