Bereitstellen einer Java EE-Anwendung (Jakarta EE) für JBoss EAP auf Azure App Service

  • 4 Minuten

Anhand der Schritte in dieser Lerneinheit erfahren Sie, wie Sie Ihre Java EE-Anwendung für JBoss EAP in Azure App Service bereitstellen und eine Verbindung mit der Datenbank herstellen. Sie führen diese Schritte erst in der nächsten Lerneinheit tatsächlich aus.

Erstellen einer Java EE-Anwendung (Jakarta EE)

In diesem Modul verwenden Sie eine vorbereitete Java EE-Beispielanwendung, für die folgende Technologien verwendet werden:

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

Tipp

Das hier vorgestellte Bereitstellungsverfahren ist bei den meisten Java EE-Webanwendungen (Jakarta EE) ähnlich.

Konfigurieren des Anwendungsprojekts für die Bereitstellung in Azure mithilfe von Maven

Microsoft bietet das Maven-Plug-In für Azure App Service, um Ihre Java-Webanwendungen in Azure App Service bereitzustellen. Mithilfe dieses Maven-Plug-Ins können Sie die folgenden Einstellungen für Ihre App Service-Instanz ohne großen Aufwand konfigurieren:

Elemente Beschreibung
subscriptionID Azure-Abonnement für die Bereitstellung
resourceGroup Der Name der Ressourcengruppe, in der der Webcontainer bereitgestellt wird
appName Der Name der Anwendungsinstanz für den Webcontainer
pricingTier VM-Auswahl für die Ausführung
region Region für die Bereitstellung (derselbe Standort wie für die Installation von MySQL)
runtime OS Betriebssystem für die Ausführung (Linux)
runtime javaVersion Version der Java-VM für den Webcontainer (Java 8)
runtime webContainer Webcontainer (JBoss EAP 7)

In diesem Modul stellen Sie eine Anwendung in der JBoss EAP-Umgebung bereit. Wählen Sie als Java-Version Java 8 und für den Webcontainer als Runtime Jbosseap 7.4 aus.

Erstellen des WAR-Pakets

Mithilfe des ./mvnw package-Befehls können Sie ein WAR-Paket (Web Application Archive) erstellen.

Hinweis

Wenn Sie möchten, können Sie das Paket testen, indem Sie es in einer lokalen JBoss EAP-Umgebung bereitstellen.

Bereitstellen der Java EE-App für JBoss EAP

Nachdem Sie das Maven-Artefakt erstellt haben, können Sie den Befehl deploy im Maven-Plug-In für Azure App Service ausführen, um die Anwendung für JBoss EAP bereitzustellen.

Mit dem deploy-Befehl wird eine Azure-Ressourcengruppe und eine Instanz von JBoss EAP basierend auf den obigen Plug-In-Einstellungen erstellt. Mit diesem einen Befehl wird alles erledigt – von der Erstellung von Instanzen bis zur Bereitstellung der Java-Webanwendung.

Eine vollständige Liste der Konfigurationen finden Sie in der Dokumentation zur Plug-In-Referenz. Alle Azure Maven-Plug-Ins verwenden einen gemeinsamen Satz von Konfigurationen. Diese Konfigurationen finden Sie unter Allgemeine Konfigurationen. App Service-spezifische Konfigurationen finden Sie unter Azure Web App: Konfigurationsdetails.

Konfigurieren einer Datenbankverbindung mithilfe von JNDI und einer Datenquelle

Für Ihre Anwendung ist eine Bindung an eine Datenquelle erforderlich. Daher konfigurieren Sie die Anwendung für die Verwendung der in den vorherigen Lerneinheiten erstellten MySQL Database-Instanz.

Zum Herstellen einer Verbindung zur Datenbank über JBoss EAP müssen Sie ein DataSource-Objekt konfigurieren. Wenn Sie ein DataSource-Objekt konfigurieren, kann eine Anwendung eine Verbindung zur Datenbank herstellen.

Sie konfigurieren DataSource, um eine Verbindung zur Azure Database for MySQL-Instanz herzustellen, die Sie zuvor erstellt haben. Dazu verwenden Sie die folgenden Informationen:

Datenquellenkonfiguration 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

Sie haben den JNDI-Namen (Java Naming and Directory Interface) java:jboss/datasources/JPAWorldDataSource für die Datenquelle verwendet. Mit JNDI kann in verschiedenen Umgebungen ohne Codeänderungen zu einer anderen Datenbank gewechselt werden.

Zugreifen auf die Anwendung

Sobald Sie die MySQL-Datenquellenverbindung in JBoss EAP konfiguriert haben, können Sie auf die Java EE-Anwendung mit einem Webbrowser oder mit dem Befehl curl zugreifen.

In der nächsten Lerneinheit stellen Sie die Beispiel-App mithilfe der hier aufgeführten Prozedur bereit.