Distribuire un'applicazione Java EE (Jakarta EE) in JBoss EAP nel servizio app di Azure

  • 4 minuti

I passaggi di questa unità illustrano come distribuire l'applicazione Java EE in JBoss EAP nel servizio app di Azure e come stabilire la connessione al database. Questi passaggi verranno effettivamente eseguiti nella prossima unità.

Creare un'applicazione Java EE (Jakarta EE)

In questo modulo si userà un'applicazione Java EE di esempio già preparata basata sulle tecnologie seguenti:

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

Suggerimento

La procedura di distribuzione illustrata qui è simile per la maggior parte delle applicazioni Web Java EE (Jakarta EE).

Configurare il progetto di applicazione per la distribuzione in Azure con Maven

Microsoft fornisce il plug-in Maven per il servizio app di Azure per distribuire le applicazioni Web Java nel servizio app di Azure. Usando il plug-in Maven è possibile configurare facilmente le impostazioni seguenti per l'istanza del servizio app:

Articoli Descrizione
subscriptionID Sottoscrizione di Azure per la distribuzione
resourceGroup Nome del gruppo di risorse in cui viene distribuito il contenitore Web
appName Nome dell'istanza dell'applicazione per il contenitore Web
pricingTier Selezione della macchina virtuale per l'esecuzione
region Area in cui eseguire la distribuzione (corrispondente alla posizione di installazione di MySQL)
runtime OS Sistema operativo da eseguire (Linux)
runtime javaVersion Versione della macchina virtuale Java per il contenitore Web (Java 8)
runtime webContainer Contenitore Web (JBoss EAP 7)

In questo modulo si distribuisce un'applicazione nell'ambiente JBoss EAP. Selezionare Java 8 per la versione di Java e Jbosseap 7.4 per il contenitore Web di runtime.

Creare il pacchetto WAR

È possibile usare il comando ./mvnw package per creare un pacchetto WAR (Web Application Archive).

Nota

Facoltativamente, è possibile testare il pacchetto eseguendo la distribuzione in un ambiente JBoss EAP locale.

Distribuire l'app Java EE in JBoss EAP

Dopo aver creato l'artefatto Maven, è possibile eseguire il comando deploy nel plug-in Maven per il servizio app di Azure per distribuire l'applicazione in JBoss EAP.

Il comando deploy crea un gruppo di risorse di Azure e un'istanza di JBoss EAP in base alle impostazioni del plug-in precedenti. Questo comando esegue tutte le operazioni necessarie, dalla creazione di istanze alla distribuzione dell'applicazione Web Java.

Per l'elenco completo delle configurazioni, vedere la documentazione di riferimento sul plug-in. Tutti i plug-in Azure Maven condividono un set comune di configurazioni. Per informazioni, vedere Configurazioni comuni. Per le configurazioni specifiche del servizio app, vedere App Web di Azure: dettagli sulla configurazione.

Configurare una connessione di database usando un'origine dati e JNDI

L'applicazione richiederà un binding a un'origine dati. L'applicazione verrà configurata in modo da usare il database MySQL creato nelle unità precedenti.

Per connettersi al database da JBoss EAP, è necessario configurare un oggetto DataSource. Quando si configura un oggetto DataSource, un'applicazione può connettersi al database.

L'oggetto DataSource verrà configurato per connettersi all'istanza di Database di Azure per MySQL creata in precedenza con le informazioni seguenti:

Configurazione delle origini dati 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

Per l'origine dati è stato usato un nome JNDI (Java Naming and Directory Interface) java:jboss/datasources/JPAWorldDataSource. JNDI è utile in più ambienti per passare a un database diverso senza modificare il codice.

Accedere all'applicazione

Dopo aver configurato la connessione all'origine dati MySQL in JBoss EAP, è possibile accedere all'applicazione Java EE usando un Web browser o il comando curl.

Nell'unità successiva si distribuirà l'app di esempio usando la procedura illustrata in questa sezione.