Een Jakarta EE-toepassing implementeren in JBoss EAP in Azure App Service
In deze les worden de stappen beschreven voor het implementeren van uw Jakarta EE-toepassing in Red Hat JBoss Enterprise Application Platform (JBoss EAP) in Azure App Service. Ook wordt beschreven hoe u verbinding maakt met de database. Je voert deze stappen daadwerkelijk uit in de volgende eenheid.
Een Jakarta EE-toepassing maken
In deze module gebruikt u een voorbeeld van een Jakarta EE-toepassing die gebruikmaakt van de volgende technologieën:
- Jakarta EE 10
- JAX-RS 3.1
- JSON-B 3.0
- CDI 4.0
- JPA 3.1
Aanbeveling
De implementatieprocedure die hier wordt geïntroduceerd, is vergelijkbaar met de procedure die wordt gebruikt voor de meeste Jakarta EE-webtoepassingen.
Het toepassingsproject configureren voor implementatie in Azure met behulp van Maven
Microsoft biedt de Maven-invoegtoepassing voor Azure App Service om uw Java-webtoepassingen te implementeren in Azure App Service. Met deze Maven-invoegtoepassing kunt u de volgende instellingen configureren voor uw App Service-exemplaar:
| Configuratie | Beschrijving |
|---|---|
subscriptionID |
Het Azure-abonnement voor implementatie. |
resourceGroup |
De naam van de resourcegroep waarin de webcontainer is geïmplementeerd. |
appName |
De naam van het toepassingsexemplaar voor de webcontainer. |
pricingTier |
De selectie van de virtuele machine die moet worden gebruikt. |
region |
De regio waar moet worden geïmplementeerd. In deze module gebruikt u dezelfde locatie als de MySQL-installatielocatie. |
runtime, OS |
Het besturingssysteem dat moet worden gebruikt. In deze module gebruikt u Linux. |
runtime, javaVersion |
De versie van de virtuele Java-machine voor de webcontainer. In deze module gebruikt u Java 17. |
runtime, webContainer |
De webcontainer. In deze module gebruikt u Red Hat JBoss EAP 8. |
Het WAR-pakket bouwen
U kunt de opdracht ./mvnw package gebruiken om een WAR-pakket (Web Application Archive) te maken.
Notitie
U kunt het pakket desgewenst testen door te implementeren in een lokale JBoss EAP-omgeving.
De Jakarta EE-app implementeren in JBoss EAP
Nadat u uw Maven-artefact hebt gemaakt, kunt u de deploy opdracht in de Maven-invoegtoepassing voor Azure App Service gebruiken om de toepassing te implementeren in JBoss EAP. Met deze opdracht maakt u een Azure-resourcegroep en een exemplaar van JBoss EAP op basis van de voorgaande invoegtoepassingsinstellingen. Deze ene opdracht doet alles van het maken van exemplaren tot het implementeren van de Java-webtoepassing.
Alle Azure Maven-invoegtoepassingen delen een gemeenschappelijke set configuraties. Zie de referentiedocumentatie voor invoegtoepassingen voor de volledige lijst met configuraties. Zie Algemene configuratie voor meer informatie. Zie Azure Web App: Configuratiedetails voor meer informatie over configuraties die specifiek zijn voor App Service.
Een databaseverbinding configureren met behulp van een gegevensbron en JNDI
Uw toepassing vereist een binding met een gegevensbron. In de volgende les configureert u de toepassing voor het gebruik van de MySQL-database die u in de vorige les hebt gemaakt. Als u vanuit JBoss EAP verbinding wilt maken met de database, moet u een DataSource object configureren waarmee een toepassing verbinding kan maken met de database.
U configureert DataSource om verbinding te maken met het Azure Database for MySQL-exemplaar dat u eerder hebt gemaakt met behulp van de volgende instellingen:
| Configuratie van gegevensbron | waarde |
|---|---|
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 |
U hebt een JNDI-naam (Java Naming and Directory Interface) gebruikt voor java:jboss/datasources/JPAWorldDataSource de gegevensbron. JNDI is handig in meerdere omgevingen om te wijzigen in een andere database zonder codewijzigingen.
Toegang tot de toepassing
Nadat u de MySQL-gegevensbronverbinding in JBoss EAP hebt geconfigureerd, hebt u toegang tot de Jakarta EE-toepassing met behulp van een webbrowser of de curl opdracht.
In de volgende les implementeert u de voorbeeld-app met behulp van de procedure die hier wordt beschreven.