Déployer une application Java EE (Jakarta EE) dans JBoss EAP sur Azure App Service

Effectué

Les étapes de cette unité illustrent comment déployer votre application Java EE dans JBoss EAP sur Azure App Service, et comment se connecter à la base de données. Vous allez en fait exécuter ces étapes dans l’unité suivante.

Créer une application Java EE (Jakarta EE)

Dans ce module, vous allez utiliser un exemple d’application Java EE préparé à l’avance, qui utilise les technologies suivantes :

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

Conseil

La procédure de déploiement présentée ici est plus ou moins la même pour la plupart des applications web Java EE (Jakarta EE).

Configurer le projet d’application pour le déployer sur Azure à l’aide de Maven

Microsoft fournit le plug-in Maven pour Azure App Service afin que vous puissiez déployer vos applications web Java sur Azure App Service. À l’aide de ce plug-in Maven, vous pourrez facilement configurer les paramètres suivants pour votre instance App Service :

Éléments Description
subscriptionID Abonnement Azure pour le déploiement
resourceGroup Nom du groupe de ressources où le conteneur web est déployé
appName Nom de l’instance d’application du conteneur web
pricingTier Sélection de machine virtuelle à exécuter
region Régions où effectuer le déploiement (même emplacement que l’emplacement d’installation de MySQL)
runtime OS Système d’exploitation à exécuter (Linux)
runtime javaVersion Version de la machine virtuelle Java du conteneur web (Java 8)
runtime webContainer Conteneur web (JBoss EAP 7)

Dans ce module, vous déployez une application dans l’environnement JBoss EAP. Sélectionnez Java 8 pour la version Java, et Jbosseap 7.4 pour le conteneur web du runtime.

Générer le package WAR

Vous pouvez utiliser la commande ./mvnw package pour créer un package WAR.

Notes

Si vous le souhaitez, vous pouvez tester le package en le déployant dans un environnement JBoss EAP local.

Déployer l’application Java EE dans JBoss EAP

Après avoir créé votre artefact Maven, vous pouvez exécuter la commande deploy dans le plug-in Maven pour Azure App Service en vue de déployer l’application dans JBoss EAP.

La commande deploy crée un groupe de ressources Azure et une instance de JBoss EAP en fonction des paramètres de plug-in mentionnés précédemment. À elle seule, cette commande effectue toutes les opérations, de la création des instances au déploiement de l’application web Java.

Pour obtenir la liste complète des configurations, consultez la documentation de référence sur le plug-in. Tous les plug-ins Azure Maven partagent un jeu commun de configurations. Pour ces configurations, consultez Configurations courantes. Pour les configurations spécifiques à App Service, consultez Application web Azure : détails de configuration.

Configurer une connexion de base de données à l’aide d’une source de données et de JNDI

Votre application nécessite une liaison à une source de données. Nous allons configurer l’application pour qu’elle utilise la base de données MySQL que nous avons créée dans les unités précédentes.

Pour vous connecter à la base de données à partir de JBoss EAP, vous devez configurer un objet DataSource. Quand vous configurez un objet DataSource, vous permettez à une application de se connecter à la base de données.

Vous allez configurer DataSource afin de vous connecter à l’instance Azure Database pour MySQL que vous avez créée précédemment avec les informations suivantes :

Configuration de la source de données valeur
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

Nous avons utilisé un nom JNDI (Java Naming and Directory Interface) de java:jboss/datasources/JPAWorldDataSource pour la source de données. JNDI est utile dans plusieurs environnements pour passer à une autre base de données sans modification du code.

Accéder à l’application

Une fois que vous avez configuré la connexion à la source de données MySQL dans JBoss EAP, vous pouvez accéder à l’application Java EE à l’aide d’un navigateur web ou de la commande curl.

Dans l’unité suivante, vous allez déployer l’exemple d’application à l’aide de la procédure décrite ici.