Les variables d'environnement dissocient la configuration du code de l'application, ce qui permet de personnaliser le comportement à l'exécution selon les environnements sans redéploiement. Elles garantissent également que les données sensibles, telles que les identifiants de base de données et les clés API, ne figurent pas dans votre code source.
Informations générales
EDAS prend en charge trois types de variables d'environnement pour les applications déployées sur des clusters Kubernetes :
|
Type |
Description |
Cas d'utilisation |
|
Custom |
Paires clé-valeur que vous définissez directement |
Paramètres spécifiques à l'application, tels que |
|
ConfigMap |
Références aux entrées Kubernetes ConfigMap |
Configuration partagée et non sensible entre plusieurs applications |
|
Secret |
Références aux entrées Kubernetes Secret |
Mots de passe, certificats, clés API |
Les ConfigMaps et les Secrets doivent se trouver dans la même région, le même cluster et le même namespace Kubernetes que l'application qui les référence.
Pour créer un ConfigMap, consultez la rubrique Créer un élément de configuration. Pour créer un Secret, consultez la rubrique Créer un Secret.
Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
Un compte EDAS avec accès à la console EDAS
Un cluster Kubernetes créé dans EDAS
(Facultatif) Un ConfigMap ou un Secret dans la même région, le même cluster et le même namespace Kubernetes que votre application
Ajouter des variables d'environnement
Vous pouvez configurer les variables d'environnement lors de la création d'une application ou lors du déploiement d'une application existante. Dans les deux cas, les variables sont transmises au conteneur au démarrage.
L'enregistrement des modifications apportées aux variables d'environnement entraîne le redémarrage de l'application. Configurez les variables d'environnement pendant les heures creuses afin de minimiser l'impact.
Ajouter des variables lors de la création d'une application
Connectez-vous à la console EDAS.
Dans la barre de navigation supérieure, sélectionnez une région. Dans la partie supérieure de la page, sélectionnez un namespace.
Dans le coin supérieur gauche, cliquez sur Create Application.
À l'étape Basic Information , définissez le paramètre Cluster Type sur Kubernetes Clusters et sélectionnez votre Application Runtime Environment (consultez la section Options d'exécution de l'application), puis cliquez sur Next.
À l'étape Configurations , configurez les informations relatives à l'environnement, les informations de base, la méthode de déploiement et les paramètres de ressources, puis cliquez sur Next.
À l'étape Advanced Settings , cliquez sur Environment Variables et ajoutez des variables en utilisant l'une des méthodes décrites dans la section Méthodes de configuration des variables.
Cliquez sur Create Application.
Sur la page Creation Completed , vérifiez les paramètres dans les sections Basic Information , Configurations et Advanced Settings , puis cliquez sur Create Application.
Sur la page Application Overview , cliquez sur View Details. Sur la page Change List , surveillez la progression du déploiement. Une fois la modification terminée, vérifiez que l'état du pod dans la section Basic Information indique que le pod est en cours d'exécution.
Ajouter des variables lors du déploiement d'une application
Si vous n'avez pas configuré les variables d'environnement lors de la création de l'application, ajoutez-les lors du déploiement ou du redéploiement de celle-ci.
Connectez-vous à la console EDAS.
Dans la barre de navigation supérieure, sélectionnez une région. Dans la partie supérieure de la page, sélectionnez un namespace.
Dans la liste déroulante Cluster Type , sélectionnez Container Service or Serverless Kubernetes Cluster.
Recherchez l'application cible et cliquez sur son nom.
Sur la page Overview ou Basic information , choisissez Deploy > Deploy dans le coin supérieur droit.
Sur la page Select Deployment Mode , sélectionnez un mode de déploiement et cliquez sur Start Deployment.
Définissez l'environnement d'exécution et le package de déploiement, puis cliquez sur Environment Variables pour ajouter des variables en utilisant l'une des méthodes décrites dans la section Méthodes de configuration des variables.
Cliquez sur OK.
Méthodes de configuration des variables
Vous pouvez ajouter des variables individuellement ou en lot.
Ajouter une variable unique
Choisissez l'une des méthodes suivantes en fonction du type de votre variable :
Variable personnalisée
Saisissez directement un nom et une valeur de variable.
Pour configurer la mémoire heap JVM, les propriétés JVM ou les paramètres de l'agent Java, définissez les éléments suivants :
Nom de la variable : CATALINA_OPTS
Valeur de la variable : [Parameter to be added] $(EDAS_CATALINA_OPTS)
Variables d'environnement courantes pour les images MySQL :
|
Variable |
Obligatoire |
Description |
|
|
Oui |
Définit le mot de passe root MySQL |
|
|
Non |
Crée un compte utilisateur supplémentaire avec un mot de passe |
|
|
Non |
Spécifie une base de données à créer au démarrage du conteneur |
Pour les autres types d'images, configurez les variables d'environnement en fonction de la documentation de l'image.
Référence ConfigMap
Sélectionnez un ConfigMap dans la liste déroulante Variable Value/Variable Reference , puis sélectionnez une paire clé-valeur dans le ConfigMap.
Référence Secret
Sélectionnez un Secret dans la liste déroulante Variable Value/Variable Reference , puis sélectionnez une paire clé-valeur dans le Secret.
Ajouter plusieurs variables en lot
Pour injecter des variables d'environnement en lot à partir d'un ConfigMap ou d'un Secret, configurez les paramètres suivants :
|
Paramètre |
Description |
|
Type |
Sélectionnez Configuration Items (ConfigMap) ou Secret. Les variables personnalisées ne sont pas prises en charge en mode lot. |
|
Configuration Mode |
env : sélectionnez des paires clé-valeur spécifiques dans le ConfigMap ou le Secret. envFrom : injectez toutes les paires clé-valeur du ConfigMap ou du Secret. |
|
Configuration Items |
Sélectionnez un ConfigMap dans la liste déroulante. |
|
Reference Environment Variable |
Sélectionnez les paires clé-valeur à injecter (disponible uniquement en mode env ). |
Vous pouvez ajouter un maximum de 100 variables d'environnement à la fois. Après avoir ajouté les variables, définissez les noms de variable selon vos besoins.
Vérifier le résultat
Confirmez que les variables d'environnement sont actives en utilisant l'une des méthodes suivantes :
Historique des modifications : dans le volet de navigation de gauche de la page des détails de l'application, cliquez sur Change Records. Si la colonne Change Status affiche Success , la configuration est effective.
État du pod : sur la page Application Overview , cliquez sur Running Pods (Click View) à côté de Running Status . Dans la section Pod , vérifiez la colonne Status . Un point vert indique que l'application s'exécute avec la configuration mise à jour.
Options d'exécution de l'application
Sélectionnez l'environnement d'exécution correspondant à votre type d'application :
|
Environnement d'exécution |
Description |
|
Java > Custom |
Déploiement à l'aide d'une image personnalisée dans un cluster Kubernetes |
|
Java > Java |
Déploiement d'une application Dubbo ou Spring Boot à l'aide d'un package JAR. Paramètres configurables : Java Environment. |
|
Java > Tomcat |
Déploiement d'une application Dubbo ou Spring à l'aide d'un package WAR. Paramètres configurables : Java Environment, Container Version. |
|
Java > EDAS-Container (HSF) |
Déploiement d'une application HSF à l'aide d'un package WAR ou FatJar. Paramètres configurables : Java Environment, Pandora Version, Ali-Tomcat Version. |
|
PHP |
Déploiement d'une application PHP exécutée sur Apache HTTP Server |
|
Node.js, C++, Go, and Other Languages |
Déploiement à l'aide d'une image personnalisée dans un cluster Kubernetes |