Konfigurationszuordnung über die Befehlszeilenschnittstelle erstellen

Mit dem Befehl configmap create können Sie auf einem der folgenden Wege eine Konfigurationszuordnung erstellen:

• Erstellen Sie direkt in der Befehlszeile eine Konfigurationszuordnung, indem Sie die Option --from-literal im Format KEY=VALUE verwenden. Beispiel:

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

• Erstellen Sie eine Konfigurationszuordnung, indem Sie mit der Option --from-file auf eine Datei verweisen. Wenn Sie diese Option verwenden, wird der gesamte Inhalt der Datei zum Wert für das Schlüssel/Wert-Paar. Verwenden Sie für das folgende Beispiel eine Datei mit dem Namen colors.txt, die den Text blue, green, red enthält.

  • Im folgenden Beispiel wird das Format --from-file KEY=FILE mit dem Befehl configmap create verwendet:

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

  • Im folgenden Beispielbefehl wird das Format --from-file FILE mit dem Befehl configmap create verwendet. Bei diesem Beispiel ist TARGET (ohne Erweiterung) der Name der Datei, der mit dem Namen der Umgebungsvariablen übereinstimmt, die dem Beispieljob myjob bekannt ist.

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

• Erstellen Sie eine Konfigurationszuordnung, indem Sie mithilfe der Option --from-env-file auf eine Datei verweisen, die mindestens eine Zeile enthält, die dem Format KEY=VALUE entspricht. Jede Zeile der angegebenen Datei wird als Schlüssel/Wert-Paar hinzugefügt. Zeilen in der angegebenen Datei, die leer sind oder mit # beginnen, werden ignoriert. Verwenden Sie für dieses Beispiel eine Datei mit dem Namen colors_multi.txt , die die Schlüssel/Wert-Paare enthält: color1=yellow, color2=orangeund color3=purple.

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

Konfigurationszuordnungen über die Befehlszeilenschnittstelle auflisten

Verwenden Sie nach dem Erstellen dieser Konfigurationszuordnung nun den Befehl configmap list, um alle Konfigurationszuordnungen in Ihrem Projekt aufzulisten, oder verwenden Sie den Befehl configmap get, um die Details zu einer bestimmten Konfigurationszuordnung anzuzeigen. Beispiel:

ibmcloud ce configmap get --name mycolorconfigmap

Beispielausgabe

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

Verweis auf vorhandene configmaps mit der CLI

Wenn Sie eine Konfigurationszuordnung mit einer App-, Job-oder Funktionsworkload über die CLI verwenden möchten, geben Sie die Option --env-from-configmap in den folgenden Befehlen an.

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

Das folgende Beispiel beschreibt, wie man eine bestehende configmap mit einer App über die CLI referenziert..

1. Verwenden Sie den Befehl configmap create, um die folgenden zwei configmaps für dieses Szenario zu erstellen.

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

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

2. Stellen Sie eine Anwendung bereit und verweisen Sie auf diemyliteralconfigmap configmap. Erstellen Sie für dieses Beispiel eine App, die das Image hello verwendet. Wenn an diese Beispielapp eine Anforderung gesendet wird, wird von der App die Umgebungsvariable TARGET gelesen und Hello ${TARGET} ausgegeben. Wenn diese Umgebungsvariable leer ist, wird Hello World zurückgegeben. Verweis auf die Configmap myliteralconfigmap. Weitere Informationen zu dem Code, der für das vorliegende Beispiel verwendet wird, finden Sie unter hello.

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

3. Rufen Sie die Anwendung auf. Die Anwendung gibt Hello Sunshine zurück, den Wert für den Schlüssel TARGET, der in der configmap myliteralconfigmap angegeben ist.

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

   Beispielausgabe

   Hello Sunshine
   

4. Aktualisieren Sie die Anwendung erneut, um die myliteralconfigmap2 configmap zu verwenden.

   Wenn Sie eine App, einen Job bzw. eine Funktion mit einer Umgebungsvariablen aktualisieren, die vollständig auf eine Konfigurationszuordnung (oder einen geheimen Schlüssel) verweist, um vollständig auf eine andere Konfigurationszuordnung (oder einen anderen geheimen Schlüssel) zu verweisen, überschreiben vollständige Referenzen andere vollständige Referenzen in der Reihenfolge, in der sie festgelegt sind (die letzte referenzierte Gruppe überschreibt die erste Gruppe).

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

   Beispielausgabe

   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. Rufen Sie die Anwendung erneut auf. Dieses Mal gibt die Anwendung Hello Stranger zurück, was dem Wert entspricht, der in der Configmap myliteralconfigmap2 angegeben ist.

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

   Beispielausgabe

   Hello Stranger
   

6. Aktualisieren Sie die myliteralconfigmap2, um das Schlüssel-Wert-Paar zu ändern.

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

   Führen Sie den Befehl **ibmcloud ce configmap get -n myliteralconfigmap2**aus, um die Details der configmap anzuzeigen.

   Beispielausgabe

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

7. Starten Sie die Anwendung erneut, damit die neuen Daten wirksam werden.

   ibmcloud ce app update --name myhelloapp
   

8. Rufen Sie die Anwendung erneut auf. Dieses Mal gibt die Anwendung Hello Happy day zurück, was dem Wert entspricht, der in der Configmap myliteralconfigmap2 angegeben ist.

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

   Beispielausgabe

   Hello Happy day
   

Verweis auf configmaps, die noch nicht mit der CLI definiert sind

Wenn eine ConfigMap nicht vorhanden ist, bevor sie referenziert wird, wird die App-, Job-oder Funktionsworkload nicht erfolgreich bereitgestellt und ein Job oder eine Funktion wird erst erfolgreich ausgeführt, wenn die referenzierte ConfigMap erstellt wurde.

Wenn Sie mit einer App-, Job-oder Funktionsworkload arbeiten und die referenzierte ConfigMap noch nicht definiert ist, können Sie die Option --force verwenden, um die Überprüfung des Vorhandenseins der referenzierten ConfigMap zu vermeiden. Die Option --force kann mit den folgenden Befehlen verwendet werden:

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

Wenn Sie die Option --force mit diesen Befehlen verwenden, wird die Aktion zum Erstellen, Aktualisieren oder Ausführen der Workload abgeschlossen. Die App, der Job oder die Workload werden jedoch erst erfolgreich ausgeführt, wenn die referenzierte Konfigurationszuordnung vorhanden ist. Wenn Sie dem Befehl zusätzlich zur Option --force die Option --no-wait hinzufügen, schließt das System die Aktion ab und wartet nicht auf die erfolgreiche Ausführung der Workload.

Das folgende Beispiel beschreibt, wie man mit Hilfe der CLI auf eine configmap verweist, die noch nicht mit einer App definiert ist.

1. Erstellen Sie eine Anwendung und verweisen Sie auf die undefinierte myliteralconfigmap3 Configmap. Erstellen Sie für dieses Beispiel eine Code Engine-App, die das icr.io/codeengine/hello-Image verwendet. Wenn an diese Beispielapp eine Anforderung gesendet wird, wird von der App die Umgebungsvariable TARGET gelesen und Hello ${TARGET} ausgegeben. Wenn diese Umgebungsvariable leer ist, wird Hello World zurückgegeben. Verweis auf die Configmap myliteralconfigmap3. Weitere Informationen zu dem Code, der für das vorliegende Beispiel verwendet wird, finden Sie unter hello.

   Wenn Sie die Option --no-wait mit dem Befehl app create verwenden, wird die App erstellt und nicht darauf gewartet, dass die App fertig ist.

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

2. Verwenden Sie den Befehl app get, um Details zum Auftragsdurchlauf anzuzeigen, einschließlich der Informationen zu den Umgebungsvariablen. Beachten Sie, dass die App erstellt wird, aber noch nicht vollständig bereitgestellt wurde.

   ibmcloud ce app get --name myapp
   

   Beispielausgabe

   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. Erstellen Sie die configmap.

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

4. Starten Sie die Anwendung erneut, damit die neuen Daten wirksam werden.

   ibmcloud ce app update --name myapp
   

5. Rufen Sie die Anwendung auf. Dieses Mal gibt die Anwendung Hello Everyone zurück, was dem Wert entspricht, der in der Configmap myliteralconfigmap3 angegeben ist.

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

   Beispielausgabe

   Hello Everyone
   

6. Aktualisieren Sie die Anwendung, um auf die bestehende myliteralconfigmap2 Configmap zu verweisen. Die myliteralconfigmap2 ist mit dem Wert TARGET=Stranger definiert. Bei der Aktualisierung der App wird die App neu gestartet, damit die neuen Daten wirksam werden.

   Wenn Sie eine Anwendung oder einen Job mit einer Umgebungsvariablen, über die eine vollständige Konfigurationszuordnung (oder ein vollständiger geheimer Schlüssel) referenziert wird, aktualisieren, um vollständig auf eine andere Konfigurationszuordnung (oder einen anderen geheimen Schlüssel) zu verweisen, überschreiben vollständige Referenzen andere vollständige Referenzen, in der Reihenfolge, in der sie festgelegt wurden (der zuletzt referenzierte Satz überschreibt den zuerst festgelegten Satz).

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

7. Rufen Sie die Anwendung erneut auf. Dieses Mal gibt die Anwendung Hello Stranger zurück, was dem Wert entspricht, der in der Configmap myliteralconfigmap2 angegeben ist.

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

   Beispielausgabe

   Hello Stranger
   

Weitere detaillierte Szenarios zum Verweisen auf vollständige geheime Schlüssel und Konfigurationszuordnungen als Umgebungsvariablen, Überschreiben von Verweisen und Entfernen von Verweisen in der Befehlszeilenschnittstelle finden Sie unter Auf geheime Schlüssel und Konfigurationszuordnungen verweisen.