Les applications doivent souvent lire des fichiers de configuration, des identifiants ou des certificats à partir d'un chemin connu lors de l'exécution. Enterprise Distributed Application Service (EDAS) vous permet de monter des ConfigMaps et des Secrets Kubernetes prédéfinis sous forme de fichiers dans les conteneurs d'application, afin que votre code puisse lire les données de configuration depuis le système de fichiers.
Les ConfigMaps sont prédéfinies et stockent des données non confidentielles telles que des indicateurs de fonctionnalité, des chaînes de connexion ou des paramètres spécifiques à l'environnement.
Les Secrets sont prédéfinis et stockent des données confidentielles telles que des mots de passe, des clés API et des certificats TLS.
Fonctionnement
Lorsque vous montez une ConfigMap ou un Secret, EDAS injecte chaque clé sous forme de fichier dans un répertoire que vous spécifiez au sein du conteneur. Le contenu du fichier correspond à la valeur associée.
Deux types de montage sont disponibles :
| Type de montage | Comportement |
|---|---|
| Directory | Toutes les clés sont montées sous forme de fichiers dans le répertoire cible. |
| File | Seules les clés sélectionnées sont montées sous forme de fichiers individuels. Utilisez le mode Retain Original File pour conserver les fichiers existants dans le répertoire. |
Lorsque vous définissez le Mount Point Type sur File et sélectionnez le mode Retain Original File, le fichier d'origine et le fichier monté s'affichent tous deux. Si le fichier monté porte le même nom qu'un fichier d'origine, ce dernier est masqué et seul le fichier monté apparaît.
Paramètres de montage
Le tableau suivant décrit les paramètres à configurer lors de l'ajout d'une entrée de montage.
| Paramètre | Description |
|---|---|
| Configuration Type | Le type de ressource Kubernetes à monter : Configuration Items (ConfigMap) ou Secret. |
| Mount Point Type | L'option Directory monte toutes les clés. L'option File monte des clés spécifiques. |
| Mount Source | Le nom de la ConfigMap ou du Secret à monter. |
| Mount Home Directory | Le chemin absolu à l'intérieur du conteneur où les fichiers sont montés. Il doit commencer par / et comporter au moins trois caractères. |
| Mounting Mode | Affiché uniquement lorsque le Mount Point Type est défini sur File. Overwrite Original File : seul le fichier monté apparaît. Retain Original File : les fichiers d'origine et montés coexistent. En cas de conflit de noms, le fichier monté a la priorité et le fichier d'origine est masqué. |
| Mount Configuration | Affiché uniquement lorsque le Mount Point Type est défini sur File. Mount Key : la clé issue de la ConfigMap ou du Secret. Mount File Path : le nom de fichier relatif au répertoire racine de montage. |
Prérequis
Avant de commencer, assurez-vous d'avoir :
Une ConfigMap ou un Secret dans la même région, le même cluster et le même namespace Kubernetes que l'application cible. Sinon, créez une ConfigMap ou créez un Secret au préalable.
Une version du composant de gestion EDAS qui prend en charge le montage de configuration. Si l'option de montage n'apparaît pas dans la console, il est possible que le composant de gestion du cluster soit une version ancienne sans méthode de mise à jour valide disponible. Nous vous recommandons de créer un nouveau cluster pour utiliser cette fonctionnalité.
Monter des configurations lors de la création d'une application
Connectez-vous à la console EDAS.
Dans le volet de navigation de gauche, cliquez sur Application Management > Applications.
Dans la barre de navigation supérieure, sélectionnez une région. Dans la partie supérieure de la page, sélectionnez un namespace. Cliquez sur Create Application.
-
À l'étape Basic Information , définissez le Cluster Type sur Kubernetes Clusters et sélectionnez un Application Runtime Environment en fonction du type de votre application. Cliquez sur Next.
Runtime Quand l'utiliser Java > Custom Déployez avec une image personnalisée dans un cluster Kubernetes. Java > Java Déployez une application Dubbo ou Spring Boot à partir d'un package JAR. Configurable : Java Environment. Java > Tomcat Déployez une application Dubbo ou Spring à partir d'un package WAR. Configurable : Java Environment, Container Version. Java > EDAS-Container (HSF) Déployez une application High-speed Service Framework (HSF) à partir d'un package WAR ou FatJar. Configurable : Java Environment, Pandora Version, Ali-Tomcat Version. PHP Déployez une application PHP exécutée sur Apache HTTP Server. Node.js, C++, Go, and Other Languages Déployez avec une image personnalisée dans un cluster Kubernetes. Le processus de configuration pour les applications multilingues n'est pas décrit dans cette rubrique. À l'étape Configurations , configurez l'environnement, les informations de base, la méthode de déploiement et les paramètres de ressources. Cliquez sur Next.
À l'étape Advanced Settings , cliquez sur Configuration Management puis sur Add . Configurez les paramètres de montage décrits dans la section Paramètres de montage .
Cliquez sur Create Application.
Sur la page Creation Completed , vérifiez les paramètres dans les sections Basic Information , Configurations et Advanced Settings . Cliquez sur Create Application.
Une fois la modification de l'application terminée, ouvrez la page Application Overview . Cliquez sur View Details pour suivre le processus de modification sur la page Change List . Lorsqu'un pod affiche un statut d'exécution dans la section Basic Information , le déploiement est terminé et la configuration montée est active.
Monter des configurations lors du déploiement d'une application
Si vous n'avez pas monté de configurations lors de la création de l'application, ajoutez-les lors d'un déploiement ultérieur.
Connectez-vous à la console EDAS.
Dans le volet de navigation de gauche, cliquez sur Application Management > Applications.
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 et cliquez sur le nom de l'application cible.
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 pour l'application.
Cliquez sur Configuration Management puis sur Add . Configurez les paramètres de montage décrits dans la section Paramètres de montage .
Cliquez sur OK.
Le clic sur OK redémarre l'application. Effectuez cette opération pendant les heures creuses.
Vérifier le montage
Une fois le déploiement terminé, confirmez que la configuration montée est active.
Méthode 1 : Vérifier les historiques de modification
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 indique Success , la configuration est effective.
Méthode 2 : Vérifier le statut des pods
Sur la page Application Overview , cliquez sur Running Pods (Click View) à côté de Running Status . Dans la section Pod du panneau App Configurations , vérifiez la colonne Status . Un point vert indique que le pod est en cours d'exécution et que la configuration est active.
Groupe DingTalk pour les clusters ACK et Serverless Kubernetes
Si vous avez des questions ou des suggestions concernant l'utilisation de Container Service for Kubernetes (ACK) et des clusters Serverless Kubernetes dans EDAS, vous pouvez rejoindre le groupe DingTalk en recherchant l'ID 23197114 dans DingTalk.
Étapes suivantes
Gérer les éléments de configuration – Créez, modifiez ou supprimez des ConfigMaps.
Gérer les Secrets – Créez, modifiez ou supprimez des Secrets.