Démarrage rapide : Créer une application Java dans Azure App Service sur WindowsQuickstart: Create a Java app on Azure App Service on Windows

Notes

Cet article explique comment déployer une application sur App Service sous Windows.This article deploys an app to App Service on Windows. Pour déployer une application App Service sur Linux, consultez Créer une application web Java sur Linux.To deploy to App Service on Linux, see Create Java web app on Linux.

Azure App Service offre un service d’hébergement web hautement évolutif appliquant des mises à jour correctives automatiques.Azure App Service provides a highly scalable, self-patching web hosting service. Ce guide de démarrage rapide montre comment utiliser l’interface Azure CLI avec le plug-in Maven pour Azure App Service afin de déployer un fichier WAR (archive web) Java.This quickstart shows how to use the Azure CLI with the Maven Plugin for Azure App Service to deploy a Java web archive (WAR) file.

Notes

Vous pouvez également le faire à l’aide d’IDE couramment utilisés comme IntelliJ et Eclipse.The same thing can also be done using popular IDEs like IntelliJ and Eclipse. Consultez nos documents similaires dans le Guide de démarrage d’Azure Toolkit for IntelliJ ou le Guide de démarrage rapide d’Azure Toolkit for Eclipse.Check out our similar documents at Azure Toolkit for IntelliJ Quickstart or Azure Toolkit for Eclipse Quickstart.

Exemple d’application s’exécutant dans Azure

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

Utiliser Azure Cloud ShellUse Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell vous permet d’utiliser bash ou PowerShell pour travailler avec les services Azure.Cloud Shell lets you use either bash or PowerShell to work with Azure services. 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.You can use the Cloud Shell pre-installed commands to run the code in this article without having to install anything on your local environment.

Pour lancer Azure Cloud Shell :To launch Azure Cloud Shell:

OptionOption Exemple/LienExample/Link
Sélectionnez Essayer dans le coin supérieur droit d’un bloc de code.Select Try It in the upper-right corner of a code block. La sélection de Essayer ne copie pas automatiquement le code dans Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemple Essayer pour Azure Cloud Shell
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur.Go to https://shell.azure.com or select the Launch Cloud Shell button to open Cloud Shell in your browser. Lancer Cloud Shell dans une nouvelle fenêtreLaunch Cloud Shell in a new window
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Bouton Cloud Shell du portail Azure

Pour exécuter le code de cet article dans Azure Cloud Shell :To run the code in this article in Azure Cloud Shell:

  1. Lancez Cloud Shell.Launch Cloud Shell.

  2. Sélectionnez le bouton Copier dans un bloc de code pour copier le code.Select the Copy button on a code block to copy the code.

  3. Collez le code dans la session Cloud Shell avec Ctrl+Maj+V sur Windows et Linux, ou Cmd+ Maj+V sur macOS.Paste the code into the Cloud Shell session with Ctrl+Shift+V on Windows and Linux, or Cmd+Shift+V on macOS.

  4. Appuyez sur Entrée pour exécuter le code.Press Enter to run the code.

Créer une application JavaCreate a Java app

Exécutez la commande Maven suivante dans l’invite Cloud Shell pour créer une application nommée helloworld :Execute the following Maven command in the Cloud Shell prompt to create a new app named helloworld:

mvn archetype:generate -DgroupId=example.demo -DartifactId=helloworld -DarchetypeArtifactId=maven-archetype-webapp

Configurer le plug-in MavenConfigure the Maven plugin

Pour un déploiement à partir de Maven, utilisez l’éditeur de code dans Cloud Shell pour ouvrir le fichier de projet pom.xml dans le répertoire helloworld.To deploy from Maven, use the code editor in the Cloud Shell to open up the project pom.xml file in the helloworld directory.

code pom.xml

Ajoutez ensuite la définition de plug-in suivante dans l’élément <build> du fichier pom.xml.Then add the following plugin definition inside the <build> element of the pom.xml file.

<plugins>
    <!--*************************************************-->
    <!-- Deploy to Tomcat in App Service Windows         -->
    <!--*************************************************-->
    <plugin>
        <groupId>com.microsoft.azure</groupId>
        <artifactId>azure-webapp-maven-plugin</artifactId>
        <version>1.7.0</version>
        <configuration>
            <!-- Specify v2 schema -->
            <schemaVersion>v2</schemaVersion>
            <!-- App information -->
            <subscriptionId>SUBSCRIPTION_ID</subscriptionId>
            <resourceGroup>RESOURCEGROUP_NAME</resourceGroup>
            <appName>WEBAPP_NAME</appName>
            <region>REGION</region>
            <!-- Java Runtime Stack for App Service on Windows-->
            <runtime>
                <os>windows</os>
                <javaVersion>1.8</javaVersion>
                <webContainer>tomcat 9.0</webContainer>
            </runtime>
            <deployment>
                <resources>
                    <resource>
                        <directory>${project.basedir}/target</directory>
                        <includes>
                            <include>*.war</include>
                        </includes>
                    </resource>
                </resources>
            </deployment>
        </configuration>
    </plugin>
</plugins>

Notes

Dans cet article, nous travaillons uniquement avec des applications Java empaquetées dans des fichiers WAR.In this article we are only working with Java apps packaged in WAR files. Le plug-in prend également en charge les applications web JAR. Accédez à la section Déployer un fichier JAR SE Java sur App Service dans Linux pour l’essayer.The plugin also supports JAR web applications, visit Deploy a Java SE JAR file to App Service on Linux to try it out.

Mettez à jour les espaces réservés suivants dans la configuration du plug-in :Update the following placeholders in the plugin configuration:

PlaceholderPlaceholder DescriptionDescription
SUBSCRIPTION_ID ID unique de l’abonnement dans lequel vous voulez déployer votre application.The unique ID of the subscription you want to deploy your app to. Vous pouvez trouver l’ID de l’abonnement par défaut dans Cloud Shell ou dans l’interface CLI à l’aide de la commande az account show.Default subscription's ID can be found from the Cloud Shell or CLI using the az account show command. Pour connaître tous les abonnements disponibles, utilisez la commande az account list.For all the available subscriptions, use the az account list command.
RESOURCEGROUP_NAME Nom du nouveau groupe de ressources dans lequel créer votre application.Name for the new resource group in which to create your app. En plaçant toutes les ressources d’une application dans un groupe, vous pouvez les gérer ensemble.By putting all the resources for an app in a group, you can manage them together. Par exemple, si vous supprimez le groupe de ressources, vous supprimez également toutes les ressources associées à l’application.For example, deleting the resource group would delete all resources associated with the app. Mettez à jour cette valeur avec un nouveau nom de groupe de ressources unique, par exemple, myResourceGroup.Update this value with a unique new resource group name, for example, myResourceGroup. Vous utiliserez ce nom de groupe de ressources pour nettoyer toutes les ressources Azure dans une section ultérieure.You will use this resource group name to clean up all Azure resources in a later section.
WEBAPP_NAME Le nom d’application fera partie du nom d’hôte pour l’application lors du déploiement vers Azure (WEBAPP_NAME.azurewebsites.net).The app name will be part of the host name for the app when deployed to Azure (WEBAPP_NAME.azurewebsites.net). Mettez à jour cette valeur avec un nom unique pour la nouvelle application App Service, qui va héberger votre application Java (par exemple, contoso).Update this value with a unique name for the new App Service app, which will host your Java app, for example contoso.
REGION Une région Azure où l’application est hébergée, par exemple westus2.An Azure region where the app is hosted, for example westus2. Vous pouvez obtenir une liste de régions à partir du Cloud Shell ou de l’interface CLI à l’aide de la commande az account list-locations.You can get a list of regions from the Cloud Shell or CLI using the az account list-locations command.

Déployer l’applicationDeploy the app

Déployez votre application Java sur Azure à l’aide de la commande suivante :Deploy your Java app to Azure using the following command:

mvn package azure-webapp:deploy

Une fois le déploiement terminé, accédez à l’application déployée à l’aide de l’URL suivante dans votre navigateur web. Par exemple : http://<webapp>.azurewebsites.net/.Once deployment has completed, browse to the deployed application using the following URL in your web browser, for example http://<webapp>.azurewebsites.net/.

Exemple d’application s’exécutant dans Azure

Félicitations !Congratulations! Vous avez déployé votre première application Java sur App Service sur Windows.You've deployed your first Java app to App Service on Windows.

Supprimer des ressourcesClean up resources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources.In the preceding steps, you created Azure resources in a resource group. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, supprimez le groupe de ressources en exécutant la commande suivante dans Cloud Shell :If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

L’exécution de cette commande peut prendre une minute.This command may take a minute to run.

Étapes suivantesNext steps