Démarrage rapide : Créer une application Java dans Azure App Service

Dans ce démarrage rapide, vous utiliserez le plug-in Maven pour les applications App Service Web Apps pour déployer une application Web Java sur un serveur Linux Tomcat dans Azure App Service. App Service fournit un service d’hébergement d’applications Web hautement évolutif et auto-correctif. Utilisez les onglets pour basculer entre les instructions de Tomcat, JBoss ou du serveur intégré (Java SE).

Capture d’écran de l’application web Maven Hello World en cours d’exécution dans Azure App Service.

Si Maven n’est pas votre outil de développement préféré, consultez nos tutoriels similaires destinés aux développeurs Java :

Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.

1 - Utiliser Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Choix	Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure.

Pour utiliser Azure Cloud Shell :

Démarrez Cloud Shell.
Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.
Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.
Sélectionnez Entrer pour exécuter le code ou la commande.

2 - Créer une application Java

Exécutez la commande Maven suivante dans l’invite Cloud Shell pour créer une application nommée helloworld :

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

Ensuite, changez votre répertoire de travail vers le dossier du projet :

cd helloworld

3 - Configurer le plug-in Maven

Le processus de déploiement sur Azure App Service utilise automatiquement vos informations d’identification Azure dans Azure CLI. Si Azure CLI n’est pas installé localement, le plug-in Maven s’authentifie avec OAuth ou la connexion de l’appareil. Pour plus d’informations, consultez Authentification avec les plug-ins Maven.

Exécutez la commande Maven ci-dessous pour configurer le déploiement. Cette commande vous permet de configurer le système d’exploitation App Service, les versions de Java et Tomcat.

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

Pour Créer une nouvelle configuration d'exécution, tapez Y, puis Entrée.
Pour Define value for OS, tapez 1 pour Windows ou 2 pour Linux, puis Entrer.
Pour Définir la valeur de javaVersion, tapez 1 pour Java 21, puis Entrez.
Pour Définir la valeur pour webContainer, tapez 1 pour Tomcat 10.1, puis Entrez.
Pour Définir la valeur de pricingTier, tapez 3 pour P1V2, puis Entrez.

Pour Confirmer, tapez Y, puis Entrer.

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] ------------------------------------------------------------------------

Une fois que vous avez confirmé vos choix, le plug-in ajoute les paramètres requis et l’élément de plug-in ci-dessus au fichier pom.xml de votre projet, qui configurent votre application web pour qu’elle s’exécute dans Azure App Service.

La partie pertinente du fichier pom.xml doit ressembler à l’exemple suivant.

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

Vous pouvez modifier les configurations d’App Service directement dans votre pom.xml.

Pour obtenir la liste complète des configurations, consultez Configurations courantes.
Pour les configurations spécifiques à App Service, consultez Application web Azure : détails de configuration.

Faites attention aux valeurs de <appName> et <resourceGroup> (helloworld-1745408005556 et helloworld-1745408005556-rg en conséquence dans la démo). Ils sont utilisés plus tard.

4 - Déployer l’application

Avec toute la configuration prête dans votre fichier pom.xml, vous pouvez déployer votre application Java sur Azure avec une seule commande.

mvn package azure-webapp:deploy

Une fois que vous avez sélectionné dans une liste d’abonnements disponibles, Maven se déploie sur Azure App Service. Une fois le déploiement terminé, votre application est prête. Dans cette démonstration, l’URL est http://helloworld-1745408005556.azurewebsites.net. Ouvrez l’URL avec votre navigateur web local, vous devriez voir

Capture d’écran de l’application web Maven Hello World en cours d’exécution dans Azure App Service.

Félicitations ! Vous avez déployé votre première application Java sur App Service.

5 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous n’avez plus besoin de ces ressources, supprimez le groupe de ressources du portail en exécutant la commande suivante dans Cloud Shell :

az group delete --name <your resource group name; for example: helloworld-1745408005556-rg> --yes

L’exécution de cette commande peut prendre une minute.

Dans ce guide de démarrage rapide, vous utilisez le plug-in Maven Maven pour Azure App Service Web Apps pour déployer une application web Java avec un serveur incorporé sur azure App Service. App Service fournit un service d’hébergement d’applications Web hautement évolutif et auto-correctif. Utilisez les onglets pour basculer entre les instructions de Tomcat, JBoss ou du serveur intégré (Java SE).

Le guide de démarrage rapide déploie soit une application Spring Boot, une application Quarkus, ou une application Tomcat incorporée à l’aide du plugin azure-webapp-maven-plugin.

Capture d’écran de l’application web Spring Boot Hello World en cours d’exécution dans Azure App Service en introduction.

Si Maven n’est pas votre outil de développement préféré, consultez nos tutoriels similaires destinés aux développeurs Java :

Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.

1 - Utiliser Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Choix	Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure.

Pour utiliser Azure Cloud Shell :

Démarrez Cloud Shell.
Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.
Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.
Sélectionnez Entrer pour exécuter le code ou la commande.

2 - Obtenir l’exemple d’application

Téléchargez et extrayez le modèle d’application web Spring Boot par défaut . Ce référentiel est cloné pour vous lorsque vous exécutez la commande de l’interface cli spring boot new my-webapp.
```
git clone https://github.com/rd-1-2022/rest-service my-webapp
```
Remplacez votre répertoire de travail par le dossier du projet :
```
cd my-webapp
```

Générez une nouvelle application Cpuus nommée quarkus-hello-azure avec la commande Maven suivante :

mvn io.quarkus.platform:quarkus-maven-plugin:3.21.3:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=quarkus-hello-azure  \
    -Dextensions='resteasy-reactive'

Remplacez votre répertoire de travail par le dossier du projet :
```
cd quarkus-hello-azure
```

Téléchargez et extrayez le référentiel embeddedTomcatExample , ou clonez-le localement en exécutant git clone:
```
git clone https://github.com/Azure-Samples/java-docs-embedded-tomcat
```
Remplacez votre répertoire de travail par le dossier du projet :
```
cd java-docs-embedded-tomcat
```
L’application est exécutée à l’aide de la classe Standard (voir Main.java dans l’exemple).

3 - Configurer le plug-in Maven

Le processus de déploiement sur Azure App Service utilise automatiquement vos informations d’identification Azure dans Azure CLI. Si Azure CLI n’est pas installé localement, le plug-in Maven s’authentifie avec OAuth ou la connexion de l’appareil. Pour plus d’informations, consultez Authentification avec les plug-ins Maven.

Exécutez la commande Maven ci-dessous pour configurer le déploiement. Cette commande vous permet de configurer le système d’exploitation App Service, les versions de Java et Tomcat.

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

Pour Créer une nouvelle configuration d'exécution, tapez Y, puis Entrée.
Pour Define value for OS, tapez 2 pour Linux, puis Entrer.
Pour Définir la valeur de javaVersion, tapez 1 pour Java 21, puis Entrez.
Pour Définir la valeur du niveau de tarification, tapez 3 pour P1v2, puis Entrer.

Pour Confirmer, tapez Y, puis Entrer.

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] ------------------------------------------------------------------------

Après avoir confirmé vos choix, le plug-in ajoute l’élément de plug-in ci-dessus et les paramètres requis au fichier pom.xml de votre projet qui configure votre application web pour qu’elle s’exécute dans Azure App Service.

La partie pertinente du fichier pom.xml doit ressembler à l’exemple suivant.

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

Vous pouvez modifier les configurations d’App Service directement dans votre pom.xml.

Pour obtenir la liste complète des configurations, consultez Configurations courantes.
Pour les configurations spécifiques à App Service, consultez Application web Azure : détails de configuration.

Faites attention aux valeurs de <appName> et de <resourceGroup>. Ils sont utilisés plus tard.

4 - Déployer l’application

Avec toute la configuration prête dans votre fichier pom.xml, vous pouvez déployer votre application Java sur Azure avec une seule commande.

Générez le fichier JAR à l’aide des commandes suivantes :
```
mvn clean package
```
Conseil

Spring Boot produit deux fichiers JAR avec mvn package, mais azure-webapp-maven-plugin choisit le fichier JAR approprié à déployer automatiquement.
```
echo '%prod.quarkus.http.port=${PORT}' >> src/main/resources/application.properties
mvn clean package -Dquarkus.package.jar.type=uber-jar
```
Dans ces commandes :
- Vous définissez le port Dockerus dans le fichier application.properties sur la variable d’environnement PORT dans le conteneur Java Linux.
- quarkus.package.jar.type=uber-jar indique à Maven de générer un Uber-Jar, qui inclut toutes les dépendances du fichier JAR.
Conseil

Quarkus génère deux fichiers JAR avec mvn package, mais azure-webapp-maven-plugin sélectionne automatiquement le fichier JAR approprié à déployer.
```
mvn clean package
```
Pour rendre l’application déployable à l’aide de azure-webapp-maven-plugin et s’exécutant sur Azure App Service, l’exemple configure l’objectif package comme suit :
- Créez un seul fichier JAR Uber, qui contient tout ce dont l’application a besoin pour s’exécuter.
- Créez un fichier JAR exécutable en spécifiant la classe Tomcat comme classe de démarrage.
- Remplacez l’artefact d’origine par le fichier JAR uber pour vous assurer que l’étape de déploiement déploie le fichier approprié.

Déployez sur Azure à l'aide de la commande suivante :

mvn azure-webapp:deploy

Une fois que vous avez sélectionné dans une liste d’abonnements disponibles, Maven se déploie sur Azure App Service. Une fois le déploiement terminé, la sortie suivante s’affiche :

[INFO] Successfully deployed the artifact to <URL>
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:20 min
[INFO] Finished at: 2023-07-26T12:47:50Z
[INFO] ------------------------------------------------------------------------

Votre application est prête.

Obtenez le domaine par défaut de votre application dans le portail Azure en sélectionnant Vue d’ensemble de votre application. Ajouter /greeting. Vous devriez voir :

Capture d’écran de l’application web Spring Boot Hello World en cours d’exécution dans Azure App Service.

Félicitations ! Vous avez déployé votre première application Java sur App Service.

5 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous n’avez plus besoin de ces ressources, supprimez le groupe de ressources du portail en exécutant la commande suivante dans Cloud Shell :

az group delete --name <your resource group name; for example: quarkus-hello-azure-1690375364238-rg> --yes

L’exécution de cette commande peut prendre une minute.

Dans ce démarrage rapide, vous utiliserez le plug-in Maven pour les applications App Service Web Apps pour déployer une application Web Java sur un serveur Linux JBoss EAP dans Azure App Service. App Service fournit un service d’hébergement d’applications Web hautement évolutif et auto-correctif. Utilisez les onglets pour basculer entre les instructions de Tomcat, JBoss ou du serveur intégré (Java SE).

Capture d’écran de l’application web Maven Hello World en cours d’exécution dans Azure App Service.

Si Maven n’est pas votre outil de développement préféré, consultez nos tutoriels similaires destinés aux développeurs Java :

Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.

1 - Utiliser Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Choix	Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure.

Pour utiliser Azure Cloud Shell :

Démarrez Cloud Shell.
Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.
Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.
Sélectionnez Entrer pour exécuter le code ou la commande.

2 - Créer une application Java

Clonez l’application de démonstration Pet Store.

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

Accédez au répertoire du projet d'animalerie terminé et construisez-le.

Conseil

L’exemple petstore-ee7 nécessite Java 11 ou ultérieur. L’exemple de projet booty-duke-app-service nécessite Java 17. Si votre installation de Java est inférieure à la version 17, exécutez la build à partir du répertoire petstore-ee7 plutôt qu’au niveau supérieur.

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

Si un message vous signale que vous allez passer à l’état detached HEAD, vous pouvez ignorer ce message sans risque. Étant donné que vous n’effectuerez aucun commit Git dans ce démarrage rapide, l’état HEAD détaché est approprié.

3 - Configurer le plug-in Maven

Le processus de déploiement sur Azure App Service utilise automatiquement vos informations d’identification Azure dans Azure CLI. Si Azure CLI n’est pas installé localement, le plug-in Maven s’authentifie avec OAuth ou la connexion de l’appareil. Pour plus d’informations, consultez Authentification avec les plug-ins Maven.

Exécutez la commande Maven ci-dessous pour configurer le déploiement. Cette commande vous permet de configurer le système d’exploitation App Service, les versions de Java et Tomcat.

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

Pour Créer une nouvelle configuration d'exécution, tapez Y, puis Entrée.
Pour Define value for OS, tapez 2 pour Linux, puis Entrer.
Pour Définir la valeur de javaVersion, tapez 2 pour Java 17, puis Entrez. Si vous sélectionnez Java 21, vous ne verrez pas Jbosseap comme option ultérieurement.
Pour Définir la valeur pour webContainer, tapez 4 pour Jbosseap 7, puis Entrez.
Pour Définir la valeur du niveau de tarification, tapez 1 pour P1v3, puis Entrer.

Pour Confirmer, tapez Y, puis Entrer.

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] ------------------------------------------------------------------------

Une fois que vous avez confirmé vos choix, le plug-in ajoute les paramètres requis et l’élément de plug-in ci-dessus au fichier pom.xml de votre projet, qui configurent votre application web pour qu’elle s’exécute dans Azure App Service.

La partie pertinente du fichier pom.xml doit ressembler à l’exemple suivant.

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

Vous pouvez modifier les configurations d’App Service directement dans votre pom.xml.

Pour obtenir la liste complète des configurations, consultez Configurations courantes.
Pour les configurations spécifiques à App Service, consultez Application web Azure : détails de configuration.

Faites attention aux valeurs de <appName> et <resourceGroup> (petstoreee7-1745409173307 et petstoreee7-1745409173307-rg en conséquence dans la démo). Ils sont utilisés plus tard.

4 - Déployer l’application

Avec toute la configuration prête dans votre fichier pom.xml, vous pouvez déployer votre application Java sur Azure avec une seule commande.

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

Une fois que vous avez sélectionné dans une liste d’abonnements disponibles, Maven se déploie sur Azure App Service. Une fois le déploiement terminé, votre application est prête. Dans cette démonstration, l’URL est http://petstoreee7-1745409173307.azurewebsites.net. Ouvrez l’URL avec votre navigateur web local, vous devriez voir

Capture d’écran de l’application web Maven Hello World en cours d’exécution dans Azure App Service.

Félicitations ! Vous avez déployé votre première application Java sur App Service.

5 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous n’avez plus besoin de ces ressources, supprimez le groupe de ressources du portail en exécutant la commande suivante dans Cloud Shell :

az group delete --name <your resource group name; for example: petstoreee7-1745409173307-rg> --yes

L’exécution de cette commande peut prendre une minute.

Partager via

1 - Utiliser Azure Cloud Shell

2 - Créer une application Java

3 - Configurer le plug-in Maven

4 - Déployer l’application

5 - Nettoyer les ressources

1 - Utiliser Azure Cloud Shell

2 - Obtenir l’exemple d’application

3 - Configurer le plug-in Maven

4 - Déployer l’application

5 - Nettoyer les ressources

1 - Utiliser Azure Cloud Shell

2 - Créer une application Java

3 - Configurer le plug-in Maven

4 - Déployer l’application

5 - Nettoyer les ressources

Étapes suivantes

Commentaires

Ressources supplémentaires