Implementación de una aplicación de Java EE (Jakarta EE) en JBoss EAP en Azure App Service

Completado

Los pasos de esta unidad muestran cómo implementar la aplicación de Java EE en JBoss EAP en Azure App Service y cómo conectarse a la base de datos. En realidad, ejecutará estos pasos en la unidad siguiente.

Creación de una aplicación de Java EE (Jakarta EE)

En este módulo, usará una aplicación de Java EE de ejemplo que se ha preparado con antelación y en la que se utilizan las tecnologías siguientes:

  • Java EE 8 (Jakarta EE 8)
  • JAX-RS 2.1
  • JSON-B 1.0
  • CDI 2.0
  • JPA 2.2

Sugerencia

El procedimiento de implementación que se presenta aquí es similar a la mayoría de las aplicaciones web de Java EE (Jakarta EE).

Configuración del proyecto de aplicación para la implementación en Azure mediante Maven

Microsoft proporciona el complemento Maven para Azure App Service a fin de implementar las aplicaciones web de Java en Azure App Service. Con este complemento de Maven, puede configurar fácilmente las opciones siguientes para la instancia de App Service:

Elementos Descripción
subscriptionID Suscripción de Azure para la implementación
resourceGroup Nombre del grupo de recursos donde se ha implementado el contenedor web
appName Nombre de la instancia de la aplicación para el contenedor web
pricingTier Selección de la máquina virtual que se va a ejecutar
region Región para implementar (la misma ubicación de la instalación de MySQL)
runtime OS Sistema operativo para ejecutar (Linux)
runtime javaVersion Versión de la máquina virtual Java para el contenedor web (Java 8)
runtime webContainer Contenedor web (JBoss EAP 7)

En este módulo, implementará una aplicación en el entorno de JBoss EAP. Seleccione Java 8 para la versión de Java y Jbosseap 7.4 para el contenedor web de tiempo de ejecución.

Creación del paquete WAR

Puede usar el comando ./mvnw package para compilar un paquete de archivo de aplicación web (WAR).

Nota:

Opcionalmente, puede probar el paquete mediante la implementación en un entorno de JBoss EAP local.

Implementación de la aplicación de Java EE en JBoss EAP

Después de crear el artefacto de Maven, puede ejecutar el comando deploy del complemento Maven para Azure App Service a fin de implementar la aplicación en JBoss EAP.

El comando deploy crea un grupo de recursos de Azure y una instancia de JBoss EAP en función de la configuración del complemento anterior. Este único comando se encarga de todo, desde la creación de instancias hasta la implementación de la aplicación web de Java.

Para obtener la lista completa de configuraciones, consulte la documentación de referencia del complemento. Todos los complementos de Azure Maven comparten un conjunto común de configuraciones. Para ver estas configuraciones, consulte Configuraciones comunes. Para conocer las configuraciones específicas de App Service, consulte Aplicación web de Azure: Detalles de configuración.

Configuración de una conexión de base de datos mediante un origen de datos y JNDI

La aplicación necesitará un enlace a un origen de datos. Se configurará la aplicación para que use la base de datos MySQL que se ha creado en las unidades anteriores.

Para conectarse a la base de datos desde JBoss EAP, tendrá que configurar un objeto DataSource. Al configurar un objeto DataSource, una aplicación se puede conectar a la base de datos.

Configurará DataSource para conectarse a la instancia de Azure Database for MySQL que ha creado antes con la siguiente información:

Configuración del origen de datos value
DataSource Name JPAWorldDataSourceDS
JNDI Name java:jboss/datasources/JPAWorldDataSource
Connection URL ${MYSQL_CONNECTION_URL}
JDBC Driver Name $PACKAGE_NAME.war_com.mysql.cj.jdbc.Driver_8_0
User Name ${MYSQL_USER}
Password ${MYSQL_PASSWORD}
Minimum Pool Size 5
Maximum Pool Size 20
JDBC Class Name com.mysql.cj.jdbc.Driver

Para el origen de datos se ha usado un nombre de interfaz de directorios y nomenclatura de Java (JNDI) de java:jboss/datasources/JPAWorldDataSource. JNDI es útil en varios entornos para cambiar a otra base de datos sin modificar el código.

Acceso a la aplicación

Después de configurar la conexión de origen de datos de MySQL en JBoss EAP, puede acceder a la aplicación de Java EE mediante un explorador web o el comando curl.

En la unidad siguiente, implementará la aplicación de ejemplo mediante el procedimiento que se describe aquí.