Nasazení aplikace Jakarta EE do EAP JBoss ve službě Azure App Service

Dokončeno

Tato lekce popisuje postup nasazení aplikace Jakarta EE do platformy Red Hat JBoss Enterprise Application Platform (JBoss EAP) ve službě Azure App Service. Popisuje také, jak se připojit k databázi. Tyto kroky ve skutečnosti provedete v další lekci.

Vytvoření aplikace Jakarta EE

V tomto modulu použijete ukázkovou aplikaci Jakarta EE, která používá následující technologie:

  • Jakarta EE 10
  • JAX-RS 3.1
  • JSON-B 3.0
  • CDI 4.0
  • JPA 3.1

Spropitné

Postup nasazení zavedený zde je podobný postupu, který se používá pro většinu webových aplikací Jakarta EE.

Konfigurace projektu aplikace pro nasazení do Azure pomocí Mavenu

Microsoft poskytuje modul plug-in Maven pro Azure App Service pro nasazení webových aplikací v Javě do služby Azure App Service. Pomocí tohoto modulu plug-in Maven můžete pro instanci služby App Service nakonfigurovat následující nastavení:

Nastavení Popis
subscriptionID Předplatné Azure pro nasazení.
resourceGroup Název skupiny prostředků, do které je webový kontejner nasazený.
appName Název instance aplikace pro webový kontejner.
pricingTier Výběr virtuálního počítače, který se má použít.
region Oblast, do které se má nasadit. V tomto modulu použijete stejné umístění jako umístění instalace MySQL.
runtime, OS Operační systém, který se má použít. V tomto modulu použijete Linux.
runtime, javaVersion Verze virtuálního počítače Java pro webový kontejner. V tomto modulu použijete Java 17.
runtime, webContainer Webový kontejner. V tomto modulu použijete Red Hat JBoss EAP 8.

Sestavení balíčku WAR

K sestavení balíčku Archiv webových aplikací (WAR) můžete použít příkaz ./mvnw package.

Poznámka

Volitelně můžete balíček otestovat nasazením do místního prostředí JBoss EAP.

Nasazení aplikace Jakarta EE do EAP JBoss

Po vytvoření artefaktu Maven můžete pomocí deploy příkazu v modulu plug-in Maven pro Azure App Service nasadit aplikaci do JBoss EAP. Tento příkaz vytvoří skupinu prostředků Azure a instanci protokolu JBoss EAP na základě předchozích nastavení modulu plug-in. Tento příkaz dělá všechno od vytváření instancí až po nasazení webové aplikace v Javě.

Všechny moduly plug-in Azure Maven sdílejí společnou sadu konfigurací. Úplný seznam konfigurací najdete v referenční dokumentaci k modulům plug-in. Další informace najdete v tématu Běžná konfigurace. Další informace o konfiguracích specifických pro Službu App Service najdete v tématu Azure Web App: Podrobnosti konfigurace.

Konfigurace připojení k databázi pomocí zdroje dat a JNDI

Vaše aplikace vyžaduje vazbu ke zdroji dat. V další lekci nakonfigurujete aplikaci tak, aby používala databázi MySQL, kterou jste vytvořili v předchozí lekci. Pokud se chcete připojit k databázi z protokolu JBoss EAP, musíte nakonfigurovat DataSource objekt, který aplikaci umožní připojit se k databázi.

Pomocí následujících nastavení nakonfigurujete DataSource připojení k instanci Azure Database for MySQL, kterou jste vytvořili dříve:

Konfigurace zdroje dat hodnota
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

Pro zdroj dat jste použili název java:jboss/datasources/JPAWorldDataSource JNDI (Java Naming and Directory Interface). JNDI je užitečné v několika prostředích, aby se bez změn kódu změnila na jinou databázi.

Přístup k aplikaci

Po nakonfigurování připojení ke zdroji dat MySQL v JBoss EAP můžete přistupovat k aplikaci Jakarta EE pomocí webového curl prohlížeče nebo příkazu.

V další lekci nasadíte ukázkovou aplikaci pomocí postupu popsaného zde.