Serverless App Engine:Gérer et utiliser les ConfigMaps (K8s ConfigMap)

Créer une ConfigMap

1. Sur la ConfigMaps SAE page, sélectionnez la région et le namespace de votre application, puis cliquez sur Create.

   1. Spécifiez un nom personnalisé pour le champ ConfigMap Name.

   2. Sous Configure Mappings, sélectionnez un mode d'édition pour définir les paires clé-valeur :

      • Edit using form : Cliquez sur Add Variable, puis saisissez une clé et sa valeur. Vous pouvez ajouter plusieurs paires clé-valeur. Pour un contenu de configuration long, cliquez sur l'icône située à côté de la valeur afin de coller et de modifier la valeur dans un éditeur plus grand.

      • Edit in JSON format : Dans l'éditeur de code, saisissez une ou plusieurs paires clé-valeur. Les clés et les valeurs de chaîne doivent être entourées de guillemets doubles (""). Par exemple :

        {
            "nv_shell": "/bin/sh",
            "nginx_conf": "daemon            off;\nworker_processes  2;\nuser              www-data;\n\nevents {\n    use           epoll;\n    worker_connections  128;\n}\n\nerror_log         logs/error.log info;\n\nhttp {\n    server_tokens off;\n    include       mime.types;\n    charset       utf-8;\n\n    access_log    logs/access.log  combined;\n\n    server {\n        server_name   localhost;\n        listen        127.0.0.1:80;\n\n        error_page    500 502 503 504  /50x.html;\n\n        location      / {\n            root      html;\n        }\n\n    }"
        }
        

      • Edit in YAML format : Dans l'éditeur de code, saisissez une ou plusieurs paires clé-valeur. Par exemple :

        nv_shell: /bin/sh
        nginx_conf: |-
          daemon            off;
          worker_processes  2;
          user              www-data;
        
          events {
              use           epoll;
              worker_connections  128;
          }
        
          error_log         logs/error.log info;
        
          http {
              server_tokens off;
              include       mime.types;
              charset       utf-8;
        
              access_log    logs/access.log  combined;
        
              server {
                  server_name   localhost;
                  listen        127.0.0.1:80;
        
                  error_page    500 502 503 504  /50x.html;
        
                  location      / {
                      root      html;
                  }
        
              }

2. Repérez la ConfigMap que vous avez créée dans la liste Configuration Item (ConfigMap). Vous pouvez ensuite la Edit, la Copy, View Record ou la Delete.

   Important

   • Une ConfigMap ne prend effet qu'après que vous l'avez utilisée comme variable d'environnement ou montée en tant que fichier sur le système de fichiers de votre application.

   • Si vous modifiez une ConfigMap, vous devez redéployer toute application qui y fait référence pour que les modifications prennent effet.

   • La suppression d'une ConfigMap peut entraîner l'échec des applications qui y font référence. Avant de supprimer une ConfigMap, supprimez toutes les références qui y sont associées dans vos applications.

Utiliser une ConfigMap comme variable d'environnement

1. Créer une application

   Sur la Liste des applications SAE page, sélectionnez une région et un namespace de destination dans la barre de navigation supérieure, puis cliquez sur Create Application. Sur la page Application Basic Information, configurez les paramètres et cliquez sur Next: Advanced Settings.

   Modifier une application en cours d'exécution

   Avertissement

   Après le redéploiement d'une application, celle-ci est redémarrée. Pour éviter des erreurs imprévisibles, telles que des interruptions d'activité, nous vous recommandons de déployer les applications pendant les heures creuses.

   Sur la Liste des applications SAE page, sélectionnez une région et un namespace de destination dans la barre de navigation supérieure. Cliquez sur l'ID de l'Application cible pour ouvrir la page des détails de l'application.Dans le volet de navigation de gauche, cliquez sur Basic Information. Dans le coin supérieur droit, cliquez sur Deploy Application.

   Modifier une application arrêtée

   Sur la Liste des applications SAE page, sélectionnez une région et un namespace de destination dans la barre de navigation supérieure. Cliquez sur l'ID de l'Application cible pour ouvrir la page des détails de l'application.Cliquez sur Basic Information, puis sur Modify Application Configuration.

2. Dans la section Environment Variable, définissez le champ Type sur Reference ConfigMap. Spécifiez un nom personnalisé dans le champ Variable Name pour la variable d'environnement de votre application, puis sélectionnez le ConfigMap Name et la Key à référencer. Vous pouvez ajouter plusieurs variables. Si vous choisissez de référencer toutes les clés de la ConfigMap, il n'est pas nécessaire de spécifier un Variable Name, car les noms de clés d'origine sont utilisés comme noms de variables d'environnement.

3. Attendez que l'application soit déployée. Pour vérifier la configuration, connectez-vous au web shell de l'instance d'application et exécutez la commande env | grep <variable_name>. Remplacez <variable_name> par le nom de la variable que vous avez configurée. Si la sortie affiche le nom et la valeur corrects de la variable, la configuration a réussi.

Monter une ConfigMap en tant que fichier

Le montage d'une ConfigMap en tant que fichier écrit la valeur de la clé spécifiée comme contenu du fichier. Vous pouvez personnaliser le chemin d'accès et le nom du fichier. Le fichier monté remplace tout fichier existant situé au même chemin.

Utilisez cette approche pour gérer les fichiers de configuration sans reconstruire l'image du conteneur. Pour modifier un fichier de configuration existant, copiez son contenu dans une valeur de ConfigMap, puis montez la ConfigMap sur le chemin d'accès du fichier d'origine.

1. Créer une application

   Sur la Liste des applications SAE page, sélectionnez une région et un namespace de destination dans la barre de navigation supérieure, puis cliquez sur Create Application. Sur la page Application Basic Information, configurez les paramètres et cliquez sur Next: Advanced Settings.

   Modifier une application en cours d'exécution

   Avertissement

   Après le redéploiement d'une application, celle-ci est redémarrée. Pour éviter des erreurs imprévisibles, telles que des interruptions d'activité, nous vous recommandons de déployer les applications pendant les heures creuses.

   Sur la Liste des applications SAE page, sélectionnez une région et un namespace de destination dans la barre de navigation supérieure. Cliquez sur l'ID de l'Application cible pour ouvrir la page des détails de l'application.Dans le volet de navigation de gauche, cliquez sur Basic Information. Dans le coin supérieur droit, cliquez sur Deploy Application.

   Modifier une application arrêtée

   Sur la Liste des applications SAE page, sélectionnez une région et un namespace de destination dans la barre de navigation supérieure. Cliquez sur l'ID de l'Application cible pour ouvrir la page des détails de l'application.Cliquez sur Basic Information, puis sur Modify Application Configuration.

2. Dans la section Configuration Management, cliquez sur + Add. Sélectionnez le ConfigMap Name et la Key à monter (ou choisissez de monter toutes les clés). Ensuite, spécifiez le Mount Path. Si vous montez une seule clé, fournissez un chemin absolu incluant le nom du fichier. Si vous montez toutes les clés, fournissez un chemin absolu vers un répertoire, et SAE utilise automatiquement les noms des clés comme noms de fichiers. Vous pouvez ajouter plusieurs montages.

3. Attendez que l'application soit déployée. Pour vérifier la configuration, connectez-vous au web shell de l'instance d'application et vérifiez le contenu du fichier situé au chemin de montage.