Bereitstellen einer Jakarta EE-Anwendung auf JBoss EAP im Azure App Service
Diese Einheit beschreibt die Schritte zum Bereitstellen Ihrer Jakarta EE-Anwendung auf Red Hat JBoss Enterprise Application Platform (JBoss EAP) auf Azure App Service. Außerdem wird beschrieben, wie eine Verbindung mit der Datenbank hergestellt wird. Sie führen diese Schritte tatsächlich in der nächsten Einheit aus.
Erstellen einer Jakarta EE-Anwendung
In diesem Modul verwenden Sie eine Beispielanwendung für Jakarta EE, die die folgenden Technologien verwendet:
- Jakarta EE 10
- JAX-RS 3.1
- JSON-B 3.0
- CDI 4.0
- JPA 3.1
Tipp
Das hier eingeführte Bereitstellungsverfahren ähnelt dem Verfahren, das für die meisten Jakarta EE-Webanwendungen verwendet wird.
Konfigurieren des Anwendungsprojekts für die Bereitstellung in Azure mithilfe von Maven
Microsoft stellt das Maven-Plug-In für Azure App Service bereit, 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 konfigurieren:
| Konfiguration | BESCHREIBUNG |
|---|---|
subscriptionID |
Das 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 |
Die VM-Auswahl für die Verwendung. |
region |
Die Region, für die sie bereitgestellt werden soll. In diesem Modul verwenden Sie denselben Speicherort wie der MySQL-Installationsspeicherort. |
runtime, OS |
Das zu verwendende Betriebssystem. In diesem Modul verwenden Sie Linux. |
runtime, javaVersion |
Die Version des virtuellen Java-Computers für den Webcontainer. In diesem Modul verwenden Sie Java 17. |
runtime, webContainer |
Der Webcontainer. In diesem Modul verwenden Sie Red Hat JBoss EAP 8. |
Erstellen des WAR-Pakets
Sie können den ./mvnw package Befehl verwenden, um ein War-Paket (Web Application Archive) zu erstellen.
Hinweis
Optional können Sie das Paket testen, indem Sie es in einer lokalen JBoss-EAP-Umgebung bereitstellen.
Bereitstellen der Jakarta EE-App für JBoss EAP
Nachdem Sie Ihr Maven-Artefakt erstellt haben, können Sie den deploy Befehl im Maven-Plug-In für Azure App Service verwenden, um die Anwendung für JBoss EAP bereitzustellen. Dieser Befehl erstellt eine Azure-Ressourcengruppe und eine Instanz von JBoss EAP basierend auf den vorherigen Plug-In-Einstellungen. Mit diesem einen Befehl wird alles von der Erstellung von Instanzen bis hin zur Bereitstellung der Java-Webanwendung ausgeführt.
Alle Azure Maven-Plug-Ins teilen einen gemeinsamen Satz von Konfigurationen. Die vollständige Liste der Konfigurationen finden Sie in der Dokumentation zur Plug-In-Referenz. Weitere Informationen finden Sie unter "Allgemeine Konfiguration". Weitere Informationen zu konfigurationen spezifisch für App Service finden Sie unter Azure Web App: Konfigurationsdetails.
Konfigurieren einer Datenbankverbindung mithilfe einer Datenquelle und JNDI
Ihre Anwendung erfordert eine Bindung an eine Datenquelle. In der nächsten Einheit konfigurieren Sie die Anwendung für die Verwendung der MySQL-Datenbank, die Sie in der vorherigen Einheit erstellt haben. Um eine Verbindung mit der Datenbank von JBoss EAP herzustellen, müssen Sie ein DataSource Objekt konfigurieren, das es einer Anwendung ermöglicht, eine Verbindung mit der Datenbank herzustellen.
Sie konfigurieren DataSource , um eine Verbindung mit der Azure-Datenbank für MySQL-Instanz herzustellen, die Sie zuvor erstellt haben, indem Sie die folgenden Einstellungen verwenden:
| Konfiguration der Datenquelle | Wert |
|---|---|
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_9_2 |
Minimum Pool Size |
5 |
Maximum Pool Size |
20 |
JDBC Class Name |
com.mysql.cj.jdbc.Driver |
Sie haben einen JNDI-Namen java:jboss/datasources/JPAWorldDataSource (Java Naming and Directory Interface) für die Datenquelle verwendet. JNDI ist in mehreren Umgebungen nützlich, um ohne Codeänderungen in eine andere Datenbank zu wechseln.
Zugreifen auf die Anwendung
Nachdem Sie die MySQL-Datenquellenverbindung in JBoss EAP konfiguriert haben, können Sie über einen Webbrowser oder den curl Befehl auf die Jakarta EE-Anwendung zugreifen.
In der nächsten Einheit stellen Sie die Beispiel-App mithilfe des hier beschriebenen Verfahrens bereit.