Use the Alibaba Cloud Toolkit for IntelliJ IDEA plug-in to deploy an application - Serverless App Engine

Outre le déploiement d'applications depuis la console Serverless App Engine (SAE), vous pouvez utiliser le plug-in Alibaba Cloud Toolkit pour IntelliJ IDEA (Cloud Toolkit).

Prérequis

Téléchargez et installez JDK 1.8 ou version ultérieure.
Téléchargez et installez IntelliJ IDEA 2018.3 ou version ultérieure.

Remarque
Les serveurs de plug-ins officiels de JetBrains sont situés en dehors de la Chine continentale. En cas de lenteurs de téléchargement ou d'échecs d'installation,

contactez-nous

.
Installez et configurez Cloud Toolkit dans IntelliJ IDEA.

.

Contexte

Cloud Toolkit est un plug-in IDE gratuit fourni par Alibaba Cloud. Créez un compte Alibaba Cloud ou utilisez un compte existant pour télécharger et installer gratuitement Cloud Toolkit dans IntelliJ IDEA.

Après avoir développé, débogué et testé votre application localement, utilisez ce plug-in pour la déployer rapidement sur Serverless App Engine (SAE).

Déployer une application sur SAE

Cloud Toolkit permet de déployer des applications sur SAE sous forme de package WAR, de package JAR ou d'image.

Dans le volet Project situé à gauche d'IntelliJ IDEA, cliquez avec le bouton droit sur le projet à déployer, puis sélectionnez Alibaba Cloud > Deploy to SAE... dans le menu contextuel.

Dans la boîte de dialogue Deploy to SAE, configurez les paramètres de déploiement de l'application, puis cliquez sur Apply.

Le tableau suivant décrit les paramètres.

Parameter	Description
Region	Région de l'application.
Namespace	Namespace de l'application.
Application	Nom de l'application.
Build	Maven Build : construit l'application à l'aide de Maven. Par défaut, un objectif Maven est ajouté pour générer le package de déploiement. Upload File : construit l'application à partir d'un package WAR ou JAR que vous téléchargez. Image : construit l'application à partir d'une image de conteneur. L'adresse de l'image est requise pour le déploiement. Gradle Build : non pris en charge.

Facultatif : Dans la boîte de dialogue Deploy to SAE, cliquez sur Advanced pour configurer les paramètres avancés de l'application.

Remarque

Si vous ne configurez pas les paramètres avancés, le déploiement utilise par défaut les paramètres de la

console SAE

Le tableau suivant décrit les paramètres.

Type	Parameter	Example value	Description
Déploiement de package JAR	Package Version	1.0.1	Version de l'application déployée.
	JDK	Open JDK 8	Version du JDK dont dépend l'application.
	Web Container	apache-tomcat-7.0.91	Version de Tomcat dont dépend l'application.
Paramètres de commande de démarrage	Jar Start Options	custom-option	Options de démarrage pour le package JAR de l'application. La commande de démarrage par défaut est : `$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs`
Paramètres de commande de démarrage	Jar Start Args	custom-args	Arguments de démarrage pour le package JAR de l'application. La commande de démarrage par défaut est : `$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs`
Paramètres de stratégie de déploiement	Update Strategy	{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}	Stratégie de déploiement. Exemples : Exemple 1 : un déploiement canari pour une instance, suivi d'un déploiement par lots en deux lots automatiques avec un intervalle d'une minute entre les lots. `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}` Exemple 2 : un déploiement par lots en deux lots automatiques sans intervalle entre les lots. `{"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}`
Paramètres de liaison d'hôtes	Custom Host Alias	[{"hostName":"samplehost","ip":"127.0.0.1"}]	Mappages d'hôtes personnalisés dans le conteneur.
Paramètres de vérification de l'état de l'application	Liveness	{"exec":{"command":["sleep","5s"]},"initialDelaySeconds":10,"timeoutSeconds":11}	Vérification de l'état actif (liveness) du conteneur. Si un conteneur échoue à cette vérification, le système le termine et le redémarre. Actuellement, seules les vérifications basées sur des commandes sont prises en charge : `{"exec":{"command":["sleep","5s"]},"initialDelaySeconds":10,"timeoutSeconds":11}`
Paramètres de vérification de l'état de l'application	Readiness	{"exec":{"command":["sleep","6s"]},"initialDelaySeconds":15,"timeoutSeconds":12}	Vérification de l'état de préparation (readiness) de l'application. Si un conteneur échoue répétitivement à cette vérification, le système le termine et le redémarre. Les conteneurs qui échouent à cette vérification ne reçoivent pas le trafic des instances Server Load Balancer (SLB).
Paramètres de déploiement	Min Ready Instances	1	Nombre minimal d'instances actives pour l'application.
Paramètres de déploiement	Batch Wait Time	10	Temps d'attente entre les lots pour un déploiement par lots, en secondes.
Paramètres de variable d'environnement	Envs	[{"name":"envtmp","value":"0"}]	Variables d'environnement pour le conteneur.

Cliquez sur Run.
Vérifiez le succès du déploiement de l'application de l'une des manières suivantes :
- Le journal d'exécution dans le volet Console d'IntelliJ IDEA affiche le message BUILD SUCCESS.
- L'enregistrement des modifications pour l'application sur la console SAE indique Success.

Gérer les tâches de build Maven

Sur la page Deploy to SAE, vous pouvez ajouter, supprimer, modifier et déplacer des tâches de build Maven dans la section Before launch.

Dans le volet Project situé à gauche d'IntelliJ IDEA, cliquez avec le bouton droit sur le projet à déployer, puis sélectionnez Alibaba Cloud > Deploy to SAE... dans le menu contextuel.
Dans la section Before launch de la page Deploy to SAE, gérez les tâches Maven.
- Ajouter une tâche
  1. Cliquez sur l'icône Before launch Run Maven Goal
    
    située à droite de la section, puis sélectionnez une option dans la liste déroulante.
  2. Dans la boîte de dialogue Select Maven Goal, sélectionnez un module pour le projet actuel et saisissez la commande de build dans le champ Command line.
  3. Cliquez sur OK.
- Supprimer une tâche : sélectionnez la tâche à supprimer et cliquez sur l'icône Before launch
  
  située à droite de la section.
- Modifier une tâche : sélectionnez la tâche à modifier, cliquez sur l'icône Before launch Select Maven Goal
  
  située à droite de la section, mettez à jour les informations de la tâche dans la boîte de dialogue, puis cliquez sur OK.
- Déplacer une tâche : sélectionnez la tâche à déplacer, puis cliquez sur l'icône Before launch
  
  ou
  
  située à droite de la section pour modifier l'ordre d'exécution.

Déployer un projet multi-modules

Un projet multi-modules contient des modules développés indépendamment mais interdépendants. Vous pouvez utiliser Cloud Toolkit pour déployer un sous-module spécifique d'un projet multi-modules.

Pour déployer un sous-module d'un projet Maven multi-modules, vous devez déplacer la tâche de build de ce sous-module à la fin de la liste dans la section Before launch de la page Deploy to SAE.

Les projets multi-modules constituent une structure de projet courante. Le plug-in toolkit-maven-plugin prend en charge les deux méthodes suivantes pour déployer des projets multi-modules.

Méthode 1 : exécuter les commandes de packaging et de déploiement dans le projet parent.

Cette méthode nécessite toolkit-maven-plugin 1.0.3 ou version ultérieure.

Lorsque vous exécutez la commande toolkit:deploy dans le projet parent, ajoutez le paramètre -Ddeploy_artifacts pour spécifier les ID d'artefact des sous-modules à déployer. Pour déployer plusieurs sous-modules, séparez les ID d'artefact par une virgule (,).

Par exemple, un projet CarShop contient les sous-modules suivants :
```
carshop
   itemcenter-api
   itemcenter

   detail
```
Pour déployer simultanément les sous-modules itemcenter et detail, exécutez la commande suivante dans le répertoire carshop :
```
mvn clean package toolkit:deploy -Ddeploy_artifacts=itemcenter,detail
```
Par défaut, le plug-in déploie les applications en fonction des fichiers .edas_config.yaml situés dans les répertoires des modules itemcenter et detail. Vous pouvez également ajouter le paramètre -Dedas_config pour spécifier un fichier de configuration.
Méthode 2 : exécuter les commandes de packaging et de déploiement dans le sous-module. Cette méthode est prise en charge par toutes les versions de toolkit-maven-plugin.

Tout d'abord, exécutez la commande install dans le projet parent pour installer les dépendances des sous-modules dans le dépôt Maven local. Ensuite, accédez au répertoire du sous-module que vous souhaitez déployer et exécutez la commande toolkit:deploy.