Enterprise Distributed Application Service:Deploy an application to a Kubernetes cluster from IntelliJ IDEA

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Java Development Kit (JDK) 1,8 ou version ultérieure

• IntelliJ IDEA 2018.3 ou version ultérieure

• Une application déployée dans un cluster ACK. Pour les instructions de configuration, consultez Utiliser une image pour déployer une application de microservices Java dans un cluster Kubernetes

• Une paire AccessKey (AccessKey ID et AccessKey Secret) pour votre compte Alibaba Cloud, ou un utilisateur Resource Access Management (RAM) disposant des autorisations de déploiement EDAS

Le serveur de plug-ins JetBrains est hébergé hors de Chine continentale. Si vous ne pouvez pas télécharger le plug-in en raison d'une lenteur du réseau, rejoignez le groupe DingTalk indiqué à la fin de cette rubrique pour obtenir le package d'installation hors ligne auprès du support technique d'Alibaba Cloud Toolkit.

Si vous utilisez un utilisateur RAM, celui-ci doit être synchronisé avec EDAS et autorisé à déployer des applications. Consultez Autoriser un utilisateur RAM pour EDAS pour les instructions de configuration.

Étape 1 : Installer Alibaba Cloud Toolkit

1. Ouvrez IntelliJ IDEA.

2. Accédez aux paramètres des plug-ins :

   • macOS : choisissez IntelliJ IDEA > Preferences > Plugins.

   • Windows : choisissez File > Settings > Plugins.

3. Dans la zone de recherche, saisissez Alibaba Cloud Toolkit et cliquez sur l'icône de recherche.

4. Cliquez sur Install.

   

   

5. Redémarrez IntelliJ IDEA. Après le redémarrage, l'icône Alibaba Cloud Toolkit apparaît dans la barre d'outils.

Si le plug-in est déjà installé, mettez-le à jour vers la dernière version via la même page de paramètres Plugins .

Étape 2 : Configurer votre compte Alibaba Cloud

Configurez votre paire AccessKey afin que le plug-in puisse accéder à EDAS en votre nom.

1. Dans IntelliJ IDEA, choisissez Tools > Alibaba Cloud > Preferences.

2. Dans le volet de navigation de gauche, choisissez Alibaba Cloud Toolkit > Accounts.

3. Saisissez votre Access Key ID et votre Access Key Secret, puis cliquez sur OK.

   

Obtenir votre paire AccessKey :

• Si vous disposez d'un compte Alibaba Cloud, cliquez sur Get existing AK/SK dans la page Accounts. Connectez-vous et récupérez votre AccessKey ID et votre AccessKey Secret depuis la page de gestion des AccessKey.

• Si vous ne possédez pas de compte, cliquez sur Sign up pour en créer un, puis récupérez votre paire AccessKey.

Si votre service EDAS s'exécute sur Apsara Stack Enterprise, configurez un endpoint avant de continuer. Consultez Configurer un endpoint pour Apsara Stack Enterprise .

Étape 3 : Déployer votre application

1. Dans IntelliJ IDEA, choisissez Tools > Alibaba Cloud > Deploy to EDAS > EDAS for Kubernetes Application. Vous pouvez également choisir Run > Edit Configurations. Dans la boîte de dialogue Run/Debug configurations, choisissez Templates > EDAS on Alibaba Cloud > EDAS for Kubernetes Application.

2. Dans l'onglet Settings de la boîte de dialogue Deploy to EDAS, définissez les paramètres suivants :

   Important

   Si l'application n'apparaît pas dans la liste, consultez Autoriser un utilisateur RAM pour EDAS.

   Paramètre	Description
   Region	La région où l'application est déployée.
   Namespace	Le namespace de microservices où l'application est déployée.
   Application	Le nom de l'application.

   

3. Sélectionnez une méthode de déploiement :

   Méthode	Description
   Maven Build	Ajoute une tâche de build Maven pour créer le package de déploiement. Pour les projets multi-modules, consultez Déployer un projet multi-module.
   Upload File	Télécharge un package WAR ou JAR pour le déploiement.
   Build Image	Construit une image de conteneur à partir d'un Dockerfile. Définissez le Context Directory, le chemin du Dockerfile et la Version de l'image.
   Select Image	Déploie à partir d'une image de conteneur existante sélectionnée dans la liste déroulante Select Image.

   

4. (Facultatif) Cliquez sur l'onglet Advanced pour configurer des paramètres de déploiement supplémentaires. Pour tous les détails sur les paramètres, consultez la référence API DeployK8sApplication.

   • Application Environment : définissez l'environnement d'exécution. Spécifiez une nouvelle PackageVersion à chaque déploiement.

   • Startup Command : spécifiez la commande et les arguments à exécuter au démarrage du conteneur.

   • Environments : définissez les variables d'environnement pour l'application.

   • Persistence : configurez les volumes de stockage persistants.

   • Storage : configurez le stockage local.

   • Application Management : définissez les hooks de cycle de vie et les sondes de santé :

     Paramètre	Description
     Poststart	Un hook de cycle de vie du conteneur déclenché après la création d'un conteneur. Si le gestionnaire échoue, le conteneur est arrêté et la politique de redémarrage détermine s'il faut le redémarrer.
     PreStop	Un hook de cycle de vie du conteneur déclenché avant la suppression d'un conteneur. Le gestionnaire s'exécute avant que la demande de suppression n'atteigne le daemon Docker. Le daemon envoie un signal SIGTERM quel que soit le résultat du gestionnaire.
     Liveness	Une sonde de santé qui vérifie l'état de l'application. Si l'application n'est pas saine, Kubernetes supprime et recrée le conteneur.
     Readiness	Une sonde de santé qui vérifie si l'application a démarré et s'exécute comme prévu. Si l'application ne peut pas s'exécuter comme prévu, le statut du conteneur est mis à jour.

   

5. Cliquez sur Apply, puis sur Run. Vérifiez le journal de déploiement dans l'onglet Console d'IntelliJ IDEA pour confirmer le résultat.

Déployer un projet multi-module

Pour les projets Maven multi-modules, la dernière tâche Maven dans la section Before launch doit compiler le sous-module que vous souhaitez déployer.

Exemple : Le projet CarShop possède la structure suivante :

carshop
├── itemcenter-api
├── itemcenter
├── detail

Les modules itemcenter et detail dépendent tous deux de itemcenter-api. Pour déployer le sous-module itemcenter, ajoutez ces deux tâches Maven à la section Before launch :

1. Exécutez mvn clean install dans le projet parent CarShop.

2. Exécutez mvn clean package dans le sous-module itemcenter.

Autoriser un utilisateur RAM pour EDAS

Si un utilisateur RAM ne voit pas les applications dans la liste de déploiement, cela signifie qu'il n'est pas synchronisé avec EDAS ou qu'il ne dispose pas des autorisations requises. Choisissez l'une des approches suivantes pour accorder l'accès.

Configurer un endpoint pour Apsara Stack Enterprise

Si votre service EDAS s'exécute sur Apsara Stack Enterprise, configurez un endpoint dans Alibaba Cloud Toolkit avant le déploiement. Contactez le support technique EDAS pour obtenir la valeur de l'endpoint.

1. Dans la boîte de dialogue Preference (Filtered), choisissez Appearance & Behavior > Endpoint.

2. Saisissez la valeur de l'endpoint et cliquez sur Apply and Close.