Création d'une mappe de configuration via l'interface de ligne de commande

Créez une mappe de configuration à l'aide de la commande configmap create de l'une des façons suivantes :

• Créez une mappe de configuration directement dans la ligne de commande en utilisant l'option --from-literal au format KEY=VALUE. Par exemple :

  ibmcloud ce configmap create --name myliteralconfigmap --from-literal TARGET=Sunshine
  

• Créez une mappe de configuration à l'aide de l'option --from-file pour pointer vers un fichier. En utilisant cette option, tout le contenu du fichier devient la valeur pour la paire valeur-clé. Pour cet exemple, utilisez un fichier nommé colors.txt qui contient le texte blue, green, red.

  • Dans l'exemple suivant, le format --from-file KEY=FILE est utilisé avec la commande configmap create :

    ibmcloud ce configmap create --name mycolorconfigmap --from-file TARGET=colors.txt
    

  • Dans l'exemple ci-après, le format --from-file FILE est utilisé avec la commande configmap create. Dans cet exemple, TARGET (sans extension) est le nom du fichier, qui est identique au nom de la variable d'environnement connue de l'exemple de travail myjob.

    ibmcloud ce configmap create --name mycolorconfigmap2  --from-file TARGET
    

• Créez une mappe de configuration à l'aide de l'option --from-env-file pour pointer vers un fichier contenant une ou plusieurs lignes correspondant au format KEY=VALUE. Chaque ligne du fichier spécifié est ajoutée en tant que paire clé-valeur. Toutes les lignes du fichier indiqué qui sont vides ou commencent par #sont ignorées. Pour cet exemple, utilisez un fichier nommé colors_multi.txt qui contient les paires clé-valeur color1=yellow, color2=orange et color3=purple.

  ibmcloud ce configmap create --name mycolorconfigmapmulti --from-env-file colors_multi.txt
  

Affichage de la liste des mappes de configuration à l'aide de l'interface de ligne de commande

Maintenant que la mappe de configuration est créée, utilisez la commande configmap list pour répertorier toutes les mappes de configuration de votre projet ou servez-vous de la commande configmap get pour afficher des détails sur une mappe de configuration spécifique. Par exemple :

ibmcloud ce configmap get --name mycolorconfigmap

Exemple de sortie

Getting configmap 'mycolorconfigmap'...
OK

Name:          mycolorconfigmap
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           11s
Created:       2020-10-14 14:10:57 -0400 EDT

Data:
---
TARGET: blue, green, red

Référencement des mappes de configuration existantes via l'interface de ligne de commande

Pour utiliser une mappe de configuration avec une application, un travail ou une charge de travail de fonction avec l'interface de ligne de commande, spécifiez l'option --env-from-configmap sur les commandes suivantes.

• app create
• app update
• job create
• job update
• jobrun submit
• jobrun resubmit
• fn create
• fn update

L'exemple suivant montre comment référencer une mappe de configuration existante avec une application à l'aide de l'interface de ligne de commande.

1. Utilisez la commande configmap create pour créer les deux mappes de configuration suivantes pour ce scénario.

   ibmcloud ce configmap create --name myliteralconfigmap --from-literal TARGET=Sunshine
   

   ibmcloud ce configmap create --name myliteralconfigmap2 --from-literal TARGET=Stranger
   

2. Déployez une application et référencez la mappe de configuration myliteralconfigmap. Pour cet exemple, créez une application qui utilise l'image hello. Lorsqu'une demande est envoyée à cet exemple d'application, l'application lit la variable d'environnement TARGET et affiche Hello ${TARGET}. Si cette variable d'environnement est vide, Hello World est renvoyé. Référencez la mappe de configuration myliteralconfigmap. Pour plus d'informations sur le code utilisé pour cet exemple, voir hello.

   ibmcloud ce app create --name myhelloapp --image icr.io/codeengine/hello --env-from-configmap myliteralconfigmap
   

3. Appelez l'application. L'application renvoie Hello Sunshine, qui est la valeur de la clé TARGET spécifiée dans la mappe de configuration myliteralconfigmap.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud
   

   Exemple de sortie

   Hello Sunshine
   

4. Mettez de nouveau à jour de l'application pour utiliser la mappe de configuration myliteralconfigmap2.

   Lorsque vous mettez à jour une application, un travail ou une fonction avec une variable d'environnement qui fait entièrement référence à une mappe de configuration (ou un secret) pour faire entièrement référence à une mappe de configuration (ou un secret) différente, les références complètes remplacent les autres références complètes dans l'ordre dans lequel elles sont définies (le dernier ensemble référencé remplace le premier ensemble).

   ibmcloud ce app update --name myhelloapp --env-from-configmap myliteralconfigmap2
   

   Exemple de sortie

   Updating application 'myhelloapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myhelloapp' to check the application status.
   OK
   
   https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud
   

5. Appelez à nouveau l'application. Cette fois, l'application renvoie Hello Stranger, qui est la valeur spécifiée dans la mappe de configuration myliteralconfigmap2.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Exemple de sortie

   Hello Stranger
   

6. Mettez à jour myliteralconfigmap2 pour modifier la paire clé-valeur.

   ibmcloud ce configmap update --name myliteralconfigmap2 --from-literal "TARGET=Happy day"
   

   Exécutez la commande ibmcloud ce configmap get -n myliteralconfigmap2 pour afficher les détails de la mappe de configuration.

   Exemple de sortie

   Name:          myliteralconfigmap2
   [...]
   Data:
   ---
   TARGET: Happy day
   

7. Redémarrez l'application pour que les nouvelles données soient appliquées.

   ibmcloud ce app update --name myhelloapp
   

8. Appelez à nouveau l'application. Cette fois, l'application renvoie Hello Happy day, qui est la valeur spécifiée dans la mappe de configuration myliteralconfigmap2.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Exemple de sortie

   Hello Happy day
   

Référencement des mappes de configuration qui ne sont pas encore définies via l'interface de ligne de commande

Si une mappe de configuration n'existe pas avant d'être référencée, la charge de travail de l'application, du travail ou de la fonction ne se déploie pas correctement et un travail ou une fonction ne s'exécute pas correctement tant que la mappe de configuration référencée n'est pas créée.

Si vous utilisez une application, un travail ou une charge de travail de fonction et que la mappe de configuration référencée n'est pas encore définie, vous pouvez utiliser l'option --force pour éviter la vérification de l'existence de la mappe de configuration référencée. L'option --force peut être utilisée avec les commandes suivantes.

• app create
• app update
• job create
• job update
• jobrun submit
• jobrun resubmit
• fn create
• fn update

Lorsque vous utilisez l'option --force avec ces commandes, l'action de création, de mise à jour ou d'exécution de la charge de travail se termine ; toutefois, l'application, le travail ou la charge de travail ne s'exécute pas correctement tant que la mappe de configuration référencée n'existe pas. Si vous ajoutez l'option --no-wait en plus de l'option --force à la commande, le système exécute l'action et n'attend pas que la charge de travail s'exécute correctement.

L'exemple suivant montre comment référencer une mappe de configuration qui n'est pas encore définie avec une application à l'aide de l'interface de ligne de commande.

1. Créez une application et référencez la mappe de configuration myliteralconfigmap3 qui n'est pas définie. Pour cet exemple, créez une application Code Engine qui utilise l'image icr.io/codeengine/hello. Lorsqu'une demande est envoyée à cet exemple d'application, l'application lit la variable d'environnement TARGET et affiche Hello ${TARGET}. Si cette variable d'environnement est vide, Hello World est renvoyé. Référencez la mappe de configuration myliteralconfigmap3. Pour plus d'informations sur le code utilisé pour cet exemple, voir hello.

   Avec l'option --no-wait dans la commande app create, l'application est créée sans attendre que l'application soit prête.

   ibmcloud ce app create --name myapp --image icr.io/codeengine/hello --env-from-configmap myliteralconfigmap3 --force --no-wait
   

2. Utilisez la commande app get pour afficher les détails de l'exécution de travail, y compris les informations relatives aux variables d'environnement. Notez que l'application est créée, mais pas encore totalement déployée.

   ibmcloud ce app get --name myapp
   

   Exemple de sortie

   Name:            myapp
   [...]
   Status Summary:  Application is deploying
   
   Environment Variables:
       Type                      Name                 Value
       ConfigMap full reference  myliteralconfigmap3
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
       CPU:                1
       Ephemeral Storage:  400M
       Memory:             4G
   
   Runtime:
       Concurrency:    100
       Maximum Scale:  10
       Minimum Scale:  0
       Timeout:        300
   
   Conditions:
       Type                 OK     Age  Reason
       ConfigurationsReady  false  10s
       Ready                false  10s  RevisionMissing : Configuration "myapp" is waiting for a Revision to become ready.
       RoutesReady          false  10s  RevisionMissing : Configuration "myapp" is waiting for a Revision to become ready.
   
   Events:
       Type    Reason   Age  Source              Messages
       Normal  Created  12s  service-controller  Created Configuration "myapp"
       Normal  Created  12s  service-controller  Created Route "myapp"
   
   Instances:
       Name                                      Revision      Running  Status   Restarts  Age
       myapp-00001-deployment-566d5c79b9-wttqs  myapp-00001  0/2      Pending  0         11s
   

3. Créez la mappe de configuration.

   ibmcloud ce configmap create --name myliteralconfigmap3 --from-literal TARGET=Everyone
   

4. Redémarrez l'application pour que les nouvelles données soient appliquées.

   ibmcloud ce app update --name myapp
   

5. Appelez l'application. L'application renvoie Hello Everyone, qui est la valeur spécifiée dans la mappe de configuration myliteralconfigmap3.

   curl https://myapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Exemple de sortie

   Hello Everyone
   

6. Mettez à jour l'application pour référencer la mappe de configuration myliteralconfigmap2 existante. La mappe de configuration myliteralconfigmap2 est définie avec la valeur TARGET=Stranger. La mise à jour de l'application redémarre l'application .

   Quand vous mettez à jour une application ou un travail avec une variable d'environnement qui référence intégralement une mappe de configuration (ou un secret) pour référencer intégralement une autre mappe de configuration (ou un autre secret), les références intégrales remplacent les autres références intégrales dans l'ordre où elles sont définies (le dernier ensemble référencé remplace le premier ensemble).

   ibmcloud ce app update --name myapp --env-from-configmap myliteralconfigmap2
   

7. Appelez à nouveau l'application. Cette fois, l'application renvoie Hello Stranger, qui est la valeur spécifiée dans la mappe de configuration myliteralconfigmap2.

   curl https://myapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Exemple de sortie

   Hello Stranger
   

Pour obtenir des scénarios plus détaillés sur le référencement de secrets et de mappes de configuration complets en tant que variables d'environnement, sur le remplacement de références et sur le retrait de références dans l'interface de ligne de commande, voir Référencement de secrets et des mappes de configuration.