Déployer votre application web sur Azure App Service

5 minutes

Deux objectifs pour les développeurs Java sont les suivants : le premier consiste à faciliter la gestion et la configuration du plug-in Azure App Service, et le second consiste à simplifier le déploiement de projets Maven sur Azure App Service. Dans l’exercice précédent, vous avez créé un exemple rapide d’application web Java « hello world » et l’avez testé localement. L’ajout du plug-in Maven pour Azure App Service à votre projet vous permet de déployer votre application sur Azure App Service.

Dans cette unité, vous allez examiner les options permettant à votre entreprise d’héberger ses applications sur Azure App Service, puis vous allez apprendre à ajouter et à configurer l’application azure-webapp-maven-plugin à votre projet Maven.

Présentation d’Azure App Service

Azure App Service vous permet d’héberger les sites web de votre entreprise, les applications web, les API REST et d’autres codes d’application sur Azure. Votre code de projet s’exécute dans le cloud ; vous n’avez pas besoin de provisionner ou de configurer une infrastructure. L’exécution de votre application web dans Azure App Service vous offre tous les avantages de l’exécution sur Azure : votre application est disponible à l’échelle mondiale, elle est mise à l’échelle automatiquement, intègre la sécurité et la conformité, et vous payez uniquement pour les ressources que vous utilisez.

Azure App Service prend en charge plusieurs langages de programmation, ce qui permet aux développeurs de continuer à écrire leurs applications à l’aide des langages avec lesquels ils sont les plus confortables. Java est un citoyen de première classe, ainsi que d’autres langages tels que .NET Core, Python, Node.js, etc. Vous pouvez héberger les applications web que vous créez sur Linux, Windows ou à l’intérieur d’un conteneur Docker. Avant de déployer votre application web sur Azure, vous allez créer un plan App Service sur Azure qui spécifie le système d’exploitation et le niveau tarifaire, qui détermine la taille des ressources de calcul approvisionnées dont votre application a besoin.

Flux de travail Maven

Maven a trois cycles de vie intégrés pour la création de projets : default, cleanet site, où le default cycle de vie inclut les phases suivantes :

Étape	Descriptif
`compile`	Compile votre code
`package`	Empaquette votre code dans un fichier JAR ou WAR
`install`	Installe le package dans votre référentiel local
`deploy`	Copie le package final dans votre référentiel distant

Toutefois, lorsque vous utilisez le plug-in Maven pour Azure App Service, vous n’utiliserez pas la phase de déploiement incluse dans le cycle de vie de default Maven. Au lieu de cela, vous allez déployer votre application sur Azure avec la mvn azure-webapp:deploy commande.

Ajout du plug-in Maven pour Azure App Service à votre projet

Pour ajouter le plug-in Maven pour Azure App Service à votre application web, vous devez insérer le code XML de azure-webapp-maven-plugin dans le fichier pom.xml de votre projet, comme suit :

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>2.13.0</version>
</plugin>

Toutefois, le plug-in offre un moyen pratique et interactif d’ajouter des configurations à votre fichier POM :

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

Le plug-in vous invite à entrer les informations nécessaires pour configurer le plan App Service. Une fois que vous avez confirmé vos choix, le plug-in ajoute l’élément de plug-in précédent et les paramètres requis au fichier de pom.xml votre projet qui configure votre application web pour qu’elle s’exécute dans Azure App Service.

Remarque

Consultez le plug-in Maven pour la documentation Azure App Service ou le référentiel central Maven pour plus d’informations sur la dernière version du plug-in Maven.

Options de configuration

La section précédente de cette unité a montré l’utilisation interactive du plug-in Maven pour Azure App Service pour configurer votre application web. Toutefois, vous n’avez pas besoin d’exécuter la configuration de manière interactive. Si vous le souhaitez, vous pouvez ajouter manuellement le code XML du plug-in au fichier de pom.xml votre projet.

L’extrait annoté suivant d’un pom.xml fichier illustre certains des paramètres requis :

<plugin> 
  <groupId>com.microsoft.azure</groupId>  
  <artifactId>azure-webapp-maven-plugin</artifactId>  
  <version>2.13.0</version>  
  <configuration> 
    <schemaVersion>v2</schemaVersion>  
    <subscriptionId>aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e</subscriptionId>  
    <resourceGroup>learn-9c627899-58ae-4ef5-9630-3336ec7bce0c</resourceGroup>  
    <appName>MyWebApp-1610102860270</appName>  
    <pricingTier>S1</pricingTier>  
    <region>westus</region>  
    <runtime> 
      <os>Linux</os>  
      <javaVersion>Java 17</javaVersion>  
      <webContainer>Tomcat 10.0</webContainer> 
    </runtime>  
    <deployment> 
      <resources> 
        <resource> 
          <directory>${project.basedir}/target</directory>  
          <includes> 
            <include>*.war</include> 
          </includes> 
        </resource> 
      </resources> 
    </deployment> 
  </configuration> 
</plugin>

Certaines des options de configuration pertinentes se trouvent dans le tableau suivant. Pour obtenir la liste complète des options, consultez la documentation du plug-in Maven pour Azure App Service.

Étiquette	Paramètres
`<javaVersion>`	Linux prend en charge les versions 8, 11 et 17 Windows prend en charge les versions 8, 11 et 17
`<webContainer>`	Linux prend en charge Tomcat, JBoss EAP 7.2 et Java SE Windows prend en charge Tomcat et Java SE
`<resource>`	Spécifie l’emplacement du fichier WAR ou JAR dans le projet

Options de déploiement

Si vous avez déjà créé un plan App Service, vous pouvez spécifier les paramètres de ce plan dans votre pom.xml fichier. Lorsque vous déployez votre application web sur Azure, Maven utilise ces paramètres pour déployer votre nouvelle application dans le plan App Service existant.

<!-- Deploy Web App to the existing App Service Plan -->
<appServicePlanResourceGroup>${PLAN_RESOURCEGROUP_NAME}</appServicePlanResourceGroup>
<appServicePlanName>${PLAN_NAME}</appServicePlanName>

Une autre option consiste à autoriser azure-webapp-maven-plugin à créer le plan App Service pour vous lors de la configuration interactive du plug-in. Cette option est le comportement par défaut du plug-in si vous ne spécifiez pas de plan App Service existant dans votre pom.xml fichier.

Que vous choisissiez de créer le plan App Service de manière interactive ou manuelle, vous utilisez la même commande Maven pour déployer votre code d’application sur Azure :

mvn package azure-webapp:deploy

Dans l’exercice suivant, vous allez déployer votre application web sur Azure App Service.