Distribuire un'app Web KumuluzEE in Servizio app di Azure con Maven

Articolo
03/30/2023

In questa guida di avvio rapido si userà il plug-in Maven per app Web del servizio app di Azure per distribuire un'applicazione KumuluzEE in Servizio app di Azure in Linux. La distribuzione con Java SE sarà preferibile rispetto a Tomcat e file WAR quando si vogliono consolidare le dipendenze, il runtime e la configurazione dell'app in un singolo artefatto distribuibile.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Prerequisiti

Interfaccia della riga di comando di Azure, in locale o tramite Azure Cloud Shell.
Java Development Kit (JDK) supportato. Per altre informazioni sui JDK disponibili per l'uso durante lo sviluppo in Azure, vedere Supporto java in Azure e Azure Stack.
Apache Maven, versione 3.

Il modo più semplice e facile per distribuire l'applicazione KumuluzEE tramite il plug-in Maven consiste nell'usare l'interfaccia della riga di comando di Azure.

Accedere all'account Azure con l'interfaccia della riga di comando di Azure:

az login

Seguire le istruzioni per completare il processo di accesso.

Creare un'app di esempio da MicroProfile Starter

In questa sezione si creerà un'applicazione KumuluzEE e la si testerà in locale.

Creare un progetto di base Java SE 8

Aprire un Web browser e passare al sito MicroProfile Starter .

Immettere o selezionare i valori per i campi come indicato di seguito.

Campo	valore
groupId	com.microsoft.azure.samples.kumuluzee
artifactId	kumuluzEE-hello-azure
MicroProfile Version (Versione di MicroProfile)	MP 3.2
Java SE Version (Versione di Java SE)	Java 8
MicroProfile Runtime (Runtime di MicroProfile)	KumuluzEE
Examples for Specifications (Esempi per le specifiche)	Metrics, OpenAPI

Selezionare DOWNLOAD per scaricare il progetto.
Decomprimere il file di archivio, ad esempio:
```
unzip kumuluzEE-hello-azure.zip
```

Eseguire l'applicazione nell'ambiente locale

Passare alla directory del progetto completato. Ad esempio:
```
cd kumuluzEE-hello-azure/
```
Compilare il progetto usando Maven, ad esempio:
```
mvn clean package
```
Eseguire l'applicazione usando il comando seguente:
```
java -jar target/kumuluzEE-hello-azure.jar
```
Testare l'app Web esplorandola localmente tramite un Web browser. Se è disponibile curl, ad esempio, è possibile usare il comando seguente:
```
curl http://localhost:8080/data/hello
```
Verrà visualizzato il messaggio seguente: Hello World.

Configurare il plug-in Maven per il servizio app di Azure

In questa sezione si configurerà il file pom.xml del progetto KumuluzEE in modo che Maven possa distribuire l'app in Servizio app di Azure in Linux.

Aprire il file pom.xml in un editor di codice.

Nella sezione <build> del file pom.xml inserire la voce <plugin> seguente all'interno del tag <plugins>.

<build>
  <finalName>kumuluzEE-hello-azure</finalName>
  <plugins>
    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-webapp-maven-plugin</artifactId>
      <version>1.10.0</version>
    </plugin>
  </plugins>
</build>

È quindi possibile configurare la distribuzione. Eseguire il comando Maven seguente:

mvn azure-webapp:config

Selezionare le opzioni seguenti quando richiesto:

Campo di input	Valore di input/selezione
Definire il valore per OS(Default: Linux):	1. linux
Definire il valore per javaVersion(Default: Java 8):	2. Java 8
Confirm (Y/N)	y

Questo comando genera un output simile all'esempio seguente:

[INFO] Scanning for projects...
[INFO]
[INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >-----
[INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure ---
1. linux [*]
2. windows
3. docker
Enter index to use: 1
Define value for javaVersion(Default: Java 8):
1. Java 11
2. Java 8 [*]
Enter index to use: 2
Please confirm webapp properties
AppName : kumuluzEE-hello-azure-1601006602397
ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg
Region : westeurope
PricingTier : PremiumV2_P1v2
OS : Linux
RuntimeStack : JAVA 8-jre8
Deploy to slot : false
Confirm (Y/N)? : y
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  44.223 s
[INFO] Finished at: 2020-09-25T13:04:02+09:00
[INFO] ------------------------------------------------------------------------

Aggiungere la <appSettings> sezione alla <configuration> sezione di PORT, WEBSITES_PORTe WEBSITES_CONTAINER_START_TIME_LIMIT. La voce XML per azure-webapp-maven-plugin sarà simile all'esempio seguente:

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>1.10.0</version>
  <configuration>
    <schemaVersion>V2</schemaVersion>
    <resourceGroup>microprofile</resourceGroup>
    <appName>kumuluzEE-hello-azure-1601006602397</appName>
    <pricingTier>P1v2</pricingTier>
    <region>japaneast</region>
    <runtime>
      <os>linux</os>
      <javaVersion>jre8</javaVersion>
      <webContainer>jre8</webContainer>
    </runtime>
    <appSettings>
      <property>
        <name>PORT</name>
        <value>8080</value>
      </property>
      <property>
        <name>WEBSITES_PORT</name>
        <value>8080</value>
      </property>
      <property>
        <name>WEBSITES_CONTAINER_START_TIME_LIMIT</name>
        <value>600</value>
      </property>
    </appSettings>
    <deployment>
      <resources>
        <resource>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
  </configuration>
</plugin>

Distribuire l'app in Azure

Dopo aver configurato tutte le impostazioni nelle sezioni precedenti di questo articolo, si è pronti per distribuire l'app Web in Azure. A tale scopo, seguire questa procedura:

Se sono state apportate modifiche al file pom.xml, dalla finestra del terminale o al prompt dei comandi usato in precedenza ricompilare il file JAR usando Maven. Ad esempio:
```
mvn clean package
```
Distribuire l'app Web in Azure usando Maven. Ad esempio:
```
mvn azure-webapp:deploy
```

Se la distribuzione è riuscita, verrà visualizzato l'output seguente.

[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+09:00
[INFO] ------------------------------------------------------------------------

Maven distribuirà l'app Web in Azure. Se l'app Web o il piano dell'app Web non esiste già, verrà creato automaticamente. Potrebbero essere necessari alcuni minuti prima che l'app Web sia visibile nell'URL indicato nell'output. Passare all'URL in un Web browser. Verrà visualizzata la schermata seguente.

Screenshot del Web browser che mostra Kumuluz edizione Enterprise pagina iniziale.

Quando il Web è stato distribuito, è possibile gestirlo tramite il portale di Azure.

L'app Web verrà elencata nel gruppo di risorse microprofile .

È possibile accedere all'app Web selezionando Sfoglia nella pagina Panoramica dell'app Web. Verificare che la distribuzione sia riuscita e in esecuzione.

Verificare il flusso di log dal servizio app in esecuzione

È possibile visualizzare i log del servizio app in esecuzione. Qualsiasi chiamata effettuata a console.log nel codice del sito viene visualizzata nel terminale.

az webapp log tail \
    --resource-group microprofile \
    --name kumuluzEE-hello-azure-1601006602397

Pulire le risorse

Quando non sono più necessarie, eseguire la pulizia delle risorse di Azure distribuite eliminando il gruppo di risorse.

Nel portale di Azure selezionare Gruppo di risorse nel menu a sinistra.
Immettere microprofile nel campo Filtra per nome. Il gruppo di risorse creato in questa esercitazione dovrebbe avere questo prefisso.
Selezionare il gruppo di risorse creato in questa esercitazione.
Selezionare Elimina gruppo di risorse nel menu in alto.

Passaggi successivi

Per altre informazioni su MicroProfile e Azure, passare al centro di documentazione di MicroProfile in Azure.

MicroProfile in Azure

Risorse aggiuntive

Per altre informazioni sulle varie tecnologie illustrate in questo articolo, vedere gli articoli seguenti:

Condividi tramite

Distribuire un'app Web KumuluzEE in Servizio app di Azure con Maven

Prerequisiti

Creare un'app di esempio da MicroProfile Starter

Creare un progetto di base Java SE 8

Eseguire l'applicazione nell'ambiente locale

Configurare il plug-in Maven per il servizio app di Azure

Distribuire l'app in Azure

Verificare il flusso di log dal servizio app in esecuzione

Pulire le risorse

Passaggi successivi

Risorse aggiuntive

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

Distribuire un'app Web KumuluzEE in Servizio app di Azure con Maven

Prerequisiti

Accedere all'interfaccia della riga di comando di Azure

Creare un'app di esempio da MicroProfile Starter

Creare un progetto di base Java SE 8

Eseguire l'applicazione nell'ambiente locale

Configurare il plug-in Maven per il servizio app di Azure

Distribuire l'app in Azure

Verificare il flusso di log dal servizio app in esecuzione

Pulire le risorse

Passaggi successivi

Risorse aggiuntive

Commenti e suggerimenti

Risorse aggiuntive