Démarrage rapide : Déployer sur Azure Container Apps à l’aide d’IntelliJ IDEA

Cet article explique comment déployer une application conteneurisée sur Azure Container Apps à l’aide d’Azure Shared Computer Toolkit pour IntelliJ IDEA. L’article utilise un exemple de service d’API web back-end qui retourne une collection statique d’albums de musique.

Prérequis

• Compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• 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.
• Maven 3.5.0+.
• Un client Docker.
• 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 l’Shared Computer Toolkit Azure pour IntelliJ. Pour plus d’informations, consultez les instructions de connexion pour azure Shared Computer Toolkit pour IntelliJ.

Cloner le projet

1. Utilisez les commandes suivantes pour cloner l’exemple d’application et case activée la IDE branche :

   git clone https://github.com/Azure-Samples/containerapps-albumapi-java
   cd containerapps-albumapi-java
   git checkout IDE
   

2. Sélectionnez Ouvrir pour ouvrir le projet dans IntelliJ IDEA.

Générer et exécuter le projet localement

1. Utilisez la commande suivante pour générer le projet avec Maven :

   mvn clean package -DskipTests
   

2. Pour vérifier que l’application est en cours d’exécution, ouvrez un navigateur et accédez à http://localhost:8080/albums. La page retourne une liste d’objets JSON similaires à la sortie de la commande suivante :

   java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
   

Envoyer (push) une image à un registre de conteneurs Azure

Pour déployer votre projet sur Azure Container Apps, vous devez d’abord générer l’image conteneur et l’envoyer (push) vers Azure Container Registry.

1. Dans la vue Explorateur Azure, développez le nœud Azure, cliquez avec le bouton droit sur Registres de conteneurs, puis sélectionnez Créer dans le portail Azure.

2. Dans la page Créer un registre de conteneurs, entrez les informations suivantes :

   • Abonnement : spécifie l’abonnement Azure que vous souhaitez utiliser pour votre 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 Existant : spécifie que vous devez sélectionner dans une liste de groupes de ressources associés à votre compte Azure.
   • Nom du Registre : spécifie un nom pour le nouveau registre de conteneurs.
   • Emplacement : spécifie la région où votre registre de conteneurs est 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.

3. Sélectionnez Vérifier + créer et vérifier que les informations sont correctes. Sélectionnez ensuite Create (Créer).

4. Sous l’onglet Projet , accédez à votre projet et ouvrez Dockerfile.

5. Sélectionnez l’icône Azure, puis sélectionnez Envoyer une image vers Azure Container Registry.

6. Sélectionnez le Registre que vous avez créé à l’étape précédente, renseignez les informations suivantes, puis sélectionnez Exécuter.

   • Nom du référentiel : spécifie le nom du référentiel.
   • Nom de la balise : spécifie la version d’une image ou d’un autre artefact.

   

Créer un environnement et une application conteneur

Procédez comme suit pour configurer votre environnement et déployer une application conteneur dans Azure :

1. Cliquez avec le bouton droit sur Environnement Container Apps dans l’affichage Explorateur Azure, puis sélectionnez Créer un environnement Container Apps.

2. Dans la page Créer un environnement Container Apps, entrez les informations suivantes, puis sélectionnez OK.

   • Abonnement : spécifie l’abonnement Azure que vous souhaitez utiliser.
   • Groupe de ressources : spécifie le groupe de ressources pour vos applications conteneur. Sélectionnez l’une des options suivantes :
     • Créer : spécifie que vous souhaitez créer un groupe de ressources.
     • Utiliser Existant : spécifie que vous devez sélectionner dans une liste de groupes de ressources associés à votre compte Azure.
   • Nom : spécifie le nom du nouvel environnement d’applications conteneur.
   • Région : spécifie la région appropriée (par exemple, USA Est).
   • Espace de travail Log Analytics : spécifie l’espace de travail Log Analytics que vous souhaitez utiliser ou accepter la valeur par défaut.

   

3. Cliquez avec le bouton droit sur l’environnement d’applications conteneur que vous avez créé, puis sélectionnez Créer une>application conteneur dans Azure Explorer. Saisissez les informations suivantes :

   • Abonnement : spécifie l’abonnement Azure que vous souhaitez utiliser.
   • Groupe de ressources : spécifie le groupe de ressources pour vos applications conteneur. Sélectionnez l’une des options suivantes :
     • Créer : spécifie que vous souhaitez créer un groupe de ressources.
     • Utiliser Existant : spécifie que vous devez sélectionner dans une liste de groupes de ressources associés à votre compte Azure.
   • Nom : spécifie le nom d’une nouvelle application conteneur.
   • Région : spécifie la région appropriée (par exemple, USA Est).
   • Environnement : spécifie l’environnement Container Apps que vous souhaitez utiliser.
   • Démarrage rapide : Sélectionnez Utiliser l’image de démarrage rapide.

   

4. Cliquez sur OK. Le kit de ressources affiche un message d’état lorsque la création de l’application réussit.

Déployer l’application de conteneur

1. Sous l’onglet Projet , accédez à votre projet et ouvrez Dockerfile.

   

2. Sélectionnez l’icône Azure, puis sélectionnez Déployer une image dans l’application conteneur.

   

3. Dans la page Déployer une image sur Azure Container Apps , entrez les informations suivantes, puis sélectionnez Exécuter.

   • Dockerfile/Image : spécifie le chemin d’accès du fichier Dockerfile ou accepte la valeur par défaut.
   • Registre de conteneurs : spécifie le registre de conteneurs que vous souhaitez utiliser.
   • Nom du référentiel : spécifie le nom du référentiel que vous souhaitez utiliser sous votre registre de conteneurs.
   • Nom de la balise : spécifie le nom de la balise que vous souhaitez utiliser sous votre registre de conteneurs.
   • Application conteneur : spécifie l’application conteneur sur laquelle vous souhaitez effectuer le déploiement.
   • Entrée : activez l’entrée pour les applications qui nécessitent un point de terminaison HTTP ou TCP. Sélectionnez Activer.
   • Trafic externe : activez le trafic externe pour les applications qui ont besoin d’un point de terminaison HTTP ou TCP. Sélectionnez Activer.
   • Port cible : définissez cette valeur sur le numéro de port utilisé par votre conteneur. Ouvrez le port 8080 à cette étape.

   

4. Une fois le déploiement terminé, l’Shared Computer Toolkit Azure pour IntelliJ affiche une notification. Sélectionnez Parcourir pour ouvrir l’application déployée dans un navigateur.

   

Dans la barre d’adresses du navigateur, ajoutez le /albums chemin d’accès à la fin de l’URL de l’application pour afficher les données à partir d’un exemple de demande d’API.

Nettoyer les ressources

Si vous souhaitez propre et supprimer une ressource Azure Container Apps, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources efface également les autres ressources qui y sont associées. Procédez comme suit pour propre ressources :

1. Pour supprimer vos ressources Azure Container Apps, accédez à la barre latérale d’Azure Explorer de gauche et recherchez l’élément Container Apps Environment.

2. Cliquez avec le bouton droit sur le service Azure Container Apps que vous souhaitez supprimer, puis sélectionnez Supprimer.

3. Pour supprimer votre groupe de ressources, visitez le Portail Azure et supprimez manuellement les ressources sous votre abonnement.

Étapes suivantes

• Vue d’ensemble de Java sur Azure Container Apps