Guida introduttiva: Creare un'app Java nel Servizio app di Azure

Azure App Service offre un servizio di hosting per applicazioni web altamente scalabile e con auto-aggiornamento. In questa guida introduttiva si userà il plug-in Maven per app Web del servizio app di Azure per distribuire un'applicazione Web Java in un server Tomcat Linux nel servizio app di Azure.

Se Maven non è lo strumento di sviluppo preferito, vedere articoli simili per sviluppatori Java:

• Gradle
• IntelliJ IDEA
• Eclissi
• Visual Studio Code

Prerequisiti

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

• Eseguire i comandi in questa guida introduttiva usando Azure Cloud Shell, una shell interattiva che è possibile usare tramite il browser per usare i servizi di Azure. Per usare Cloud Shell:

  1. Selezionare il pulsante Launch Cloud Shell (Avvia Cloud Shell ) o passare a https://shell.azure.com per aprire Cloud Shell nel browser.

     

  2. Accedere ad Azure, se necessario, e assicurarsi di essere nell'ambiente Bash di Cloud Shell.

  3. Selezionare Copia in un blocco di codice, incollare il codice in Cloud Shell ed eseguirlo.

Creare un'app Java

Eseguire il comando Maven seguente in Cloud Shell per creare una nuova app denominata helloworld:

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

Quindi cambia la directory di lavoro spostandoti nella cartella del progetto eseguendo cd helloworld.

Configurare il plug-in Maven

Il processo di distribuzione del servizio app usa automaticamente le credenziali di Azure da Cloud Shell. Il plug-in Maven esegue l'autenticazione con OAuth o l'accesso del dispositivo. Per altre informazioni, vedere Authentication.

Eseguire il seguente comando Maven per configurare la distribuzione impostando il sistema operativo di App Service, la versione di Java e la versione di Tomcat.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

1. Per Crea nuova configurazione di esecuzione digitare Y e quindi premere INVIO.
2. Per Definisci valore per il sistema operativo digitare 2 per Linux e quindi premere INVIO.
3. Per Definisci valore per javaVersion digitare 1 per Java 21 e quindi premere INVIO.
4. Per Definisci valore per webContainer, digitare 1 per Tomcat 10.1 e quindi premere INVIO.
5. Per Definisci valore per pricingTier digitare 3 per P1V2 e quindi premere INVIO.
6. Per Conferma digitare Y e quindi premere INVIO.

L'output dovrebbe essere simile al codice seguente:

Please confirm webapp properties
AppName : helloworld-1745408005556
ResourceGroup : helloworld-1745408005556-rg
Region : centralus
PricingTier : P1V2
OS : Linux
Java Version: Java 21
Web server stack: Tomcat 10.1
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:34:44Z
[INFO] ------------------------------------------------------------------------

Dopo aver confermato le scelte, il plug-in aggiunge l'elemento plug-in e le impostazioni necessarie al file pom.xml del progetto, che configura l'app Web per l'esecuzione nell'App Service.

La parte pertinente del file dipom.xml dovrebbe essere simile all'esempio seguente.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>helloworld-1745408005556-rg</resourceGroup>
                <appName>helloworld-1745408005556</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

I valori per <appName> e <resourceGroup>helloworld-1745408005556 e helloworld-1745408005556-rg per l'app demo vengono usati in un secondo momento.

È possibile modificare le configurazioni per il servizio app direttamente nel file pom.xml .

• Per l'elenco completo delle configurazioni, vedere Configurazioni comuni.
• Per le configurazioni specifiche del servizio app, vedere App Web di Azure: Dettagli configurazione.

Distribuire l'app

Con tutta la configurazione pronta nel file pom.xml , è possibile distribuire l'app Java in Azure con il comando singolo seguente.

mvn package azure-webapp:deploy

Dopo aver selezionato da un elenco di sottoscrizioni disponibili, Maven viene distribuito nel servizio app di Azure. Al termine della distribuzione, l'applicazione è pronta.

Per questa demo, l'URL è http://helloworld-1745408005556.azurewebsites.net. Quando si apre l'URL con il Web browser locale, verrà visualizzata l'app seguente:

Congratulazioni! Hai distribuito un'app Java nel Servizio App.

Pulire le risorse

Le risorse per questa esercitazione sono state create in un gruppo di risorse di Azure. Se non sono più necessari, è possibile eliminare il gruppo di risorse e tutte le relative risorse eseguendo il comando seguente dell'interfaccia della riga di comando di Azure in Cloud Shell.

az group delete --name helloworld-1745408005556-rg --yes

L'esecuzione del comando potrebbe richiedere qualche minuto.

Servizio app di Azure offre un servizio di hosting di applicazioni web altamente scalabile e auto-aggiornante. In questa guida introduttiva si usa il plug-in Maven per app Web del servizio app di Azure per distribuire un'applicazione Web Java con un server Spring Boot, Quarkus o Tomcat incorporato nel servizio app. Per altre informazioni, vedere azure-webapp-maven-plugin.

Se Maven non è lo strumento di sviluppo preferito, vedere articoli simili per sviluppatori Java:

• Gradle
• IntelliJ IDEA
• Eclissi
• Visual Studio Code

Prerequisiti

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

• Eseguire i comandi in questa guida introduttiva usando Azure Cloud Shell, una shell interattiva che è possibile usare tramite il browser per usare i servizi di Azure. Per usare Cloud Shell:

  1. Selezionare il pulsante Launch Cloud Shell (Avvia Cloud Shell ) o passare a https://shell.azure.com per aprire Cloud Shell nel browser.

     

  2. Accedere ad Azure, se necessario, e assicurarsi di essere nell'ambiente Bash di Cloud Shell.

  3. Selezionare Copia in un blocco di codice, incollare il codice in Cloud Shell ed eseguirlo.

Ottenere l'app di esempio

Scegliere la scheda appropriata e seguire le istruzioni per scaricare l'applicazione web Spring Boot, Quarkus o Embedded Tomcat.

git clone https://github.com/rd-1-2022/rest-service my-webapp

Configurare il plug-in Maven

Il processo di distribuzione del servizio app usa automaticamente le credenziali di Azure da Cloud Shell. Il plug-in Maven esegue l'autenticazione con OAuth o l'accesso del dispositivo. Per altre informazioni, vedere Authentication.

Eseguire il comando Maven seguente per configurare la distribuzione impostando il sistema operativo del servizio app e la versione Java.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

1. Per Crea nuova configurazione di esecuzione digitare Y e quindi premere INVIO.
2. Per Definisci valore per il sistema operativo digitare 2 per Linux e quindi premere INVIO.
3. Per Definisci valore per javaVersion digitare 1 per Java 21 e quindi premere INVIO.
4. Per Definisci valore per pricingTier digitare 3 per P1v2 e quindi premere INVIO.
5. Per Conferma digitare Y e quindi premere INVIO.

L'output dovrebbe essere simile al codice seguente:

Please confirm webapp properties
AppName : <generated-app-name>
ResourceGroup : <generated-app-name>-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 21
Web server stack: Java SE
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  47.533 s
[INFO] Finished at: 2025-04-23T12:20:08Z
[INFO] ------------------------------------------------------------------------

Dopo aver confermato le scelte, il plugin aggiunge l'elemento plugin e le impostazioni necessarie al file dipom.xml del progetto, che configura l'app Web per l'esecuzione in App Service.

La parte pertinente del file dipom.xml dovrebbe essere simile all'esempio seguente.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>generated-app-name-rg</resourceGroup>
                <appName>generated-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

I valori per <appName> e <resourceGroup> vengono usati in un secondo momento.

È possibile modificare le configurazioni per il servizio app direttamente nel file pom.xml .

• Per l'elenco completo delle configurazioni, vedere Configurazioni comuni.
• Per le configurazioni specifiche del servizio app, vedere App Web di Azure: Dettagli configurazione.

Distribuire l'app

Con tutta la configurazione pronta nel file pom.xml , è possibile distribuire l'app Java in Azure.

Congratulazioni! Hai distribuito un'app Java a App Service.

Pulire le risorse

Le risorse per questa esercitazione sono state create in un gruppo di risorse di Azure. Se non sono più necessari, è possibile eliminare il gruppo di risorse e tutte le relative risorse eseguendo il comando seguente dell'interfaccia della riga di comando di Azure in Cloud Shell.

az group delete --name <resource group name>  --yes

Eseguire, ad esempio, az group delete --name quarkus-hello-azure-1690375364238-rg --yes. L'esecuzione di questo comando potrebbe richiedere alcuni minuti.

Azure App Service offre un servizio di hosting di app web altamente scalabile e di auto-aggiornamento. In questa guida introduttiva si userà il plug-in Maven per app Web del servizio app di Azure per distribuire un'applicazione Web Java in un server JBoss EAP Linux nel servizio app di Azure.

Se Maven non è lo strumento di sviluppo preferito, vedere articoli simili per sviluppatori Java:

• Gradle
• IntelliJ IDEA
• Eclissi
• Visual Studio Code

Prerequisiti

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

• Eseguire i comandi in questa guida introduttiva usando Azure Cloud Shell, una shell interattiva che è possibile usare tramite il browser per usare i servizi di Azure. Per usare Cloud Shell:

  1. Selezionare il pulsante Launch Cloud Shell (Avvia Cloud Shell ) o passare a https://shell.azure.com per aprire Cloud Shell nel browser.

     

  2. Accedere ad Azure, se necessario, e assicurarsi di essere nell'ambiente Bash di Cloud Shell.

  3. Selezionare Copia in un blocco di codice, incollare il codice in Cloud Shell ed eseguirlo.

Creare un'app Java

1. Clonare l'applicazione demo Pet Store.

   git clone https://github.com/Azure-Samples/app-service-java-quickstart
   

2. Passare alla directory del progetto completato petstore-ee7 e compilarla.

   cd app-service-java-quickstart
   git checkout 20230308
   cd petstore-ee7
   mvn clean install
   

   Se viene visualizzato un messaggio relativo allo stato HEAD scollegato, è possibile ignorarlo. Non si esegue alcun commit Git in questa guida introduttiva, quindi lo stato HEAD scollegato è appropriato.

   Suggerimento

   L'esempio petstore-ee7 richiede Java 11 o versione successiva. Il booty-duke-app-service progetto di esempio richiede Java 17. Se la versione installata di Java è minore di 17, eseguire la compilazione dall'interno della directory petstore-ee7 anziché al livello superiore.

Configurare il plug-in Maven

Il processo di distribuzione del servizio app usa automaticamente le credenziali di Azure da Cloud Shell. Il plug-in Maven esegue l'autenticazione con OAuth o l'accesso del dispositivo. Per altre informazioni, vedere Authentication.

Eseguire il comando Maven seguente per configurare la distribuzione impostando il sistema operativo del servizio app, la versione Java e la versione di Jbosseap.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

1. Per Crea nuova configurazione di esecuzione digitare Y e quindi premere INVIO.
2. Per Definisci valore per il sistema operativo digitare 2 per Linux e quindi premere INVIO.
3. Per Definisci valore per javaVersion digitare 2 per Java 17 e quindi premere INVIO. Se si seleziona Java 21, non viene visualizzato Jbosseap come opzione in un secondo momento.
4. Per Definisci valore per webContainer, digitare 4 per Jbosseap 7 e quindi premere INVIO.
5. Per Definisci valore per pricingTier digitare 1 per P1v3 e quindi premere INVIO.
6. Per Conferma digitare Y e quindi premere INVIO.

L'output dovrebbe essere simile al codice seguente:

Please confirm webapp properties
AppName : petstoreee7-1745409173307
ResourceGroup : petstoreee7-1745409173307-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 17
Web server stack: Jbosseap 4
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:54:22Z
[INFO] ------------------------------------------------------------------------

Dopo aver confermato le scelte, il plug-in aggiunge l'elemento plug-in e le impostazioni necessarie al file dipom.xml del progetto, che configura l'app web per l'esecuzione nel Servizio App.

La parte pertinente del file dipom.xml dovrebbe essere simile all'esempio seguente.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>petstoreee7-1745409173307-rg</resourceGroup>
                <appName>petstoreee7-1745409173307</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

I valori per <appName> e <resourceGroup>petstoreee7-1745409173307 e petstoreee7-1745409173307-rg nell'app demo vengono usati in un secondo momento.

È possibile modificare le configurazioni per il servizio app direttamente nel file pom.xml .

• Per l'elenco completo delle configurazioni, vedere Configurazioni comuni.
• Per le configurazioni specifiche del servizio app, vedere App Web di Azure: Dettagli configurazione.

Distribuire l'app

Con tutte le configurazioni pronte nel file pom.xml , è possibile distribuire l'app Java in Azure con il comando singolo seguente.

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

Dopo aver selezionato da un elenco di sottoscrizioni disponibili, Maven viene distribuito nel servizio app di Azure. Al termine della distribuzione, l'applicazione è pronta.

Per questa app demo, l'URL è http://petstoreee7-1745409173307.azurewebsites.net. Quando si apre l'URL con il Web browser locale, verrà visualizzata l'app seguente:

Congratulazioni! Hai distribuito un'app Java su App Service.

Pulire le risorse

Le risorse per questa esercitazione sono state create in un gruppo di risorse di Azure. Se non sono più necessari, è possibile eliminare il gruppo di risorse e tutte le relative risorse eseguendo il comando seguente dell'interfaccia della riga di comando di Azure in Cloud Shell.

az group delete --name petstoreee7-1745409173307-rg  --yes

L'esecuzione del comando potrebbe richiedere qualche minuto.