Déployer une application Java sur Azure Web Apps pour conteneurs à l’aide du Kit de ressources Azure pour IntelliJ

conteneurs Docker sont une méthode largement utilisée pour déployer des applications web. En utilisant des conteneurs Docker, les développeurs peuvent consolider tous leurs fichiers et dépendances de projet dans un package unique pour le déploiement sur un serveur. Le Kit de ressources Azure pour IntelliJ simplifie ce processus pour les développeurs Java en ajoutant des fonctionnalités pour déployer des conteneurs sur Microsoft Azure.

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

Conditions préalables

• Kit de développement Java (JDK) pris en charge. Pour plus d’informations sur les JDK disponibles lors du développement sur Azure, consultez prise en charge de Java sur Azure et Azure Stack.
• IntelliJ IDEA, Ultimate ou Community Edition.
• Kit de ressources Azure pour IntelliJ. Pour plus d’informations, consultez Installer le kit de ressources Azure pour IntelliJ. Vous devez également vous connecter à votre compte Azure pour le Kit de ressources Azure pour IntelliJ. Pour plus d’informations, consultez Instructions de connexion pour Azure Toolkit for IntelliJ.

• Un client Docker.

Remarque

Pour suivre les étapes décrites dans 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 du kit de ressources Azure pour 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é lorsque vous avez cliqué sur Copier&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 Sélectionner des abonnements, sélectionnez les abonnements que vous souhaitez utiliser, puis cliquez sur 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 Nouveau projet, sélectionnez Maven, puis vérifiez que l’option Créer à partir d’Archetype 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. Cela remplira automatiquement le champ ArtifactId de l'application web.
   • GroupId: nom du groupe d’artefacts, généralement un domaine d’entreprise. - par exemple, com.microsoft.azure.
   • version: nous conserverons la version par défaut 1.0-SNAPSHOT.

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

5. Accédez à votre projet sous l’onglet Projet de gauche, 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 registre Azure Container Registry à utiliser comme registre Docker privé

Les étapes suivantes vous guident tout au long de 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 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 paraphrasées dans les étapes suivantes pour plus de rapidité.

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. Lorsque 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 pour votre registre de conteneurs. Sélectionnez l’une des options suivantes :

     • Créer un nouveau: 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 sur Créer.

Déployer votre application web dans un conteneur Docker

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

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

   Cela crée automatiquement un fichier Docker 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, développez Azure, puis cliquez sur Déployer Image sur Web App.

3. Dans la boîte de dialogue Déployer une image sur web App, renseignez les informations suivantes :

   • Nom: spécifie le nom convivial affiché dans le Kit de ressources Azure.

   • Container Registry: créez-en un ou 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 de URL du serveur, nom d’utilisateur et de mot de passe sont automatiquement renseignés.

   • Image et balise: spécifie le nom de l’image conteneur ; En règle générale, cela utilise la syntaxe suivante : <registre>.azurecr.io/<nom d’application>:latest, où :

     • <registre> correspond au registre de conteneurs déterminé dans la section précédente de cet article,
     • <nom d’application> est le nom de votre application web

   • Utiliser une application web existante ou Créer une application web: spécifie si vous allez déployer votre conteneur sur une application web existante ou créer une application web. Le nom de l’application que vous spécifiez crée l’URL de votre application web ; par exemple : wingtiptoys.azurewebsites.net.

   • groupe de ressources: spécifie si vous utiliserez un groupe de ressources existant ou créez un nouveau groupe de ressources.

   • App Service Plan: spécifie si vous utiliserez un App Service Plan existant ou en créerez un nouveau.

4. Une fois que vous avez terminé de configurer les paramètres répertoriés ci-dessus, cliquez sur Exécuter. Lorsque votre application web a été déployée avec succès, l’état s’affiche dans la fenêtre 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 en tant que valeur par défaut, et vous pouvez exécuter votre application sur Azure en cliquant sur l’icône 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 et en cliquant sur Modifier les configurations.

   

2. Lorsque la boîte de dialogue Exécuter/Déboguer des configurations s’affiche, vous pouvez modifier l’un des paramètres par défaut, puis cliquer sur OK.

Étapes suivantes

Pour obtenir des ressources supplémentaires pour Docker, consultez le site web Docker officiel.

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