Inicio rápido: Integración de Azure Spring Apps con Azure Database for MySQL

Nota:

Azure Spring Apps es el nuevo nombre del servicio Azure Spring Cloud. Aunque el servicio tiene un nuevo nombre, verá el nombre antiguo en algunos lugares durante un tiempo mientras trabajamos para actualizar recursos, como capturas de pantalla, vídeos y diagramas.

Este artículo se aplica a: ✔️ Nivel Básico o Estándar ❌ Nivel Enterprise

Pet Clinic, como se implementa en la configuración predeterminada del Inicio rápido: Compilación e implementación de aplicaciones en Azure Spring Apps, usa una base de datos en memoria (HSQLDB) que se rellena con datos al inicio. En este inicio rápido se explica cómo aprovisionar y preparar una instancia de Azure Database for MySQL y, luego, configurar Pet Clinic en Azure Spring Apps para usarla como una base de datos persistente.

Requisitos previos

Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

Creación de una instancia de Azure Database for MySQL

Cree un servidor flexible Azure Database for MySQL mediante el comando az mysql flexible-server create. Reemplace los marcadores de posición <database-name>, <resource-group-name>, <MySQL-flexible-server-name>, <admin-username> y <admin-password> por el nombre de la nueva base de datos, el nombre del grupo de recursos, el nombre del nuevo servidor y el nombre de usuario y la contraseña de administrador. Use comillas simples alrededor del valor para admin-password.

az mysql flexible-server create \
    --resource-group <resource-group-name> \
    --name <MySQL-flexible-server-name> \
    --database-name <database-name> \
    --public-access 0.0.0.0 \
    --admin-user <admin-username> \
    --admin-password '<admin-password>'

Nota

El SKU Standard_B1ms se usa de manera predeterminada. Para más información sobre los precios, consulte Precios de Azure Database for MySQL.

Sugerencia

La contraseña debe tener al menos ocho caracteres y una letra mayúscula y otra minúscula en inglés, un número y un carácter no alfanumérico (como !, $, #, %).

Conexión de la aplicación a la base de datos MySQL

Use Service Connector para conectar la aplicación hospedada en Azure Spring Apps a la base de datos MySQL.

Nota

La característica de enlace de servicio en Azure Spring Apps está en desuso en favor de Service Connector.

CLI de Azure

1. Si usa Service Connector por primera vez, empiece ejecutando el comando az provider register para registrar el proveedor de recursos de Service Connector.

   az provider register --namespace Microsoft.ServiceLinker
   

2. Ejecute el comando az spring connection create para crear una conexión de servicio entre la aplicación customers-service y Azure MySQL Database. Reemplace los marcadores de posición para la siguiente configuración por su propia información. Use comillas simples alrededor del valor para el secret del servidor MySQL.

   Configuración	Descripción
   --connection	El nombre de conexión que identifica la conexión entre la aplicación y el servicio de destino.
   --resource-group	Nombre del grupo de recursos que contiene una aplicación hospedada por Azure Spring Apps.
   --service	Nombre del recurso de Azure Spring Apps.
   --app	Nombre de la aplicación hospedada por Azure Spring Apps que se conecta al servicio de destino.
   --target-resource-group	Nombre del grupo de recursos con la cuenta de almacenamiento.
   --server	Servidor MySQL al que desea conectarse.
   --database	Nombre de la base de datos que creó anteriormente.
   --secret name= secret=	Nombre de usuario y contraseña del servidor MySQL.

   az spring connection create mysql-flexible \
       --resource-group <Azure-Spring-Apps-resource-group-name> \
       --service <Azure-Spring-Apps-resource-name> \
       --app customers-service \
       --connection <mysql-connection-name-for-app> \
       --target-resource-group <mySQL-server-resource-group> \
       --server <server-name> \
       --database <database-name> \
       --secret name=<username> secret='<secret>'
   

   Sugerencia

   Si el sistema no reconoce el comando az spring, compruebe que ha instalado la extensión de Azure Spring Apps mediante la ejecución de az extension add --name spring.

Azure Portal

1. En Azure Portal, escriba el nombre de la instancia de Azure Spring Apps en el cuadro de búsqueda de la parte superior de la pantalla y seleccione la instancia.

2. En Configuración, seleccione Aplicaciones y, a continuación, seleccione la aplicación customers-service en la lista.

3. Seleccione Service Connector en la tabla de contenido de la izquierda y seleccione Crear.

   

4. Seleccione o escriba la siguiente configuración en la tabla.

   Configuración	Ejemplo	Descripción
   Tipo de servicio.	DB for MySQL: servidor flexible	Seleccione DB for MySQL: servidor flexible como servicio de destino.
   Nombre de la conexión	mysql_9e8af	El nombre de conexión que identifica la conexión entre la aplicación y el servicio de destino. Use el nombre de conexión proporcionado por Service Connector o introduzca su propio nombre de conexión.
   Suscripción	Mi suscripción	Suscripción que contiene el servicio de destino. El valor predeterminado es la suscripción que contiene la aplicación implementada en Azure Spring Apps.
   Servidor flexible de MySQL	MySQL80	Seleccione el servidor flexible de MySQL al que desea conectarse.
   Base de datos de MySQL	petclinic	Seleccione la base de datos que creó anteriormente.
   Tipo de cliente	SpringBoot	Seleccione la pila de aplicación que funciona con el servicio de destino que ha seleccionado.

   

5. Seleccione Siguiente: Autenticación para seleccionar el tipo de autenticación. A continuación, seleccione Cadena de conexión > Credenciales de base de datos y escriba el nombre de usuario y la contraseña de su base de datos.

6. Seleccione Siguiente: Redes para seleccionar la configuración de red y Configurar reglas de firewall para habilitar el acceso al servicio de destino. Escriba el nombre de usuario y la contraseña para que la aplicación pueda acceder a la base de datos.

7. Seleccione Siguiente: Revisar y crear para revisar la información proporcionada. Espere unos segundos para que el conector de servicio valide la información y seleccione Crear para crear la conexión de servicio.

Repita estos pasos para crear conexiones para las aplicaciones customers-service, vets-service y visits-service.

Comprobación de la conexión a la base de datos MySQL

CLI de Azure

Ejecute el comando az spring connection validate para mostrar el estado de la conexión entre la aplicación customers-service y Azure MySQL Database. Reemplace los marcadores de posición por su propia información.

az spring connection validate \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --app customers-service \
    --connection <mysql-connection-name-for-app> \
    --output table

Se muestra el siguiente resultado:

Name                                  Result    Description
------------------------------------  --------  -------------
Target resource existence validated.  success
Target service firewall validated.    success
Username and password validated.      success

Sugerencia

Para más detalles sobre la conexión entre los servicios, quite --output table del comando anterior.

Azure Portal

Las conexiones de Azure Spring Apps se muestran en Configuración > Conector de servicio. Seleccione Validar para realizar la comprobación del estado de la conexión y seleccione Más información para revisar los detalles de validación de la conexión.

Repita estas instrucciones para validar las conexiones para las aplicaciones customers-service, vets-service y visits-service.

Actualización de las aplicaciones para usar el perfil de MySQL

En la sección siguiente se explica cómo actualizar las aplicaciones para conectarse a MySQL Database.

CLI de Azure

Use el siguiente comando para establecer una variable de entorno para activar el perfil de mysql para la aplicación customers-service:

az spring app update \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --name customers-service \
    --env SPRING_PROFILES_ACTIVE=mysql

Azure Portal

Use los siguientes pasos para establecer una variable de entorno para activar el perfil de mysql para la aplicación customers-service:

1. Vaya a la página de información general de la instancia de Azure Spring Apps, seleccione Aplicaciones en el menú de navegación y, a continuación, seleccione la aplicación customers-service de la lista.

2. En la página Información general del servicio de clientes, seleccione Configuración en el menú de navegación.

3. En la página Configuración, seleccione Variables de entorno. Escriba SPRING_PROFILES_ACTIVE en Clave, escriba mysql en Valor y seleccione Guardar.

   

Repita estas instrucciones para actualizar la configuración de la aplicación para las aplicaciones customers-service, vets-service y visits-service.

Validación de las aplicaciones

Para validar el servicio Pet Clinic y consultar registros de MySQL Database para confirmar la conexión de la base de datos, siga las instrucciones de la sección Comprobación de los servicios de Inicio rápido: Compilación e implementación de aplicaciones en Azure Spring Apps.

Limpieza de recursos

Si planea seguir trabajando en otros inicios rápidos y tutoriales, considere la posibilidad de dejar estos recursos activos. Cuando ya no sea necesario, elimine el grupo de recursos mediante el comando az group delete, que elimina los recursos del grupo de recursos. Reemplace <resource-group> por el nombre del grupo de recursos.

az group delete --name <resource-group>

Pasos siguientes

• Enlace de una instancia de Azure Database for MySQL con una aplicación en Azure Spring Apps
• Uso de una identidad administrada para conectar Azure SQL Database a una aplicación en Azure Spring Apps