Déployer une application Java sur Azure Web Apps pour conteneurs à l’aide d’Azure Toolkit for IntelliJ

Les conteneurs Docker constituent une méthode largement utilisée pour déployer des applications web. En utilisant des conteneurs Docker, les développeurs peuvent regrouper tous les fichiers et dépendances de leur projet en un même package pour un déploiement sur un serveur. Azure Toolkit for IntelliJ simplifie ce processus pour les développeurs Java en ajoutant des fonctionnalités permettant de déployer des conteneurs sur Microsoft Azure.

Cet article décrit les étapes requises pour créer une application web Hello World basique et la publier dans un conteneur Linux sur Azure à l’aide du kit de ressources Azure pour IntelliJ.

Prérequis

• Un kit de développement Java (JDK) pris en charge. Pour plus d’informations sur les JDK disponibles pour le développement sur Azure, consultez Prise en charge de Java sur Azure et Azure Stack.
• IntelliJ IDEA, Ultimate ou Community Edition.
• Le kit de ressources Azure pour IntelliJ. Pour plus d’informations, consultez Install the Azure Toolkit for IntelliJ(Installer le Kit de ressources Azure pour IntelliJ). Vous devez également vous connecter à votre compte Azure pour azure Shared Computer Toolkit pour IntelliJ. Pour plus d’informations, consultez les instructions de connexion pour azure Shared Computer Toolkit pour IntelliJ.

• Un client Docker.

Remarque

Pour effectuer les étapes de ce didacticiel, vous devez configurer Docker pour exposer le démon sur le port 2375 sans TLS. Vous pouvez configurer ce paramètre lors de l’installation de Docker ou via le menu des paramètres Docker.

Installation et connexion

Les étapes suivantes vous guident tout au long du processus de connexion à Azure dans votre environnement de développement IntelliJ.

1. Si vous n’avez pas installé le plug-in, consultez Installation d’Azure Toolkit for IntelliJ.

2. Pour vous connecter à votre compte Azure, accédez à la barre latérale de gauche Azure Explorer (Explorateur Azure), puis cliquez sur l’icône Azure Sign In (Connexion à Azure). Vous pouvez aussi accéder à Tools (Outils), développer Azure, puis cliquer sur Azure Sign in (Connexion à Azure).

   

3. Dans la fenêtre Connexion à Azure qui s’affiche, sélectionnez Connexion à l’appareil, puis cliquez sur Connexion (autres options de connexion).

4. Cliquez sur Copy&Open (Copier et ouvrir) dans la boîte de dialogue Azure Device Login.

5. Dans le navigateur, collez le code de votre appareil (qui a été copié quand vous avez cliqué sur Copier et ouvrir à la dernière étape), puis cliquez sur Suivant.

6. Sélectionnez votre compte Azure et effectuez les procédures d’authentification nécessaires pour vous connecter.

7. Une fois connecté, fermez votre navigateur et revenez à votre IDE IntelliJ. Dans la boîte de dialogue Select Subscriptions (Sélectionner des abonnements), sélectionnez les abonnements que vous voulez utiliser, puis cliquez sur Select (Sélectionner).

Création d’un projet d’application web

1. Cliquez sur File (Fichier), développez New (Nouveau), puis cliquez sur Project (Projet).

2. Dans la boîte de dialogue New Project (Nouveau projet), sélectionnez Maven et vérifiez que l’option Create from Archetype (Créer à partir d’un archétype) est cochée. Dans la liste, sélectionnez maven-archetype-webapp, puis cliquez sur Suivant.

   

3. Développez la liste déroulante Artifact Coordinates (Coordonnées de l’artefact) pour voir tous les champs d’entrée et spécifiez les informations suivantes pour votre nouvelle application web, puis cliquez sur Suivant :

   • Nom : nom de votre application web. Le champ ArtifactId de l’application web est renseigné automatiquement.
   • GroupId : nom du groupe d’artefacts, généralement un domaine d’entreprise. (par exemple com.microsoft.azure)
   • Version : nous allons conserver la version par défaut 1.0-SNAPSHOT.

4. Personnalisez les paramètres Maven ou acceptez les valeurs par défaut, puis cliquez sur Finish (Terminer).

5. Accédez à votre projet sous l’onglet Project (Projet), puis ouvrez le fichier src/main/webapp/index.jsp. Remplacez le code existant par le code suivant, puis enregistrez les modifications :

   <html>
    <body>
      <b><% out.println("Hello World!"); %></b>
    </body>
   </html>
   

   

Créer un Azure Container Registry à utiliser comme registre Docker privé

Les étapes suivantes vous guident dans l’utilisation du portail Azure pour créer un registre de conteneurs Azure.

Remarque

Si vous souhaitez utiliser Azure CLI au lieu du portail Azure, suivez les étapes décrites dans Créer un registre de conteneurs Docker privé à l’aide d’Azure CLI 2.0.

1. Accédez au portail Azure et connectez-vous.

   Une fois que vous êtes connecté à votre compte sur le portail Azure, vous pouvez suivre les étapes décrites dans l’article Créer un registre de conteneurs Docker privé à l’aide du portail Azure, qui sont formulées différemment ci-après pour la circonstance.

2. Cliquez sur l’icône de menu pour + Créer une ressource, cliquez sur la catégorie Conteneurs, puis sur Registre de conteneurs.

3. Quand la page Créer un registre de conteneurs s’affiche, spécifiez les informations suivantes :

   • Abonnement : spécifie l’abonnement Azure que vous souhaitez utiliser pour le nouveau registre de conteneurs.

   • Groupe de ressources : spécifie le groupe de ressources de votre registre de conteneurs. Sélectionnez l’une des options suivantes :

     • Créer : spécifie que vous souhaitez créer un groupe de ressources.
     • Utiliser l’existant : spécifie que vous allez opérer un choix dans une liste de groupes de ressources associés à votre compte Azure.

   • Nom du Registre : spécifie le nom du nouveau registre de conteneurs.

   • Emplacement : spécifie la région dans laquelle votre registre de conteneurs sera créé (par exemple, « USA Ouest »).

   • Référence SKU : spécifie le niveau de service de votre registre de conteneurs. Pour ce tutoriel, sélectionnez De base. Pour plus d’informations, consultez Niveaux de service pour Azure Container Registry.

4. Cliquez sur Vérifier + créer et vérifiez que les informations sont correctes. Terminez en cliquant Créer.

Déployer votre application web dans un conteneur Docker

Les étapes suivantes vous guident tout au long de la configuration de la prise en charge de Docker pour votre application web et du déploiement de l’application web sur un conteneur Docker.

1. Accédez à votre projet sous l’onglet Projet à gauche, puis cliquez avec le bouton droit sur votre projet. Développez Azure, puis cliquez sur Ajouter la prise en charge de Docker.

   Un fichier Docker est automatiquement créé avec une configuration par défaut.

   

2. Une fois que vous avez ajouté la prise en charge de Docker, cliquez avec le bouton droit sur votre projet dans l’Explorateur de projets, choisissez Azure, puis cliquez sur Run on Web App for Containers (Exécuter sur Web App pour conteneurs).

3. Dans la boîte de dialogue Exécuter sur Web App pour conteneurs, entrez les informations suivantes :

   • Nom : spécifie le nom convivial qui s’affiche dans le kit de ressources Azure.

   • Registre de conteneurs : choisissez le registre de conteneurs dans le menu déroulant que vous avez créé dans la section précédente de cet article. Les champs Server URL (URL du serveur), Username (Nom d’utilisateur) et Password (Mot de passe) sont renseignés automatiquement.

   • Image et étiquette : spécifie le nom d’image du conteneur ; généralement il utilise la syntaxe suivante : « registre.azurecr.io/nom_app:latest », où :

     • registre correspond au registre de conteneurs déterminé dans la section précédente de cet article,
     • nom_app correspond au nom de votre application web.

   • Utiliser une application web existante ou Créer une application web : spécifie si vous déployez votre conteneur dans une application web existante ou si vous en créez une. Le nom de l’application (App name) que vous indiquez sert à générer l’URL de votre application web ; par exemple : wingtiptoys.azurewebsites.net.

   • Groupe de ressources : spécifie si vous utilisez un groupe de ressources existant ou si vous en créez un.

   • Plan App Service : spécifie si vous utiliserez un plan App Service existant ou créez un plan App Service.

4. Quand vous avez terminé de configurer les paramètres indiqués ci-dessus, cliquez sur Exécuter. Une fois votre application web déployée, l’état s’affiche dans la fenêtre Run (Exécuter).

5. Une fois votre application web publiée, vous pouvez accéder à l’URL spécifiée précédemment pour votre application web, par exemple : wingtiptoys.azurewebsites.net.

   

Facultatif : Modifier les paramètres de publication de votre application web

1. Une fois que vous avez publié votre application web, vos paramètres sont enregistrés comme valeur par défaut, et vous pouvez exécuter votre application sur Azure en cliquant sur l’icône en forme de flèche verte dans la barre d’outils. Vous pouvez modifier ces paramètres en cliquant sur le menu déroulant de votre application web, puis sur Modifier les configurations.

   

2. Quand la boîte de dialogue ExécRun/Debug Configurations s’affiche, vous pouvez modifier les paramètres par défaut de votre choix. Cliquez ensuite sur OK.

Étapes suivantes

Pour obtenir des ressources supplémentaires pour Docker, consultez le Site web de Docker.

Pour signaler des bogues ou demander de nouvelles fonctionnalités, créez des problèmes sur notre dépôt GitHub ou posez des questions sur Stack Overflow avec des balises azure-java-tools.

Pour plus d’informations sur l’utilisation de Java avec Azure, consultez les liens suivants :

• Azure pour les développeurs Java
• Java avec Azure DevOps Services
• Prise en charge de Java sur Azure et Azure Stack