IBM Cloud Code Engine-CLI

Befehlsoptionen

--name, -n

Der Name der zu bindenden Anwendung. Dieser Wert ist erforderlich.

--no-wait, --nw

Bindet die Serviceinstanz und wartet nicht, bis die Servicebindung bereit ist. Wenn Sie die Option no-wait angeben, wird die Erstellung der Servicebindung gestartet und der Befehl wird beendet, ohne dass der Abschluss der Erstellung abgewartet wird. Verwenden Sie den Befehl app get, um den Bindungsstatus der Anwendung zu überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--prefix, -p

Ein Präfix für Umgebungsvariablen, die für diese Servicebindung erstellt werden. Darf nur Großbuchstaben, Zahlen und Unterstreichungszeichen (_) enthalten und darf nicht mit einer Zahl beginnen. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--role, -r

Der Name einer Servicerolle für den neuen Serviceberechtigungsnachweis, der für die Servicebindung erstellt wird. Gültige Werte sind Reader, Writer, Manager oder eine servicespezifische Rolle. Die Option nimmt standardmäßig die Rolle Manager an bzw. die erste vom Service bereitgestellte Rolle, wenn Manager nicht unterstützt wird. Diese Option wird ignoriert, wenn die Option --service-credential angegeben ist. Dieser Wert ist optional.

--service-credential, --sc

Der Name eines vorhandenen Serviceberechtigungsnachweises, der für die Servicebindung verwendet werden soll. Wenn Sie keinen Berechtigungsnachweis für die Serviceinstanz angeben, werden während der Bindeaktion neue Berechtigungsnachweise generiert. Dieser Wert ist optional.

--service-instance, --si

Der Name einer vorhandenen IBM Cloud-Serviceinstanz, die an die Anwendung gebunden werden soll. Dieser Wert ist optional.

--service-instance-id, --siid

Die GUID einer vorhandenen IBM Cloud-Serviceinstanz, die an die Anwendung gebunden werden soll. Dieser Wert ist optional.

--wait, -w

Bindet die Serviceinstanz und wartet, bis die Servicebindung bereit ist. Wenn Sie die Option --wait angeben, wartet die Anwendungsbindung eine maximale Zeit in Sekunden (wie durch die Option --wait-timeout festgelegt), bis die App-Bindung erfolgreich abgeschlossen wird. Falls die Bindung der App innerhalb des durch --wait-timeout angegebenen Zeitraums nicht erfolgreich ausgeführt wird oder fehlschlägt, schlägt der Befehl fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum, der abgewartet werden soll, bis die Servicebindung bereit ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 300.

Beispiel

Binden Sie in diesem Beispiel Ihre IBM Cloud Object Storage Service-Instanz namens my-object-storage an Ihre Anwendung namens myapp.

ibmcloud ce application bind --name myapp --service-instance my-object-storage

Beispielausgabe

Binding service instance...
Waiting for service binding to become ready...
Status: Pending (Processing Resource)
Status: Pending (Processing Resource)
Status: Creating service binding
Status: Creating service binding
Status: Ready
Waiting for application revision to become ready...
Traffic is not yet migrated to the latest revision.
Ingress has not yet been reconciled.
Waiting for load balancer to be ready
OK

Befehlsoptionen

-n, --name

Der Name der Anwendung. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem Kleinbuchstaben beginnen.
• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung enden.
• Der Name darf aus maximal 63 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist erforderlich.

--argument, --arg, -a

Legt die Argumente für die Anwendung fest. Geben Sie für jede Option des Typs --argument ein Argument an; Beispiel: -a argA -a argB. Dieser Wert überschreibt die Standardwerte, die im Container-Image angegeben werden. Dieser Wert ist optional.

--build-commit, --commit, --bcm, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Die Buildfestschreibungsoption ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional.

--build-context-dir, --context-dir, --bcdr, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Die Option für das Buildkontextverzeichnis ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional.

--build-dockerfile, --dockerfile, --bdf, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Die Option für die Build-Docker-Datei ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf die URL eines Git-Repositorys gesetzt ist. Dieser Wert ist optional.

--build-size, --size, --bsz, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Die Option für die Buildgröße ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist medium.

--build-source, --source, --bsrc, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Dieser Wert ist optional.

--build-strategy, --strategy, --bstr, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Gültige Werte sind dockerfile und buildpacks. Die Option für die Buildstrategie ist nur zulässig, wenn die Option --build-source festgelegt ist. Wenn nicht angegeben, wird die Build-Strategie dadurch bestimmt Code Engine, ob angegeben --build-source ist und sich die Quelle auf Ihrem lokalen Rechner befindet. Dieser Wert ist optional. Der Standardwert ist dockerfile.

--build-timeout, --bto

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Die Option für das Buildzeitlimit ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist 600.

--cluster-local, --cl

Anwendung mit einem Nur-Projekt-Endpunkt implementieren. Das Festlegen eines reinen Projektendpunkts bedeutet, dass Ihre App nicht über das öffentliche Internet zugänglich ist und der Netzzugriff nur über andere Code Engine-Komponenten möglich ist, die in demselben Projekt ausgeführt werden. Dieser Wert ist optional. Der Standardwert ist false.

--command, --cmd, -c

Legt die Befehle für die Anwendung fest. Geben Sie für jede Option des Typs --command einen Befehl an; Beispiel: --cmd cmdA --cmd cmdB. Dieser Wert überschreibt den Standardbefehl, der im Container-Image angegeben ist. Dieser Wert ist optional.

--concurrency, --cn

Die maximale Anzahl der Anforderungen, die pro Instanz gleichzeitig verarbeitet werden können. Dieser Wert ist optional. Der Standardwert ist 100.

--concurrency-target, --ct

Der Schwellenwert für gleichzeitige Anforderungen pro Instanz, ab dem eine oder mehrere weitere Instanzen erstellt werden. Verwenden Sie diesen Wert, um ausgehend von der Anzahl gleichzeitiger Anforderungen ein Scale-up für Instanzen durchzuführen. Diese Option nimmt standardmäßig den Wert der Option --concurrency-target an, falls --concurrency nicht angegeben wird. Dieser Wert ist optional. Der Standardwert ist 0.

--cpu

Die CPU-Kapazität, die für die Instanz der Anwendung festgelegt wurde. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 1.

--env, -e

Legt die Umgebungsvariablen in der Anwendung fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: --env envA=A --env envB=B. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--ephemeral-storage, --es

Die Menge des ephemeren Speichers, die für die Instanz der Anwendung festgelegt werden soll. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional. Der Standardwert ist 400M.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit den Optionen --env-from-configmap oder --mount-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit den Optionen --env-from-secret, --mount-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--image, -i

Der Name des Image, das für diese Anwendung verwendet wird. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei sind REGISTRY und TAG optional. Wird REGISTRY nicht angegeben, ist docker.io der Standardwert. Wird TAG nicht angegeben, ist latest der Standardwert. Die Imageoption ist erforderlich, wenn die Option --build-source nicht angegeben ist. Dieser Wert ist optional.

--max-scale, --max, --maxscale

Die maximale Anzahl der Instanzen, die für diese Anwendung verwendet werden können. Wenn Sie diesen Wert auf 0 setzen, wird die Anwendung nach Bedarf skaliert. Die Anwendungsskalierung wird nur durch die Instanzen pro Ressourcenkontingent für das Projekt Ihrer Anwendung begrenzt. Grenzwerte und Kontingente für Code Engine enthält weitere Informationen hierzu. Dieser Wert ist optional. Der Standardwert ist 10.

--memory, -m

Die Menge des Hauptspeichers für die Instanz der Anwendung. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 4G.

--min-scale, --min, --minscale

Die minimale Anzahl der Instanzen, die für diese Anwendung verwendet werden können. Diese Option ist nützlich, um sicherzustellen, dass keine Instanzen ausgeführt werden, wenn sie nicht benötigt werden. Dieser Wert ist optional. Der Standardwert ist 0.

--mount-configmap, --mount-cm

Fügen Sie den Inhalt einer Konfigurationszuordnung (configmap) zum Dateisystem Ihres Anwendungscontainers hinzu, indem Sie ein Mountverzeichnis und den Namen einer Konfigurationszuordnung im Format MOUNT_DIRECTORY=CONFIGMAP_NAME angeben. Jede angehängte Konfigurationszuordnung muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in der Konfigurationszuordnung wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-configmap an; Beispiel: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Dieser Wert ist optional.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--mount-secret, --mount-sec

Fügen Sie den Inhalt eines geheimen Schlüssels zum Dateisystem Ihres Anwendungscontainers hinzu, indem Sie ein Mountverzeichnis und den Namen eines geheimen Schlüssels im Format MOUNT_DIRECTORY=SECRET_NAME angeben. Jeder angehängte geheime Schlüssel muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in dem geheimen Schlüssel wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-secret an; Beispiel: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Dieser Wert ist optional.

--no-cluster-local, --ncl

Anwendung mit einem öffentlichen Endpunkt bereitstellen. Die Anwendung wird so bereitgestellt, dass sie Anforderungen aus dem öffentlichen Internet oder von Komponenten im Code Engine-Projekt empfangen kann. Dieser Wert ist optional. Der Standardwert ist true.

--no-wait, --nw

Anwendung erstellen und nicht warten, bis die Anwendung den Status 'Bereit' hat. Wenn Sie die Option --no-wait angeben, wird die Anwendungserstellung ohne Warten gestartet. Mit dem Befehl app get können Sie den Anwendungsstatus überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, url und project-url. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--port, -p

Der Port, an dem die Anwendung empfangsbereit ist. Das Format ist [NAME:]PORT, wobei [NAME:] optional ist. Wenn [NAME:] angegeben ist, sind h2c und http1 die gültigen Werte. Wenn [NAME:] nicht angegeben ist oder http1 angegeben ist, wird vom Port 'HTTP/1.1' verwendet. Wenn für [NAME:] der Wert h2c festgelegt wurde, wird vom Port unverschlüsseltes HTTP/2 verwendet. Standardmäßig geht Code Engine davon aus, dass Apps an Port 8080 für eingehende Verbindungen empfangsbereit sind. Wenn die Anwendung an einem anderen Port als dem Port 8080 empfangsbereit sein muss, verwenden Sie --port, um den Port anzugeben. Dieser Wert ist optional.

--probe-live, --pl

Konfigurieren Sie den Liveness-Test für diese Anwendung im Format NAME=VALUE. Gültige Optionen für NAME sind: type, port, path, interval, initial-delay, timeout, failure-threshold. Diese Option kann mehrmals angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel, --probe-live Typ=tcp --probe-live port=8080. Weitere Informationen zum Arbeiten mit Tests finden Sie unter Tests für Ihre App konfigurieren. Dieser Wert ist optional.

--probe-ready, --pr

Konfigurieren Sie die Bereitschaftsprüfung für diese Anwendung im Format NAME=VALUE. Gültige Optionen für NAME sind: type, port, path, interval, initial-delay, timeout, failure-threshold. Diese Option kann mehrmals angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel, --probe-ready Typ=tcp --probe-ready port=8080. Weitere Informationen zum Arbeiten mit Tests finden Sie unter Tests für Ihre App konfigurieren. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Dieser Wert ist optional.

--request-timeout, --rt, --timeout, -t

Die Zeit in Sekunden, die verstreichen kann, bevor Anforderungen an die Anwendung erfolgreich beendet werden oder fehlschlagen. Dieser Wert ist optional. Der Standardwert ist 300.

--rn, --revision-name

Der Name der Revision. Verwenden Sie einen Namen, der innerhalb der Anwendung eindeutig ist.

• Der Name kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.
• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung enden.
• Der vollständig qualifizierte Revisionsname muss das Format Name_of_application-Name of revisionhaben.
• Der vollständig qualifizierte Revisionsname darf maximal 63 Zeichen lang sein.

Dieser Wert ist optional.

--scale-down-delay, --sdd

Die Zeit in Sekunden, die bei reduziertem gemeinsamen Zugriff vergehen muss, bevor die Anwendung herunterskaliert wird. Eine Erhöhung der Anzahl gleichzeitiger Anforderungen führt dazu, dass eine Anwendung vertikal skaliert wird. Wenn die Anzahl der Anforderungen fällt (reduzierter gemeinsamer Zugriff), bestimmt die angegebene Zeit für diese Option, wie lange der reduzierte gemeinsame Zugriff bestehen bleiben muss, bevor die Anwendung nach unten skaliert wird. Standardmäßig wird für die Anwendung sofort ein Scale-down durchgeführt, wenn ein reduzierter gemeinsamer Zugriff erkannt wird. Dieser Wert ist optional. Der Standardwert ist 0.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens an den Container dieser Anwendung. Dieser Wert ist optional. Der Standardwert ist false.

--user, -u

Die Benutzer-ID (UID), die zur Ausführung der Anwendung verwendet wird. Durch diesen Wert wird eine Benutzer-ID überschrieben, die in der Dockerfile der Anwendung festgelegt ist. Die ID muss den Betriebssystemvoraussetzungen des Containers entsprechen. Dieser Wert ist optional. Der Standardwert ist 0.

--visibility, -v

Die Sichtbarkeit der Anwendung. Gültige Werte sind public, private, und project. Das Festlegen der Sichtbarkeit von public bedeutet, dass Ihre App Anforderungen vom öffentlichen Internet oder von Komponenten innerhalb des Code Engine-Projekts empfangen kann. Das Festlegen der Sichtbarkeit von private bedeutet, dass Ihre App nicht über das öffentliche Internet zugänglich ist und der Netzzugriff nur über andere IBM Cloud-Instanzen möglich ist, die Virtual Private Endpoints (VPE) oder Code Engine-Komponenten verwenden, die in demselben Projekt ausgeführt werden. Sichtbarkeit kann nur private sein, wenn das Projekt die private Sichtbarkeit von Anwendungen unterstützt. Das Festlegen der Sichtbarkeit von project bedeutet, dass Ihre App nicht über das öffentliche Internet zugänglich ist und der Netzzugriff nur über andere Code Engine-Komponenten möglich ist, die in demselben Projekt ausgeführt werden. Dieser Wert ist optional.

--wait, -w

Erstellen Sie die Anwendung und warten Sie, bis sie den Status 'Bereit' hat. Wenn Sie die Option --wait angeben, wird mit der Anwendungserstellung eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis die Anwendung den Status 'Bereit' aufweist. Wenn die Anwendung nicht innerhalb des angegebenen Zeitraums wait-timeout bereit ist, schlägt die Erstellung der Anwendung fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum, der abgewartet werden soll, bis die Anwendung den Status 'Bereit' hat. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce application create --name myapp --image icr.io/codeengine/hello

Beispielausgabe

Creating application 'myapp'...
[...]
Run `ibmcloud ce application get -n 'myapp'` to check the application status.
OK

https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

Wenn Sie ausführen, um den Status Ihrer ibmcloud ce application get -n 'myapp' Bewerbung zu überprüfen, wird der URL für Ihre Bewerbung angezeigt.

Befehlsoptionen

--name, -n

Der Name der Anwendung. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--no-wait, --nw

Löschen Sie die Anwendung und warten Sie nicht darauf, dass die Anwendung den Status 'Gelöscht' hat. Wenn Sie die Option no-wait angeben, wird die Anwendung ohne Wartezeit gelöscht. Mit dem Befehl app get können Sie den Anwendungsstatus überprüfen. Dieser Wert ist optional. Der Standardwert ist true.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Löschen Sie die Anwendung und warten Sie, bis die Anwendung den Status 'Gelöscht' hat. Wenn Sie die Option --wait angeben, wird mit der Anwendungslöschung eine bestimmte maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt ist, bis die Anwendung den Status 'Bereit' aufweist. Wenn der Status der Anwendung innerhalb des angegebenen Zeitraums --wait-timeout nicht in 'Gelöscht' wechselt, ist die Löschung der Anwendung fehlgeschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--wait-timeout, --wto

Der Zeitraum, der abgewartet werden soll, bis die Anwendung gelöscht ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce application delete --name myapp -f

Beispielausgabe

Deleted application 'myapp'

Befehlsoptionen

--application, --app, -a, --name, -n

Zeigt die Ereignisse aller Instanzen der angegebenen Anwendung an. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

--instance, -i

Der Name einer bestimmten Anwendungsinstanz. Verwenden Sie den Befehl app get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --application nicht angegeben ist.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel werden die Systemereignisinformationen für alle Instanzen einer angegebenen Anwendung angezeigt.

ibmcloud ce application events --application myapp

Getting events for all instances of application 'myapp'...
OK

myapp-atfte-1-deployment-6b49c5fb85-kf4m2:
    Type    Reason     Age  Source                Messages
    Normal  Scheduled  31s  default-scheduler     Successfully assigned 4svg40kna19/myapp-atfte-1-deployment-6b49c5fb85-kf4m2 to 10.240.0.15
    Normal  Pulling    29s  kubelet, 10.240.0.15  Pulling image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal  Pulled     24s  kubelet, 10.240.0.15  Successfully pulled image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6" in 4.907426108s
    Normal  Created    24s  kubelet, 10.240.0.15  Created container user-container
    Normal  Started    24s  kubelet, 10.240.0.15  Started container user-container
    Normal  Pulled     24s  kubelet, 10.240.0.15  Container image "icr.io/obs/codeengine/knative-serving/queue-39be6f1d08a095bd076a71d288d295b6:v0.20.0-rc1@sha256:8988bea781130827b3e1006e6e5e7f49094343a5505c1927bb832be3470455f6" already present on machine
    Normal  Created    23s  kubelet, 10.240.0.15  Created container queue-proxy
    Normal  Started    23s  kubelet, 10.240.0.15  Started container queue-proxy

Beispiel für Systemereignisinformationen für die angegebene Instanz einer Anwendung

Im folgenden Beispiel werden die Systemereignisinformationen für eine angegebene Instanz einer App angezeigt. Verwenden Sie den Befehl app get, um Details zu Ihrer App anzuzeigen, einschließlich der aktiven Instanzen der App.

ibmcloud ce application events --instance myapp-li17x-1-deployment-69fd57bcb6-sr9tl

Getting events for application instance 'myapp-li17x-1-deployment-69fd57bcb6-sr9tl'...
OK

myapp-li17x-1-deployment-69fd57bcb6-sr9tl:
    Type     Reason     Age                    Source                Messages
    Normal   Scheduled  6m40s                  default-scheduler     Successfully assigned 4svg40kna19/myapp-li17x-1-deployment-69fd57bcb6-sr9tl to 10.240.64.6
    Normal   Pulling    6m39s                  kubelet, 10.240.64.6  Pulling image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal   Pulled     6m36s                  kubelet, 10.240.64.6  Successfully pulled image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal   Created    6m34s                  kubelet, 10.240.64.6  Created container user-container
    Normal   Started    6m33s                  kubelet, 10.240.64.6  Started container user-container
    Normal   Pulled     6m33s                  kubelet, 10.240.64.6  Container image "icr.io/obs/codeengine/knative-serving/queue-39be6f1d08a095bd076a71d288d295b6:v0.19.0-rc3@sha256:9cb525af53896afa6b5210b5ac56a893cf85b6cd013a61cb6503a005e40c5c6f" already present on machine
    Normal   Created    6m33s                  kubelet, 10.240.64.6  Created container queue-proxy
    Normal   Started    6m32s                  kubelet, 10.240.64.6  Started container queue-proxy
    [...]

Befehlsoptionen

--name, -n

Der Name der Anwendung. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, url und project-url. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--show-all-revisions, -r

Zeigt alle Revisionen für die Anwendung an. Ist die Option nicht angegeben, werden nur Revisionen angezeigt, die für den Empfang von Datenverkehr konfiguriert sind. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce application get --name myapp

Beispielausgabe

Run 'ibmcloud ce application events -n myapp' to get the system events of the application instances.
Run 'ibmcloud ce application logs -f -n myapp' to follow the logs of the application instances.
OK

Name:          myapp
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:                31m
Created:            2021-09-09T14:01:02-04:00
URL:                https://myapp.abcdabcdabc.us-south.codeengine.appdomain.cloud
Cluster Local URL:  http://myapp.abcdabcdabc.svc.cluster.local
Console URL:        https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
Status Summary:     Application deployed successfully  

Environment Variables:    
  Type     Name             Value  
  Literal  CE_API_BASE_URL  https://api.private.us-south.codeengine.cloud.ibm.com
  Literal  CE_APP           myapp  
  Literal  CE_DOMAIN        us-south.codeengine.appdomain.cloud  
  Literal  CE_PROJECT_ID    abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
  Literal  CE_REGION        us-south  
  Literal  CE_SUBDOMAIN     abcdabcdab  
Image:                  icr.io/codeengine/helloworld  
Resource Allocation:      
  CPU:                1  
  Ephemeral Storage:  400M  
  Memory:             4G  

Revisions:     
  myapp-00001:    
    Age:                42s  
    Latest:             true  
    Traffic:            100%  
    Image:              icr.io/codeengine/helloworld (pinned to 1cee99)  
    Running Instances:  1  

Runtime:       
  Concurrency:       100  
  Maximum Scale:     10  
  Minimum Scale:     0  
  Scale Down Delay:  0  
  Timeout:           300  

Conditions:    
  Type                 OK    Age  Reason  
  ConfigurationsReady  true  25s    
  Ready                true  12s    
  RoutesReady          true  12s    

Events:        
  Type    Reason   Age  Source              Messages  
  Normal  Created  44s  service-controller  Created Configuration "myapp"  
  Normal  Created  43s  service-controller  Created Route "myapp"  

Instances:     
  Name                                    Revision     Running  Status   Restarts  Age  
  myapp-00001-deployment-d59b87654-xkqh7  myapp-00001  3/3      Running  0         43s

Befehlsoptionen

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce app list --sort-by age

Beispielausgabe

Listing all applications...
OK

Name           Status  URL                                                                    Latest                 Age   Conditions  Reason
myapptestapp2  Ready   https://myapptestapp2.4svg40kna19.us-south.codeengine.appdomain.cloud  myapptestapp2-emy0q-1  52s   3 OK / 3
myapptestapp1  Ready   https://myapptestapp1.4svg40kna19.us-south.codeengine.appdomain.cloud  myapptestapp1-ps4ca-1  104s  3 OK / 3
myapp-e        Ready   https://myapp-e.4svg40kna19.us-south.codeengine.appdomain.cloud        myapp-e-gx6xa-1        12m   3 OK / 3
myappd         Ready   https://myappd.4svg40kna19.us-south.codeengine.appdomain.cloud         myappd-lxjxm-1         13m   3 OK / 3
myappc         Ready   https://myappc.4svg40kna19.us-south.codeengine.appdomain.cloud         myappc-qffan-1         14m   3 OK / 3
myappb         Ready   https://myappb.4svg40kna19.us-south.codeengine.appdomain.cloud         myappb-i3hw3-1         15m   3 OK / 3
myapp          Ready   https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud          myapp-jmxwd-1          17m   3 OK / 3

Befehlsoptionen

--all-containers, --all

Protokolle aller Container der angegebenen Anwendungsinstanzen anzeigen. Dieser Wert ist optional. Der Standardwert ist false.

--application, --app, -a, --name, -n

Zeigt die Protokolle aller Instanzen der angegebenen Anwendung an. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

--follow, -f

Verfolgen Sie die Protokolle der Anwendungsinstanzen. Verwenden Sie diese Option, um Protokolle von Anwendungsinstanzen zu streamen. Wenn Sie die Option --follow angeben, müssen Sie diesen Protokollbefehl mit der Tastenkombination Ctrl+C beenden. Dieser Wert ist optional. Der Standardwert ist false.

--instance, -i

Der Name einer bestimmten Anwendungsinstanz. Verwenden Sie den Befehl app get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --application nicht angegeben ist.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--raw, -r

Protokolle ohne Instanz-und Containerbeschriftungen anzeigen. Dieser Wert ist optional. Der Standardwert ist false.

--tail, -t

Begrenzt die Anzeige der Protokolle von Containern der angegebenen Anwendungsinstanzen auf eine maximale Anzahl der neuesten Zeilen pro Container. Um beispielsweise die letzten 3 Zeilen der Protokolle der Container der angegebenen Anwendungsinstanzen anzuzeigen, geben Sie --tail 3 an. Wird diese Option nicht angegeben, werden alle Zeilen der Protokolle der Container der angegebenen Anwendungsinstanzen angezeigt. Dieser Wert ist optional. Der Standardwert ist -1.

--timestamps, --ts

Zeitmarke in jeder Zeile der Protokollausgabe einfügen. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel werden die Protokolle für eine bestimmte Instanz einer App angezeigt. Mit dem Befehl app get können Sie die Namen der App-Instanzen abrufen.

ibmcloud ce application logs --instance myapp-zhk9x-1-deployment-6f955f5cc5-abcde

Beispielausgabe

Getting logs for application instance 'myapp-zhk9x-1-deployment-6f955f5cc5-abcde'...
OK

myapp-zhk9x-1-deployment-6f955f5cc5-abcde:
Server running at http://0.0.0.0:8080/

Beispiel für Protokolle aller Instanzen einer App

Im folgenden Beispiel werden die Protokolle aller Instanzen einer App angezeigt.

ibmcloud ce application logs --app myapp

Getting application 'myapp'...
Getting revisions for application 'myapp'...
Getting instances for application 'myapp'...
Getting logs for all instances of application 'myapp'...
OK

myapp-zhk9x-1-deployment-6f955f5cc5-abcde:
Server running at http://0.0.0.0:8080/

Befehlsoptionen

--application, --app, -a, --name, -n

Starten Sie alle aktiven Instanzen der angegebenen Anwendung erneut. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

--instance, -i

Der Name einer bestimmten Anwendungsinstanz. Verwenden Sie den Befehl app get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --application nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce application restart --name myapp

Beispielausgabe

Restarting all running instances of application 'myapp'...
OK

Befehlsoptionen

--name, -n

Der Name der Anwendung, deren Bindung aufgehoben werden soll. Dieser Wert ist erforderlich.

--all, -A

Hebt die Bindung aller Serviceinstanzen an die Anwendung auf. Dieser Wert ist erforderlich, wenn --binding nicht angegeben ist. Der Standardwert ist false.

--binding, -b

Der Name der Bindung, die aufgehoben werden soll. Führen Sie den Befehl ibmcloud ce app get -n APP_NAME aus, um die Bindungsnamen anzuzeigen. Dieser Wert ist erforderlich, wenn --all nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel werden alle Bindungen der Anwendung myapp entfernt.

ibmcloud ce application unbind --name myapp --all

Beispielausgabe

Removing service bindings...
OK

Befehlsoptionen

--name, -n

Der Name der Anwendung. Dieser Wert ist erforderlich.

--argument, --arg, -a

Legt die Argumente für die Anwendung fest. Geben Sie für jede Option des Typs --argument ein Argument an; Beispiel: -a argA -a argB. Dieser Wert ist optional.

--arguments-clear, --ac

Anwendungsargumente löschen. Dieser Wert ist optional. Der Standardwert ist false.

--build-clear, --bc

Zuordnung eines Builds aus dieser Anwendung entfernen. Die Option „Build löschen“ ist nur verfügbar, wenn Ihrer App derzeit ein zugehöriger Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist false.

--build-commit, --commit, --bcm, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Die Option „Build Commit“ ist nur zulässig, wenn die --build-source Option auf eines Git URL Repositorys in diesem app update Befehl gesetzt ist oder Ihre Anwendung derzeit über einen zugehörigen Build aus einer Git Repository-Quelle verfügt. Dieser Wert ist optional.

--build-commit-clear, --commit-clear, --bcmc, --cmc

Löschen Sie das Commit, den Tag oder die Verzweigung im Quellenrepository, um eine Pull-Operation durchzuführen. Die Option „commit clear“ ist zulässig, wenn Ihre Anwendung derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--build-context-dir, --context-dir, --bcdr, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Die Option für das Build-Kontextverzeichnis ist zulässig, wenn die Option --build-source in diesem app update-Befehl festgelegt ist oder wenn Ihrer Anwendung aktuell ein Build zugeordnet ist. Dieser Wert ist optional.

--build-dockerfile, --dockerfile, --bdf, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Die Option „build dockerfile“ ist nur zulässig, wenn die --build-source Option in diesem app update Befehl festgelegt ist oder Ihre Anwendung derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist nur zulässig, wenn die --build-source Option auf das GitURL Repository dieses application update Befehls gesetzt ist oder Ihre Anwendung derzeit über einen zugehörigen Build aus einer Git Repository-Quelle verfügt. Dieser Wert ist optional.

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Löschen Sie den geheimen SSH-Schlüssel. Diese Option ist zulässig, wenn Ihre Anwendung derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--build-size, --size, --bsz, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Die Option „Build-Größe“ ist nur zulässig, wenn die --build-source Option in diesem app update Befehl festgelegt ist oder Ihre Anwendung derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist medium.

--build-source, --source, --bsrc, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Dieser Wert ist optional.

--build-strategy, --strategy, --bstr, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Gültige Werte sind dockerfile und buildpacks. Die Option „Build-Strategie“ ist nur zulässig, wenn die --build-source Option in diesem app update Befehl festgelegt ist oder Ihre Anwendung derzeit über einen zugehörigen Build verfügt. Wenn keine Angabe erfolgt, wird die Erstellungsstrategie von Code Engine bestimmt, wenn --build-source angegeben ist und sich die Quelle auf Ihrer lokalen Workstation befindet. Dieser Wert ist optional. Der Standardwert ist dockerfile.

--build-timeout, --bto

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Die Option „Build-Timeout“ ist nur zulässig, wenn die --build-source Option in diesem app update Befehl festgelegt ist oder Ihre Anwendung derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist 600.

--cluster-local, --cl

Anwendung mit einem Nur-Projekt-Endpunkt implementieren. Das Festlegen eines reinen Projektendpunkts bedeutet, dass Ihre App nicht über das öffentliche Internet zugänglich ist und der Netzzugriff nur über andere Code Engine-Komponenten möglich ist, die in demselben Projekt ausgeführt werden. Dieser Wert ist optional. Der Standardwert ist false.

--command, --cmd, -c

Legt die Befehle für die Anwendung fest. Geben Sie für jede Option des Typs --command einen Befehl an; Beispiel: --cmd cmdA --cmd cmdB. Dieser Wert überschreibt den Standardbefehl, der im Container-Image angegeben ist. Dieser Wert ist optional.

--commands-clear, --cc

Anwendungsbefehle löschen. Dieser Wert ist optional. Der Standardwert ist false.

--concurrency, --cn

Die maximale Anzahl der Anforderungen, die pro Instanz gleichzeitig verarbeitet werden können. Dieser Wert ist optional. Der Standardwert ist 0.

--concurrency-target, --ct

Der Schwellenwert für gleichzeitige Anforderungen pro Instanz, ab dem eine oder mehrere weitere Instanzen erstellt werden. Verwenden Sie diesen Wert, um ausgehend von der Anzahl gleichzeitiger Anforderungen ein Scale-up für Instanzen durchzuführen. Diese Option nimmt standardmäßig den Wert der Option --concurrency-target an, falls --concurrency nicht angegeben wird. Dieser Wert ist optional. Der Standardwert ist 0.

--cpu

Die CPU-Kapazität, die für die Instanz der Anwendung festgelegt wurde. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 0.

--env, -e

Legt die Umgebungsvariablen in der Anwendung fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: --env envA=A --env envB=B. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-from-configmap-rm, --env-cm-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige Konfigurationszuordnungen mithilfe des Konfigurationszuordnungsnamens. Wenn Sie einzelne Schlüsselverweise auf Konfigurationszuordnungen entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--env-from-secret-rm, --env-sec-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige geheime Schlüssel mithilfe des Namens des geheimen Schlüssels. Wenn Sie einzelne Schlüsselverweise auf geheime Schlüssel entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-rm

Entfernt Verweise von Umgebungsvariablen auf den Schlüssel eines Schlüssel/Wert-Paars in einer Konfigurationszuordnung oder in einem geheimen Schlüssel. Wenn Sie einzelne Schlüsselverweise und Literalwerte entfernen möchten, geben Sie den Namen des Schlüssels an. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--ephemeral-storage, --es

Die Menge des ephemeren Speichers, die für die Instanz der Anwendung festgelegt werden soll. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit den Optionen --env-from-configmap oder --mount-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit den Optionen --env-from-secret, --mount-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--image, -i

Der Name des Image, das für diese Anwendung verwendet wird. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei sind REGISTRY und TAG optional. Wird REGISTRY nicht angegeben, ist docker.io der Standardwert. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

--max-scale, --max, --maxscale

Die maximale Anzahl der Instanzen, die für diese Anwendung verwendet werden können. Wenn Sie diesen Wert auf 0 setzen, wird die Anwendung nach Bedarf skaliert. Die Anwendungsskalierung wird nur durch die Instanzen pro Ressourcenkontingent für das Projekt Ihrer Anwendung begrenzt. Grenzwerte und Kontingente für Code Engine enthält weitere Informationen hierzu. Dieser Wert ist optional. Der Standardwert ist 10.

--memory, -m

Die Menge des Hauptspeichers für die Instanz der Anwendung. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional.

--min-scale, --min, --minscale

Die minimale Anzahl der Instanzen, die für diese Anwendung verwendet werden können. Dieser Wert ist optional. Der Standardwert ist 0.

--mount-configmap, --mount-cm

Fügen Sie den Inhalt einer Konfigurationszuordnung (configmap) zum Dateisystem Ihres Anwendungscontainers hinzu, indem Sie ein Mountverzeichnis und den Namen einer Konfigurationszuordnung im Format MOUNT_DIRECTORY=CONFIGMAP_NAME angeben. Jede angehängte Konfigurationszuordnung muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in der Konfigurationszuordnung wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-configmap an; Beispiel: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Dieser Wert ist optional.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--mount-rm

Entfernen Sie den Inhalt einer Konfigurationszuordnung oder eines geheimen Schlüssels aus dem Dateisystem Ihres Anwendungscontainers, indem Sie das Verzeichnis angeben, in dem die Konfigurationszuordnung oder der geheime Schlüssel angehängt ist. Geben Sie ein Mountverzeichnis pro Option des Typs --mount-rm an. Beispiel: --mount-rm /etc/configmap-a --mount-rm /etc/secret-b. Dieser Wert ist optional.

--mount-secret, --mount-sec

Fügen Sie den Inhalt eines geheimen Schlüssels zum Dateisystem Ihres Anwendungscontainers hinzu, indem Sie ein Mountverzeichnis und den Namen eines geheimen Schlüssels im Format MOUNT_DIRECTORY=SECRET_NAME angeben. Jeder angehängte geheime Schlüssel muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in dem geheimen Schlüssel wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-secret an; Beispiel: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Dieser Wert ist optional.

--no-cluster-local, --ncl

Anwendung mit einem öffentlichen Endpunkt bereitstellen. Die Anwendung wird so bereitgestellt, dass sie Anforderungen aus dem öffentlichen Internet oder von Komponenten im Code Engine-Projekt empfangen kann. Dieser Wert ist optional. Der Standardwert ist true.

--no-wait, --nw

Aktualisieren Sie die Anwendung und warten Sie nicht darauf, dass sie den Status 'Bereit' erhält. Wenn Sie die Option no-wait angeben, wird die Anwendungsaktualisierung ohne Wartezeit gestartet. Mit dem Befehl app get können Sie den Anwendungsstatus überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, url und project-url. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--port, -p

Der Port, an dem die Anwendung empfangsbereit ist. Das Format ist [NAME:]PORT, wobei [NAME:] optional ist. Wenn [NAME:] angegeben ist, sind h2c und http1 die gültigen Werte. Wenn [NAME:] nicht angegeben ist oder http1 angegeben ist, wird vom Port 'HTTP/1.1' verwendet. Wenn für [NAME:] der Wert h2c festgelegt wurde, wird vom Port unverschlüsseltes HTTP/2 verwendet. Standardmäßig geht Code Engine davon aus, dass Apps an Port 8080 für eingehende Verbindungen empfangsbereit sind. Wenn die Anwendung an einem anderen Port als dem Port 8080 empfangsbereit sein muss, verwenden Sie --port, um den Port anzugeben. Dieser Wert ist optional.

--probe-live, --pl

Konfigurieren Sie den Liveness-Test für diese Anwendung im Format NAME=VALUE. Gültige Optionen für NAME sind: type, port, path, interval, initial-delay, timeout, failure-threshold. Diese Option kann mehrmals angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel, --probe-live Typ=tcp --probe-live port=8080. Weitere Informationen zum Arbeiten mit Tests finden Sie unter Tests für Ihre App konfigurieren. Dieser Wert ist optional.

--probe-live-clear, --plr

Entfernen Sie den Aktivitätsprüfung. Diese Option ist nur zulässig, wenn Ihre App momentan über einen Aktivitätsprüfung verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--probe-ready, --pr

Konfigurieren Sie die Bereitschaftsprüfung für diese Anwendung im Format NAME=VALUE. Gültige Optionen für NAME sind: type, port, path, interval, initial-delay, timeout, failure-threshold. Diese Option kann mehrmals angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel, --probe-ready Typ=tcp --probe-ready port=8080. Weitere Informationen zum Arbeiten mit Tests finden Sie unter Tests für Ihre App konfigurieren. Dieser Wert ist optional.

--probe-ready-reset, --prr

Setzt die Bereitschaftsprüfung auf die Standardkonfiguration zurück. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--rebuild

Wiederholen Sie die Erstellung des Image aus der Quelle. Die Option zur Neuerstellung ist zulässig, wenn Ihrer Anwendung aktuell ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Dieser Wert ist optional.

--registry-secret-clear, --rsc

Löschen Sie den geheimen Registry-Schlüssel. Dieser Wert ist optional. Der Standardwert ist false.

--request-timeout, --rt, --timeout, -t

Die Zeit in Sekunden, die verstreichen kann, bevor Anforderungen an die Anwendung erfolgreich beendet werden oder fehlschlagen. Dieser Wert ist optional. Der Standardwert ist 0.

--rn, --revision-name

Der Name der Revision. Verwenden Sie einen Namen, der innerhalb der Anwendung eindeutig ist.

• Der Name kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.
• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung enden.
• Der vollständig qualifizierte Revisionsname muss das Format Name_of_application-Name of revisionhaben.
• Der vollständig qualifizierte Revisionsname darf maximal 63 Zeichen lang sein.

Dieser Wert ist optional.

--scale-down-delay, --sdd

Die Zeit in Sekunden, die bei reduziertem gemeinsamen Zugriff vergehen muss, bevor die Anwendung herunterskaliert wird. Eine Erhöhung der Anzahl gleichzeitiger Anforderungen führt dazu, dass eine Anwendung vertikal skaliert wird. Wenn die Anzahl der Anforderungen fällt (reduzierter gemeinsamer Zugriff), bestimmt die angegebene Zeit für diese Option, wie lange der reduzierte gemeinsame Zugriff bestehen bleiben muss, bevor die Anwendung nach unten skaliert wird. Standardmäßig wird für die Anwendung sofort ein Scale-down durchgeführt, wenn ein reduzierter gemeinsamer Zugriff erkannt wird. Dieser Wert ist optional. Der Standardwert ist 0.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--service-account-clear, --sac

Löschen Sie das Dienstkonto. Dieser Wert ist optional. Der Standardwert ist false.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens an den Container dieser Anwendung. Dieser Wert ist optional. Der Standardwert ist false.

--user, -u

Die Benutzer-ID (UID), die zur Ausführung der Anwendung verwendet wird. Durch diesen Wert wird eine Benutzer-ID überschrieben, die in der Dockerfile der Anwendung festgelegt ist. Die ID muss den Betriebssystemvoraussetzungen des Containers entsprechen. Dieser Wert ist optional. Der Standardwert ist 0.

--visibility, -v

Die Sichtbarkeit der Anwendung. Gültige Werte sind public, private, und project. Das Festlegen der Sichtbarkeit von public bedeutet, dass Ihre App Anforderungen vom öffentlichen Internet oder von Komponenten innerhalb des Code Engine-Projekts empfangen kann. Das Festlegen der Sichtbarkeit von private bedeutet, dass Ihre App nicht über das öffentliche Internet zugänglich ist und der Netzzugriff nur über andere IBM Cloud-Instanzen möglich ist, die Virtual Private Endpoints (VPE) oder Code Engine-Komponenten verwenden, die in demselben Projekt ausgeführt werden. Sichtbarkeit kann nur private sein, wenn das Projekt die private Sichtbarkeit von Anwendungen unterstützt. Das Festlegen der Sichtbarkeit von project bedeutet, dass Ihre App nicht über das öffentliche Internet zugänglich ist und der Netzzugriff nur über andere Code Engine-Komponenten möglich ist, die in demselben Projekt ausgeführt werden. Dieser Wert ist optional.

--wait, -w

Aktualisieren Sie die Anwendung und warten Sie, bis die Anwendung den Status 'Bereit' hat. Wenn Sie die Option --wait angeben, wird mit der Anwendungsaktualisierung eine bestimmte maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt ist, bis die Anwendung den Status 'Bereit' ausweist. Wenn die Anwendung innerhalb des angegebenen Zeitraums --wait-timeout nicht bereit ist, schlägt die Erstellung der Anwendung fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum, der abgewartet werden soll, bis die Anwendung aktualisiert wurde. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce application update --name myapp --image icr.io/codeengine/hello

Beispielausgabe

Updating application 'myapp' to latest revision.
[...]
Run 'ibmcloud ce application get -n myapp' to check the application status.
OK

https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

Beispiel

ibmcloud ce beta help

Beispielausgabe

NAME:
  ibmcloud code-engine beta - Beta Code Engine commands

USAGE:
  ibmcloud code-engine beta command [arguments...] [command options]

COMMANDS:
  help, h   Show help

Enter 'ibmcloud code-engine beta help [command]' for more information about a command.

Befehlsoptionen

-n, --name

Der Name des Builds. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 63 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist erforderlich.

--build-type, --bt

Der Typ des Builds. Gültige Werte sind git und local. Wenn der Typ des Builds local ist, sind die Optionen --source, --commit und --git-repo-secret nicht gültig. Dieser Wert ist optional. Der Standardwert ist git.

--commit, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Die Commitoption ist zulässig, wenn die Option --build-type auf git festgelegt ist, und nicht, wenn die Option --build-type auf local festgelegt ist. Dieser Wert ist optional.

--context-dir, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Dieser Wert ist optional.

--dockerfile, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--force, -f

Das Vorhandensein der angegebenen geheimen Referenzen wird nicht überprüft. Referenzen zu geheimen Schlüsseln werden mit den Optionen --get-repo-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--git-repo-secret, --grs, --repo, -r

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist zulässig, wenn die Option --build-type auf git gesetzt ist, und nicht, wenn die Option --build-type auf local gesetzt ist. Dieser Wert ist optional.

--image, -i

Die Position der Image-Registry. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei ist TAG optional. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Das Registrierungsgeheimnis, das für den Zugriff auf die Registrierung verwendet wird. Sie können den Registrierungsschlüssel hinzufügen, indem Sie den registry create Befehl ausführen. Dieser Wert ist optional.

--size, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Dieser Wert ist optional. Der Standardwert ist medium.

--source, --src

Die URL des Git-Repositorys, in dem der Quellcode enthalten ist; Beispiel: https://github.com/IBM/CodeEngine. Die Quellenoption ist erforderlich, wenn die Option --build-type auf git festgelegt ist, und nicht zulässig, wenn die Option --build-type auf local festgelegt ist. Dieser Wert ist optional.

--strategy, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Für Anwendungen und Jobs sind gültige dockerfile Werte und buildpacks. Für Funktionen haben gültige Werte das Format codebundle-[RUNTIME-ID]. Wenn Sie beispielsweise ein Codepaket für Ihre Funktion mit der Laufzeit-ID nodejs-20 erstellen wollen, verwenden Sie codebundle-nodejs-20 als Erstellungsstrategie. Sie finden die ID jeder unterstützten Funktionslaufzeit, indem Sie den Befehl ibmcloud ce fn runtimes ausführen. Dieser Wert ist optional. Der Standardwert ist dockerfile.

--timeout, --to

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Dieser Wert ist optional. Der Standardwert ist 600.

Beispiel

Im folgenden Beispiel wird eine Buildkonfigurationsdatei mit dem Namen helloworld-build aus einer Quelle-Dockerfile erstellt, die sich in https://github.com/IBM/CodeEngine im Verzeichnis hello in der Verzweigung main befindet, wobei die Strategie dockerfile sowie die Größe medium verwendet werden. Wenn dieser Build übergeben wird, wird das erstellte Container-Image in einer Container Registry-Instanz unter us.icr.io/mynamespace/codeengine-helloworld gespeichert, auf die über einen geheimen Schlüssel der Image-Registry mit dem Namen myregistry zugegriffen wird.

ibmcloud ce build create --name helloworld-build --source https://github.com/IBM/CodeEngine  --context-dir /hello --commit main --strategy dockerfile --size medium --image us.icr.io/mynamespace/codeengine-helloworld --registry-secret myregistry

Beispielausgabe

Creating build helloworld-build...
OK

Befehlsoptionen

--name, -n

Der Name des Builds. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce build delete --name helloworld-build

Beispielausgabe

Are you sure you want to delete build helloworld-build? [y/N]> y
Deleting build 'helloworld-build'...
OK

Befehlsoptionen

--name, -n

Der Name des Builds. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce build get --name helloworld-build

Beispielausgabe

Getting build 'helloworld-build'
OK

Name:          helloworld-build
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           15s
Created:       2021-03-14T14:48:19-05:00  
Status:        Succeeded
Reason:        all validations succeeded

Last Build Run:
  Name:     helloworld-build-run
  Age:      39d
  Created:  2021-09-30T15:19:33-04:00

Image:              us.icr.io/mynamespace/codeengine-helloworld
Registry Secret:    myregistry
Build Strategy:     dockerfile-medium
Timeout:            10m0s
Source:             https://github.com/IBM/CodeEngine
Commit:             main
Context Directory:  /hello
Dockerfile:         Dockerfile

Build Runs:
  Name                  Status                              Image                                        Age
  helloworld-build-run  All Steps have completed executing  us.icr.io/mynamespace/codeengine-helloworld  39d

Befehlsoptionen

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce build list

Beispielausgabe

Listing builds...
OK

Name                    Status     Reason                     Image                                               Build Strategy     Age    Last Build Run Name                        Last Build Run Age
myhellobuild           Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-200      dockerfile-medium  160d   myhellobuild-run-4xdnb                    160d
hello-build-5ckgs      Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-51       dockerfile-medium  39d    helloapp3-build-5ckgs-run-210803-2129500   39d
hello-build-pmg6v      Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-4f       dockerfile-medium  40d    hellooapp2-build-pmg6v-run-210802-2112310  40d
helloworld-build       Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-helloworld          dockerfile-medium  39d    helloworld-build-run                       39d

Befehlsoptionen

--name, -n

Der Name des Builds. Dieser Wert ist erforderlich.

--commit, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Dieser Wert ist optional.

--commit-clear, --cmc

Löschen Sie das Commit, den Tag oder die Verzweigung im Quellenrepository, um eine Pull-Operation durchzuführen. Dieser Wert ist optional. Der Standardwert ist false.

--context-dir, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Dieser Wert ist optional.

--dockerfile, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--force, -f

Das Vorhandensein der angegebenen geheimen Referenzen wird nicht überprüft. Referenzen zu geheimen Schlüsseln werden mit den Optionen --get-repo-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--git-repo-secret, --grs, --repo, -r

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Dieser Wert ist optional.

--git-repo-secret-clear, --grsc

Löschen Sie den geheimen SSH-Schlüssel. Dieser Wert ist optional. Der Standardwert ist false.

--image, -i

Die Position der Image-Registry. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei ist TAG optional. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Dieser Wert ist optional.

--size, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Dieser Wert ist optional.

--source, --src

Die URL des Git-Repositorys, in dem der Quellcode enthalten ist; Beispiel: https://github.com/IBM/CodeEngine. Dieser Wert ist optional.

--strategy, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Für Anwendungen und Jobs sind gültige dockerfile Werte und buildpacks. Für Funktionen haben gültige Werte das Format codebundle-[RUNTIME-ID]. Wenn Sie beispielsweise ein Codepaket für Ihre Funktion mit der Laufzeit-ID nodejs-20 erstellen wollen, verwenden Sie codebundle-nodejs-20 als Erstellungsstrategie. Sie finden die ID jeder unterstützten Funktionslaufzeit, indem Sie den Befehl ibmcloud ce fn runtimes ausführen. Dieser Wert ist optional.

--timeout, --to

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Dieser Wert ist optional. Der Standardwert ist 600.

Beispiel

ibmcloud ce build update --name helloworld-build --source https://github.com/IBM/CodeEngine  --context-dir /hello --commit main --timeout 900

Beispielausgabe

Updating build helloworld-build...
OK

Befehlsoptionen

--name, -n

Der Name der Buildausführung. Dieser Wert ist erforderlich.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce buildrun cancel --name mybuildrun

Beispielausgabe

Cancelling build run 'mybuildrun'...
OK

Befehlsoptionen

--build, -b

Verwenden Sie diese Option, um alle Build-Läufe des angegebenen Builds zu löschen. Die Option --build ist erforderlich, wenn Sie den Wert für --name nicht angeben. Dieser Wert ist optional.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--name, -n

Der Name der Buildausführung. Die Option --name ist erforderlich, wenn Sie den Wert für --build nicht angeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce buildrun delete --name mybuildrun

Beispielausgabe

Are you sure you want to delete build run mybuildrun? [y/N]> y
Deleting build run 'mybuildrun'...
OK

Befehlsoptionen

--buildrun, -b, --br, --name, -n

Der Name der Buildausführung. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

In diesem Beispiel werden die Systemereignisinformationen für eine Buildausführung angezeigt.

ibmcloud ce buildrun events --buildrun mybuildrun

Beispielausgabe

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting events for build run 'mybuildrun'...
OK

mybuildrun-l4mr2-pod-89z4t:
    Type    Reason     Age  Source                  Messages
    Normal  Scheduled  33s  default-scheduler       Successfully assigned 4svg40kna19/mybuildrun-l4mr2-pod-89z4t to 10.240.128.97
    Normal  Pulled     31s  kubelet, 10.240.128.97  Container image "gcr.io/distroless/base@sha256:92720b2305d7315b5426aec19f8651e9e04222991f877cae71f40b3141d2f07e" already present on machine
    Normal  Created    31s  kubelet, 10.240.128.97  Created container working-dir-initializer
    Normal  Started    31s  kubelet, 10.240.128.97  Started container working-dir-initializer
    Normal  Pulled     30s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/entrypoint-bff0a22da108bc2f16c818c97641a296:v0.20.1-rc2@sha256:19ec0672b5e84a4c5939c6ece6fa69efbce0d38479baf35ce894cf1c67f7e435" already present on machine
    Normal  Created    30s  kubelet, 10.240.128.97  Created container place-tools
    Normal  Started    29s  kubelet, 10.240.128.97  Started container place-tools
    Normal  Pulled     28s  kubelet, 10.240.128.97  Container image "gcr.io/distroless/base@sha256:92720b2305d7315b5426aec19f8651e9e04222991f877cae71f40b3141d2f07e" already present on machine
    Normal  Created    28s  kubelet, 10.240.128.97  Created container step-create-dir-image-l7lf2
    Normal  Created    25s  kubelet, 10.240.128.97  Created container step-git-source-source-46fm7
    Normal  Pulled     25s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/git-init-4874978a9786b6625dd8b6ef2a21aa70:v0.20.1-rc2@sha256:5febfb32459a114b7beafdc593770a0f692a09d874ac6b59ce85507844641cdf" already present on machine
    Normal  Started    25s  kubelet, 10.240.128.97  Started container step-create-dir-image-l7lf2
    Normal  Started    24s  kubelet, 10.240.128.97  Started container step-git-source-source-46fm7
    Normal  Pulled     24s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/kaniko/executor:v1.3.0-rc1" already present on machine
    Normal  Created    24s  kubelet, 10.240.128.97  Created container step-build-and-push
    Normal  Started    24s  kubelet, 10.240.128.97  Started container step-build-and-push
    Normal  Pulled     24s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/imagedigestexporter-6e7c518e6125f31761ebe0b96cc63971:v0.20.1-rc2@sha256:21b3120ce9b930b4eb1359eb20a3109e3a6643e9d2777ef9694efb033367e57c" already present on machine
    Normal  Created    24s  kubelet, 10.240.128.97  Created container step-image-digest-exporter-gnbrp
    Normal  Started    23s  kubelet, 10.240.128.97  Started container step-image-digest-exporter-gnbrp

Befehlsoptionen

--name, -n

Der Name der Buildausführung. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce buildrun get --name mybuildrun

Beispielausgabe

Getting build run 'mybuildrun'...
Run 'ibmcloud ce buildrun events -n mybuildrun' to get the system events of the build run.
Run 'ibmcloud ce buildrun logs -f -n mybuildrun' to follow the logs of the build run.
OK

Name:          mybuildrun
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m  
Created:       2021-03-14T14:50:13-05:00  

Summary:       Succeeded  
Status:        Succeeded  
Reason:        All Steps have completed executing  
Source:          
  Commit Branch:  main  
  Commit SHA:     abcdeb88263442e28af6ae26d2082dea1d6abcde  
  Commit Author:  myauthor  
Image Digest:  sha256:522488ca3b54eb65f8c1e609a7b27c08558d08166fe062e7dde6838d4a609d61  

Image:  us.icr.io/mynamespace/test

Befehlsoptionen

--build, -b

Verwenden Sie diese Option, um nur Build-Läufe des angegebenen Builds anzuzeigen. Dieser Wert ist optional.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce buildrun list

Beispielausgabe

Listing builds...
OK

Name                                  Status     Build Name        Age
helloworld-build-run                  Succeeded  helloworld-build  5d22h
mybuildrun                            Succeeded  helloworld-build  7m23s
mybuildrun2                           Succeeded  helloworld-build  3m4s

Befehlsoptionen

--buildrun, -b, --br, --name, -n

Der Name der Buildausführung. Dieser Wert ist erforderlich.

--follow, -f

Verfolgen Sie die Protokolle der Buildausführung. Verwenden Sie diese Option, um Protokolle der Buildausführung zu streamen. Wenn Sie die Option --follow angeben, müssen Sie diesen Protokollbefehl mit der Tastenkombination Ctrl+C beenden. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--raw, -r

Protokolle ohne Instanz-und Containerbeschriftungen anzeigen. Dieser Wert ist optional. Der Standardwert ist false.

--tail, -t

Begrenzen Sie die Anzeige von Protokollen von Containern der angegebenen Buildausführung auf eine maximale Anzahl von zuletzt ausgeführter Zeilen pro Container. Um beispielsweise die letzten 3 Zeilen der Protokolle der Container der angegebenen Buildausführung anzuzeigen, geben Sie --tail 3 an. Wird diese Option nicht angegeben, werden alle Zeilen der Protokolle der Container der angegebenen Buildausführung angezeigt. Dieser Wert ist optional. Der Standardwert ist -1.

--timestamps, --ts

Zeitmarke in jeder Zeile der Protokollausgabe einfügen. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce buildrun logs --name mybuildrun

Beispielausgabe

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting logs for build run 'mybuildrun'...
OK

mybuildrun-v2mb8-pod-tlzdx/step-git-source-source-g2kbf:
{"level":"info","ts":1614089507.7123275,"caller":"git/git.go:165","msg":"Successfully cloned https://github.com/IBM/CodeEngine @ 433e2b8d6529e4a55f5e0f72d3772a79602a5ee8 (grafted, HEAD, origin/main) in path /workspace/source"}
{"level":"info","ts":1614089509.0128207,"caller":"git/git.go:203","msg":"Successfully initialized and updated submodules in path /workspace/source"}

mybuildrun-v2mb8-pod-tlzdx/step-build-and-push:
INFO[0000] Retrieving image manifest node:12-alpine
INFO[0000] Retrieving image node:12-alpine
INFO[0001] Retrieving image manifest node:12-alpine
INFO[0001] Retrieving image node:12-alpine
INFO[0001] Built cross stage deps: map[]
INFO[0001] Retrieving image manifest node:12-alpine
INFO[0001] Retrieving image node:12-alpine
INFO[0002] Retrieving image manifest node:12-alpine
INFO[0002] Retrieving image node:12-alpine
INFO[0002] Executing 0 build triggers
INFO[0002] Unpacking rootfs as cmd RUN npm install requires it.
INFO[0006] RUN npm install
INFO[0006] Taking snapshot of full filesystem...
INFO[0008] cmd: /bin/sh
INFO[0008] args: [-c npm install]
INFO[0008] Running: [/bin/sh -c npm install]
npm WARN saveError ENOENT: no such file or directory, open '/package.json'
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open '/package.json'
npm WARN !invalid#2 No description
npm WARN !invalid#2 No repository field.
npm WARN !invalid#2 No README data
npm WARN !invalid#2 No license field.

up to date in 0.27s
found 0 vulnerabilities

INFO[0010] Taking snapshot of full filesystem...
INFO[0010] COPY server.js .
INFO[0010] Taking snapshot of files...
INFO[0010] EXPOSE 8080
INFO[0010] cmd: EXPOSE
INFO[0010] Adding exposed port: 8080/tcp
INFO[0010] CMD [ "node", "server.js" ]

mybuildrun-v2mb8-pod-tlzdx/step-image-digest-exporter-hcvmf:
2021/02/23 14:11:43 warning: unsuccessful cred copy: ".docker" from "/tekton/creds" to "/tekton/home": unable to open destination: open /tekton/home/.docker/config.json: permission denied
{"severity":"INFO","timestamp":"2021-02-23T14:12:05.65581098Z","caller":"logging/config.go:115","message":"Successfully created the logger.","logging.googleapis.com/labels":{},"logging.googleapis.com/sourceLocation":{"file":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging/config.go","line":"115","function":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging.newLoggerFromConfig"}}
{"severity":"INFO","timestamp":"2021-02-23T14:12:05.655937558Z","caller":"logging/config.go:116","message":"Logging level set to: info","logging.googleapis.com/labels":{},"logging.googleapis.com/sourceLocation":{"file":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging/config.go","line":"116","function":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging.newLoggerFromConfig"}}

Befehlsoptionen

--build, -b, --bd

Der Name der Buildkonfiguration, die verwendet werden soll. Dieser Wert ist optional.

--commit, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Die Option zur Festschreibung des Builds ist zulässig, wenn die Option --source auf die URL eines Git-Repositorys gesetzt ist, und sie ist nicht zulässig, wenn die Option --source nicht auf die URL eines Git-Repositorys gesetzt ist. Dieser Wert ist optional.

--context-dir, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Die Option für das Buildkontextverzeichnis ist zulässig, wenn die Option --build nicht festgelegt ist, und sie ist nicht zulässig, wenn die Option --build festgelegt ist. Dieser Wert ist optional.

--dockerfile, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Die Build-Dockerfile-Option ist zulässig, wenn die Option --build nicht festgelegt ist, und sie ist nicht zulässig, wenn die Option --build festgelegt ist. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--git-repo-secret, --grs, --repo, -r

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf die URL eines Git-Repositorys gesetzt ist. Dieser Wert ist optional.

--image, -i

Die Position der Image-Registry. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei ist TAG optional. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

-n, --name

Der Name der Buildausführung. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist. Wenn die Option --build festgelegt ist, ist die Namensoption optional. Wenn die Option --build nicht festgelegt ist, ist die Namensoption erforderlich.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 63 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist optional.

--no-wait, --nw

Übergibt die Buildausführung und wartet nicht darauf, dass diese Buildausführung abgeschlossen wird. Wenn Sie die Option --no-wait angeben, wird die Übergabe der Buildausführung ohne Warten gestartet. Den Status der Buildausführung können Sie mit dem Befehl buildrun get überprüfen. Dieser Wert ist optional. Der Standardwert ist true.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Die Option „registry secret“ ist zulässig, wenn die --build Option nicht gesetzt ist, und un zulässig, wenn die --build Option gesetzt ist. Dieser Wert ist optional.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--size, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Die Option „Build Size“ ist zulässig, wenn die --build Option nicht gesetzt ist, und un zulässig, wenn die --build Option gesetzt ist. Dieser Wert ist optional. Der Standardwert ist medium.

--source, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Wenn die Option --build gesetzt ist, ist die Quellenoption erforderlich, wenn die Option --build-type für den zugehörigen Build local lautet, und sie ist nicht zulässig, wenn die Option --build-type für den zugehörigen Build git lautet. Wenn die Option --build nicht festgelegt ist, ist die Quellenoption optional. Dieser Wert ist optional. Der Standardwert ist ..

--strategy, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Für Anwendungen und Jobs sind gültige dockerfile Werte und buildpacks. Für Funktionen haben gültige Werte das Format codebundle-[RUNTIME-ID]. Wenn Sie beispielsweise ein Codepaket für Ihre Funktion mit der Laufzeit-ID nodejs-20 erstellen wollen, verwenden Sie codebundle-nodejs-20 als Erstellungsstrategie. Sie finden die ID jeder unterstützten Funktionslaufzeit, indem Sie den Befehl ibmcloud ce fn runtimes ausführen. Die Option „Build-Strategie“ ist zulässig, wenn die --build Option nicht gesetzt ist, und un zulässig, wenn die --build Option gesetzt ist. Wenn nicht angegeben, wird die Build-Strategie dadurch bestimmt Code Engine, ob angegeben --source ist und sich die Quelle auf Ihrem lokalen Rechner befindet. Dieser Wert ist optional. Der Standardwert ist dockerfile.

--timeout, --to

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Buildausführung fehl. Dieser Wert ist optional. Der Standardwert ist 600.

--wait, -w

Übergibt die Buildausführung und wartet darauf, dass diese Buildausführung abgeschlossen wird. Wenn Sie die Option --wait angeben, wartet der Befehl für die Übergabe der Buildausführung darauf, dass die Jobausführung abgeschlossen wird; die maximale Wartezeit hierfür wird in Sekunden durch die Option --wait-timeout angegeben. Falls die Buildausführung innerhalb des durch --wait-timeout angegebenen Zeitraums nicht abgeschlossen wird, schlägt die Übergabe der Buildausführung fehl. Dieser Wert ist optional. Der Standardwert ist false.

--wait-timeout, --wto

Gibt in Sekunden an, wie lange gewartet werden soll, bis diese Buildausführung abgeschlossen ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

Bei Ausführung des folgenden Befehls wird die Buildausführung mybuildrun übergeben und die Bildkonfigurationsdatei helloworld-build verwendet.

ibmcloud ce buildrun submit --name mybuildrun --build helloworld-build

Beispielausgabe

Submitting build run 'mybuildrun'...
Run 'ibmcloud ce buildrun get -n mybuildrun' to check the build run status.
OK

Befehlsoptionen

-n, --name

Der Name der Konfigurationszuordnung. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 253 Zeichen bestehen und kann Kleinbuchstaben, Zahlen, Punkte (.) und Bindestriche (-) enthalten.

Dieser Wert ist erforderlich.

--from-env-file, -e

Konfigurationszuordnung auf der Basis einer Datei erstellen, die eine oder mehrere Zeilen im Format KEY=VALUE enthält. Sie müssen den Pfad zur Datei als Wert angeben. 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. Dieser Wert ist erforderlich, wenn --from-literal oder --from-file nicht angegeben wird.

--from-file, -f

Konfigurationszuordnung auf der Basis einer Datei erstellen. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist erforderlich, wenn --from-literal oder --from-env-file nicht angegeben wird.

--from-literal, -l

Konfigurationszuordnung auf der Basis eines Schlüssel/Wert-Paars erstellen. Der Wert muss im Format KEY=VALUE angegeben werden. Dieser Wert ist erforderlich, wenn --from-file oder --from-env-file nicht angegeben wird. Diese Option kann mehrmals angegeben werden.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel wird eine Konfigurationszuordnung mit dem Namen configmap-fromliteral mit zwei Schlüsselpaarwerten erstellt: color=blue und size=large.

ibmcloud ce configmap create --name configmap-fromliteral --from-literal color=blue --from-literal size=large

Beispielausgabe

Creating Configmap 'configmap-fromliteral'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromliteral' to see more details.

Beispiel einer Konfigurationszuordnung mit Werten aus mehreren Dateien

Im folgenden Beispiel wird eine Konfigurationszuordnung mit dem Namen configmap-fromfile und mit Werten aus mehreren Dateien erstellt.

ibmcloud ce configmap create --name configmap-fromfile  --from-file ./color.txt --from-file ./size.txt

Creating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

Befehlsoptionen

--name, -n

Der Name der Konfigurationszuordnung. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce configmap delete --name configmap-fromliteral -f

Beispielausgabe

Deleting Configmap 'configmap-fromliteral'...
OK

Befehlsoptionen

--name, -n

Der Name der Konfigurationszuordnung. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce configmap get --name configmap-fromliteral

Beispielausgabe

Getting configmap 'configmap-fromliteral'...
OK

Name:          configmap-fromliteral
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21s
Created:       2021-03-01T13:50:56-05:00

Data:
---
color: blue
size: large

Befehlsoptionen

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce configmap list

Beispielausgabe

Listing Configmaps...
Name                    Data   Age
configmap-fromfile      2      19m13s
configmap-fromliteral   2      16m12s

Befehlsoptionen

--name, -n

Der Name der Konfigurationszuordnung. Dieser Wert ist erforderlich.

--from-env-file, -e

Konfigurationszuordnung auf der Basis einer Datei aktualisieren, die eine oder mehrere Zeilen im Format KEY=VALUE enthält. Sie müssen den Pfad zur Datei als Wert angeben. 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. Dieser Wert ist erforderlich, wenn --from-literal oder --from-file nicht angegeben wird. Diese Option kann mehrmals angegeben werden.

--from-file, -f

Aktualisiert eine Konfigurationszuordnung unter Verwendung einer Datei. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist erforderlich, wenn --from-literal oder --from-env-file nicht angegeben wird. Diese Option kann mehrmals angegeben werden.

--from-literal, -l

Konfigurationszuordnung auf der Basis eines Schlüssel/Wert-Paars aktualisieren. Der Wert muss im Format KEY=VALUE angegeben werden. Dieser Wert ist erforderlich, wenn --from-file oder --from-env-file nicht angegeben wird. Diese Option kann mehrmals angegeben werden.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--rm

Entfernt ein einzelnes Schlüssel/Wert-Paar in einer Konfigurationszuordnung durch Angeben des Schlüsselnamens. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

Beispiel

Im folgenden Beispiel wird eine Konfigurationszuordnung mit dem Namen configmap-fromliteral mit einem Paar aus Benutzername und Kennwort aktualisiert.

ibmcloud ce configmap update --name configmap-fromliteral --from-literal username=devuser --from-literal password='A!B99c$D1Def'

Beispielausgabe

Updating configmap 'configmap-fromliteral'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromliteral' to see more details.

Beispiel für eine Konfigurationszuordnung mit Werten aus einer Datei

Im folgenden Beispiel wird eine Konfigurationszuordnung mit dem Namen configmap-fromfile und mit Werten aus einer Datei aktualisiert.

ibmcloud ce configmap update --name configmap-fromfile  --from-file ./username.txt --from-file ./password.txt

Updating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

Beispiel

ibmcloud ce connectivity outbound create --name allow-to-subnet-a --cidr 5.6.7.8/29

Beispielausgabe

Creating allowed destination IP address range 'allow-to-subnet-a'...
OK

Beispiel für die Erstellung einer ausgehenden Verbindung über einen privaten Pfad

ibmcloud ce connectivity outbound create --name my-pps-connection --format pps --pps-crn crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f

Beispielausgabe zum Erstellen einer ausgehenden Verbindung mit privatem Pfad

Creating allowed outbound destination 'my-pps-connection'...
Successfully created allowed outbound destination 'my-pps-connection'. Current status is 'deploying'
Run 'ibmcloud ce connectivity outbound get --name my-pps-connection' to see more details.
OK

Beispiel

ibmcloud ce connectivity outbound delete --name allow-to-subnet-a

Beispielausgabe

Are you sure you want to delete allowed outbound destination 'allow-to-subnet-a'? [y/N]> y
Deleting allowed outbound destination 'allow-to-subnet-a'...
OK

Beispiel

ibmcloud ce connectivity outbound get --name allow-to-subnet-a

Beispielausgabe

Getting allowed outbound destination 'allow-to-subnet-a'...
OK

Project name:  myproj
Name:          allow-to-subnet-a
Format:        cidr_block  

IP address range:  5.6.7.8/29

Beispiel für eine ausgehende Verbindung über einen privaten Pfad

ibmcloud ce connectivity outbound get --name my-pps-connection

Beispiel für die Ausgabe einer ausgehenden Verbindung über einen privaten Pfad

Getting allowed outbound destination 'my-pps-connection'...
OK

Project name:  myproj
Name:          my-pps-connection
Format:        private_path_service_gateway  

Private path service:    
  CRN:        crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f
  Status:     ready  
  Name:       my-private-path--is-vpc-pps  
  Endpoints:    
    api.ce-1a2b3c4d5e6f.intra  

VPE gateway:             
  Name:          code-engine-prod-eu-de-1234ab
  IP addresses:    
    192.168.12.48
    192.168.24.60
    192.168.36.72

Beispiel

ibmcloud ce connectivity outbound list

Beispielausgabe

Listing allowed outbound destinations...
OK

CIDR ranges:                 
  Name               IP address range  
  allow-to-subnet-a  5.6.7.8/29
  allow-to-subnet-b  11.12.13.0/24

Private path connections:    
  Name               Status  Service endpoints  
  broken-connection  failed    
  my-pps-connection  ready   api.ce-1a2b3c4d5e6f.intra

Beispiel

ibmcloud ce connectivity outbound update --name allow-to-subnet-a --cidr 5.6.7.0/27

Beispielausgabe

Updating allowed destination IP address range 'allow-to-subnet-a'...
OK

Beispiel

ibmcloud ce connectivity subnetpool create --name my-other-pool \
  --subnet-crn S1=crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f21 \
  --security-group-crn S1=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g \
  --subnet-crn IDx=crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f22 \
  --security-group-crn IDx=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g \
  --security-group-crn IDx=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g8h

Beispielausgabe

OK
Successfully created subnet pool with name 'my-other-pool' and ID 'a23ff1d1-b845-4629-86d1-a4126155ad02'

Beispiel

ibmcloud ce connectivity subnetpool delete --name my-subnet-pool

Beispielausgabe

Are you sure you want to delete subnet pool '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'? [y/N]> y
Deleting subnet pool with name 'my-subnet-pool' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
OK

Beispiel

ibmcloud ce connectivity subnetpool get --name my-subnet-pool

Beispielausgabe

Getting subnet pool 'my-subnet-pool'...
OK

Name:          my-subnet-pool  
ID:            1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           114d  

Network placement:    
  Number of subnets:   1  

  Subnet CRN:          crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
  Security Group CRN:  crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g

Beispiel

ibmcloud ce connectivity subnetpool list

Beispielausgabe

Listing all subnet pools in a project...
OK

Name                          ID                                    Subnets  Region  Age  
auto-network-pool-gg55edn1xe  hgfedcba-dcba-abcd-abcd-1a2b3c4d5e6f  1        eu-de   93d  
my-other-pool                 abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  3        eu-de   25h  
my-subnet-pool                1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  1        eu-de   114d

Befehlsoptionen

--domain-name, --dn, -n, --name

Geben Sie den Namen der Domänenzuordnung an. Dieser Name muss ein gültiger vollständig qualifizierter Domänenname (FQDN) sein. Beispiel: www.example.com. Dieser Wert ist erforderlich.

--target, -t

Der Name der Zielanwendung oder -funktion. Dieser Wert ist erforderlich.

--target-type, --type

Der Typ des Ziels. Die gültigen Werte sind application oder function. Dieser Wert ist erforderlich.

--tls-secret, --secret, --tls

Geben Sie ein TLS-Geheimnis an, das das Zertifikat einschließlich aller Zwischenzertifikate und den entsprechenden privaten Schlüssel für die Domänenzuordnung enthält. Das Zertifikat muss von einer anerkannten öffentlichen Zertifizierungsstelle (CA) signiert sein. Selbst signierte Zertifikate werden nicht unterstützt. Dieser Wert ist erforderlich.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel wird eine angepasste Domänenzuordnung zwischen der Anwendung Code Engine myapp und der angepassten Domäne www.example.com erstellt und der geheime TLS-Schlüssel mytlssecret verwendet.

ibmcloud ce domainmapping create --domain-name www.example.com --target myapp --tls-secret mytlssecret

Beispielausgabe

OK
Domain mapping successfully created.

Befehlsoptionen

--domain-name, --dn, -n, --name

Der Name der Domänenzuordnung. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce domainmapping delete --name www.example.com -f

Beispielausgabe

Deleting domain mapping 'www.example.com'...
OK

Befehlsoptionen

--domain-name, --dn, -n, --name

Der Name der Domänenzuordnung. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce domainmapping get --name www.example.com

Beispielausgabe

Getting domainmapping 'www.example.com'...
OK

Domain Name:  www.example.com  
CNAME:        custom.abcdabcdabc.us-south.codeengine.appdomain.cloud  
Target Name:  myapp  
Target Type:  app  
TLS Secret:   mytlssecret  
Status:       ready  

Befehlsoptionen

--all, -a

Zeigen Sie alle Domänenzuordnungen in einem Projekt an, einschließlich angepasster Domänenzuordungen und Domänenzuordnungen des Systems. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

Das folgende Beispiel zeigt eine Liste aller angepassten Domänenzuordnungen.

ibmcloud ce domainmapping list

Beispielausgabe

Listing domain mappings...
OK

Name              CNAME                                                        Target  Target-Type  Status  Secret Name  Age  
www.example.com   custom.abcdabcdabc.us-south.codeengine.appdomain.cloud       myapp   app          ready   mytlssecret  36m    

Wenn Sie eine Liste aller Domänenzuordnungen für Ihre Anwendungen anzeigen möchten, einschließlich der angepassten Domänenzuordnungen und aller automatisch generierten Systemdomänenzuordnungen, geben Sie die Option --all mit dem Befehl ibmcloud ce domainmapping list an.

Befehlsoptionen

--domain-name, --dn, -n, --name

Der Name der Domänenzuordnung. Dieser Wert ist erforderlich.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--target, -t

Der Name der Zielanwendung oder -funktion. Dieser Wert ist optional.

--target-type, --type

Der Typ des Ziels. Die gültigen Werte sind application oder function. Dieser Wert ist optional.

--tls-secret, --secret, --tls

Geben Sie ein TLS-Geheimnis an, das das Zertifikat einschließlich aller Zwischenzertifikate und den entsprechenden privaten Schlüssel für die Domänenzuordnung enthält. Das Zertifikat muss von einer anerkannten öffentlichen Zertifizierungsstelle (CA) signiert sein. Selbst signierte Zertifikate werden nicht unterstützt. Dieser Wert ist optional.

Beispiel

Im folgenden Beispiel wird die Domänenzuordnung www.example.com aktualisiert, sodass mytlssecret2 anstelle von mytlssecret verwendet wird.

ibmcloud ce domainmapping update --domain-name www.example.com --tls-secret mytlssecret2

Beispielausgabe

Updating domainmapping 'www.example.com'...

Beispiel

ibmcloud ce experimental help

Beispielausgabe

NAME:
  ibmcloud code-engine experimental - Experimental Code Engine commands

USAGE:
  ibmcloud code-engine experimental command [arguments...] [command options]

COMMANDS:
  help, h   Show help

Enter 'ibmcloud code-engine experimental help [command]' for more information about a command.

Befehlsoptionen

--id, --fid, --fleet-id

Erforderlich. Die ID der serverlosen Flotte. Dieser Wert ist erforderlich.

--force, -f

Erzwungene Stornierung ohne Bestätigung. Dieser Wert ist optional. Der Standardwert ist false.

--hard

Sofortige Beendigung der serverlosen Flotte einschließlich der Aufgaben im Zustand running. Wenn Sie die Option hard nicht angeben, wird die Verarbeitung von Aufgaben im Zustand running fortgesetzt, bis sie einen endgültigen Zustand erreichen, und erst dann wechselt die Flotte in den Zustand canceled. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fleet cancel --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Beispielausgabe

Canceling serverless fleet...
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
OK

Name:            fleet-0123456789
ID:              1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
Status:          canceled  
Created:         39m  
Project region:  eu-de  
Project name:    myproj  

Tasks status:    
  Failed:      0  
  Canceled:    0  
  Successful:  0  
  Running:     0  
  Pending:     1  
  Total:       1  

Befehlsoptionen

--image, -i

Erforderlich. Der Name des Container-Images, das zur Verarbeitung der Aufgaben verwendet wird. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei sind REGISTRY und TAG optional. Wird REGISTRY nicht angegeben, ist docker.io der Standardwert. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist erforderlich.

--tasks-state-store, --ts-state

Erforderlich. Geben Sie den persistenten Datenspeicher an, in dem der Status der Aufgaben der Flotte gespeichert wird. Dieser Wert ist erforderlich.

--argument, --arg, -a

Legen Sie Befehlsargumente fest, die für die Ausführung des Befehls in der Aufgabe erforderlich sind. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--command, --cmd, -c

Legen Sie einen Befehl fest, der in der Aufgabe ausgeführt werden soll. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--cpu, --cp

Die Menge an CPU, die für eine Task festgelegt wird. Dieser Wert ist optional. Der Standardwert ist 1.

--env, -e

Setzen Sie Umgebungsvariablen, die an die Aufgabe übergeben werden sollen. Muss das Format NAME=WERT haben. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-from-configmap, --env-cm

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind. Geben Sie NAME an, um die vollständige Konfigurationszuordnung zu referenzieren, oder geben Sie PREFIX=NAME an, um die vollständige Konfigurationszuordnung zu referenzieren, wobei jeder Schlüssel das Präfix PREFIX hat, oder geben Sie NAME:KEY_A,KEY_B an, um einzelne Schlüssel zu referenzieren. Um einen neuen Namen für einen referenzierten Schlüssel anzugeben, verwenden Sie das Format NAME:NEW_KEY_NAME=KEY_A. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-from-secret, --env-sec

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in diesem Geheimnis gespeichert sind. Geben Sie NAME an, um den vollständigen geheimen Schlüssel zu referenzieren, oder PREFIX=NAME, um den vollständigen geheimen Schlüssel zu referenzieren, wobei jedem Schlüssel das Präfix PREFIX vorangestellt ist, oder NAME:KEY_A,KEY_B, um auf einzelne Schlüssel zu verweisen. Um einen neuen Namen für einen referenzierten Schlüssel anzugeben, verwenden Sie das Format NAME:NEW_KEY_NAME=KEY_A. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--gpu, --gp

Die Anzahl der GPUs, die der Ressource zugewiesen werden sollen. Das Format ist GPU_FAMILY:NUMBER_OF_GPUS. Die NUMBER_OF_GPUS hat standardmäßig den Wert 1 und kann ein Bruch sein. Zum Beispiel h100:0.5 Dieser Wert ist optional.

--max-scale, --maxscale, --max

Maximale Anzahl von Aufgabeninstanzen, die parallel ausgeführt werden sollen. Dieser Wert ist optional. Der Standardwert ist 1.

--maxexecutiontime, --met

Die maximale Ausführungszeit in Sekunden für die Ausführung einer Aufgabe. Dieser Wert ist optional. Der Standardwert ist 0.

--memory, -m

Die Menge an Speicher, die für eine Task festgelegt wird. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional. Der Standardwert ist 2G.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME: [SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--name, -n

Der Name des Fleets. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird zur Authentifizierung bei einer privaten Registrierung verwendet, um das Container-Image herunterzuladen. Führen Sie ibmcloud ce registry create aus, um einen Registrierungsschlüssel zu erstellen. Dieser Wert ist optional.

--retrylimit, -r

Die Anzahl der Wiederholungen einer Aufgabe, bevor sie als fehlgeschlagen markiert wird. Dieser Wert ist optional. Der Standardwert ist 3.

--subnetpool-id, --spi

Die ID des Subnetzpools, der für die Netzwerkplatzierung der Flotte verwendet werden soll. Dieser Wert ist optional.

--subnetpool-name, --spn

Der Name des Subnetzpools, der für die Netzwerkplatzierung der Flotte verwendet werden soll. Dieser Wert ist optional.

--task-indexes, --ti

Geben Sie die zu bearbeitenden Task-Indizes an, zum Beispiel 0,3,6,9, 1-5,7-8,10. Geben Sie nicht mehr als 1000 Indexeinträge an. Diese Option kann nicht angegeben werden, wenn angegeben --tasks ist. Dieser Wert ist optional.

--tasks, --ts

Geben Sie die Anzahl der Aufgaben an, die von der Flotte bearbeitet werden sollen. Dieser Wert ist optional. Der Standardwert ist 0.

--tasks-from-cos-bucket, --ts-bucket

Geben Sie einen Speicherort für Dateien in einem COS-Eimer an. Für jede Datei sind von der Flotte Aufgaben zu bearbeiten. Dieser Wert ist optional.

--tasks-from-cos-object, --ts-cos

Geben Sie den Speicherort einer JSONL-Datei an, die sich in einem COS-Bucket befindet. Die Datei definiert Aufgaben, die von der Flotte verarbeitet werden sollen. Dieser Wert ist optional.

--tasks-from-local-file, --ts-file

Geben Sie den Speicherort einer lokalen JSONL-Datei an. Die Datei definiert Aufgaben, die von der Flotte verarbeitet werden sollen. Dieser Wert ist optional.

--worker-profile, --profile, --prof

Geben Sie eine Präferenz für das Profil eines unterstützten Mitarbeiters an. Dieser Wert ist optional.

Beispiel

ibmcloud ce fleet create --image icr.io/codeengine/helloworld --tasks-state-store mytaskstore --tasks 1

Beispielausgabe

Successfully created fleet with name 'fleet-0123456789' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
Run 'ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of provisioned workers.
Run 'ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of tasks.
OK

Befehlsoptionen

--id, --fid, --fleet-id

Erforderlich. Die ID der serverlosen Flotte. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Löschen Sie die serverlose Flotte und warten Sie, bis die Flotte gelöscht wurde. Dieser Wert ist optional. Der Standardwert ist false.

--wait-timeout, --wto

Die Zeit in Sekunden, die gewartet werden soll, bis die serverlose Flotte gelöscht wird. Dieser Wert ist optional. Der Standardwert ist 180.

Beispiel

ibmcloud ce fleet delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Beispielausgabe

Deleting serverless fleet...
OK

Befehlsoptionen

--id, --fid, --fleet-id

Erforderlich. Die ID der serverlosen Flotte. Dieser Wert ist erforderlich.

--output, -o

Ausgabeformat. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Beispielausgabe

Getting fleet '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'...
OK

Name:            fleet-0123456789  
ID:              1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Status:          running  
Created:         2025-09-26T10:46:02Z  
Project region:  eu-de  
Project name:    myproj  

Tasks status:             
  Pending:     893  
  Running:     12  
  Failed:      0  
  Canceled:    0  
  Successful:  96  
  Total:       1001  

Code:                     
  Container image reference:  icr.io/codeengine/helloworld  

Tasks specification:      
  Task state store:  mytaskstore  
  Indexes:           0-1000  

Resources and scaling:    
  CPU per instance:         1  
  Memory per instance:      2G  
  Max number of instances:  12  
  Max retries per task:     3  

Network placement:        
  Subnet CRN 0:  crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  

Befehlsoptionen

--output, -o

Ausgabeformat. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name, status und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce fleet list

Beispielausgabe

Listing fleets...
OK

Name              ID                                    Status      Tasks finished  Tasks total  Instances  Created  
fleet-a123456789  0a0a0a0a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  successful  300             300          0          2025-09-26T12:11:28Z  
fleet-b123456789  1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  running     778             1001         12         2025-09-26T12:43:11Z  
fleet-c123456789  2a2a2a2a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  canceled    1               1            0          2025-09-26T10:46:02Z  

Befehlsoptionen

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fleet task get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --task-id 2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f

Beispielausgabe

Getting serverless fleet task '2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f'...
OK

ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Task index:    226  
Created:       2025-09-26T12:45:58Z  
Finished:      2025-09-26T12:47:03Z  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  

State information:    
  Status:       successful  
  Retries:      0  
  Worker name:  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1

Beispiel

ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Beispielausgabe

Listing serverless fleet tasks...
OK

Task index  ID                                    Status   Result code  Worker name  
0           5b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  successful  0            fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0
1           4b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running                  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1
2           3b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  pending
3           2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running                  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1
4           1b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  successful  0            fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0

Befehlsoptionen

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fleet worker delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --worker-name fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42

Beispielausgabe

Deleting serverless fleet worker...
OK

Beispiel

ibmcloud ce fleet worker get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --worker-name fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42

Beispielausgabe

Getting serverless fleet worker...
OK

Name:          fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42  
ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Created:       2025-09-26T20:05:33Z  
Status:        running  
Version:       v1.0.15  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  

Network placement:      
  IP address:    10.242.0.42  
  Network zone:  eu-de-1  
  Subnet CRN:    crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  

Profile information:    
  Profile:       cx2-2x4  
  vCPUs:         2  
  Memory (GiB):  4  

Beispiel

ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Beispielausgabe

Listing serverless fleet workers...
OK

Name                                          ID                                    Status        Profile   IP           Zone     Version  
fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0  2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running       cx2-2x4   10.242.0.42  eu-de-1  v1.0.15
fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1  3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  initializing  cx2-8x16  10.242.0.43  eu-de-1  v1.0.15

Befehlsoptionen

--name, -n

Der Name der zu bindenden Funktion. Dieser Wert ist erforderlich.

--no-wait, --nw

Bindet die Serviceinstanz und wartet nicht, bis die Servicebindung bereit ist. Wenn Sie die Option no-wait angeben, wird die Erstellung der Servicebindung gestartet und der Befehl wird beendet, ohne dass der Abschluss der Erstellung abgewartet wird. Verwenden Sie den function get Befehl, um den Status der Funktionsbindung zu überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--prefix, -p

Ein Präfix für Umgebungsvariablen, die für diese Servicebindung erstellt werden. Darf nur Großbuchstaben, Zahlen und Unterstreichungszeichen (_) enthalten und darf nicht mit einer Zahl beginnen. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--role, -r

Der Name einer Servicerolle für den neuen Serviceberechtigungsnachweis, der für die Servicebindung erstellt wird. Gültige Werte sind Reader, Writer, Manager oder eine servicespezifische Rolle. Die Option nimmt standardmäßig die Rolle Manager an bzw. die erste vom Service bereitgestellte Rolle, wenn Manager nicht unterstützt wird. Diese Option wird ignoriert, wenn die Option --service-credential angegeben ist. Dieser Wert ist optional.

--service-credential, --sc

Der Name eines vorhandenen Serviceberechtigungsnachweises, der für die Servicebindung verwendet werden soll. Wenn Sie keinen Berechtigungsnachweis für die Serviceinstanz angeben, werden während der Bindeaktion neue Berechtigungsnachweise generiert. Dieser Wert ist optional.

--service-instance, --si

Der Name einer vorhandenen IBM Cloud Dienstinstanz, die mit der Funktion verknüpft werden soll. Dieser Wert ist optional.

--service-instance-id, --siid

Die GUID einer vorhandenen IBM Cloud Dienstinstanz, die mit der Funktion verknüpft werden soll. Dieser Wert ist optional.

--wait, -w

Bindet die Serviceinstanz und wartet, bis die Servicebindung bereit ist. Wenn Sie die --wait Option angeben, wartet die Funktion bind maximal so lange in Sekunden, wie in der --wait-timeout Option festgelegt, bis die Funktion bind erfolgreich abgeschlossen wurde. Wenn die Funktion bind nicht erfolgreich abgeschlossen wird oder innerhalb des angegebenen --wait-timeout Zeitraums fehlschlägt, schlägt der Befehl fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum, der abgewartet werden soll, bis die Servicebindung bereit ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 300.

Beispiel

ibmcloud ce fn bind --name myfunction --service-instance my-object-storage

Beispielausgabe

Binding service instance...
Status: Done
OK

Befehlsoptionen

-n, --name

Der Name der Funktion. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem Kleinbuchstaben beginnen.
• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung enden.
• Der Name darf aus maximal 63 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist erforderlich.

--runtime, -r

Die für die Funktion zu verwendende Laufzeit Führen Sie ibmcloud ce function runtimes aus, um unterstützte Laufzeiten für diese Region zu suchen. Siehe Laufzeiten. Dieser Wert ist erforderlich.

--build-commit, --commit, --bcm, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Dieser Wert ist optional.

--build-context-dir, --context-dir, --bcdr, --cdr

Das Verzeichnis im Repository, das den Quellcode für Ihre Funktion enthält. Dieser Wert ist optional.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository mit dem Quellcode zum Erstellen Ihres Code-Bundle-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf die URL eines Git-Repositorys gesetzt ist. Dieser Wert ist optional.

--build-source, --source, --bsrc, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Dieser Wert ist optional.

--build-timeout, --bto

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Dieser Wert ist optional. Der Standardwert ist 600.

--code-bundle, --cb

Der Name des code-bundle-Image, das für diese Funktion verwendet wird. Wenn angegeben build-source ist, ist dieser Wert der Pfad zum Ausgabebild, das durch den Build-Push generiert wurde. Wenn nicht angegeben build-source ist, ist dieser Wert der Pfad zum vorhandenen Code-Bundle-Image. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei ist TAG optional. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

--code-bundle-secret, --cs, --cbs

Der Name des geheimen Registry-Schlüssels, der für die Authentifizierung bei einer privaten Registry verwendet wird. Sie können den Registrierungsschlüssel hinzufügen, indem Sie den registry create Befehl ausführen. Dieser Wert ist optional.

--cpu

Die für die Instanz der Funktion festgelegte CPU-Menge. Gültige Werte finden Sie unter Unterstützte Speicher- und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 1.

--env, -e

Legen Sie Umgebungsvariablen in der Funktion fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: --env envA=A --env envB=B. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden.

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden.

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Dieser Wert ist optional. Der Standardwert ist false.

--inline-code

Geben Sie den Pfad zu einer Datei an, die den Quellcode für Ihre Funktion enthält. Der Code wird inline mit der Funktion gespeichert. Dieser Wert ist optional.

--main, --fn-main

Geben Sie den Namen Ihrer Hauptfunktion im bereitgestellten Quellcode an. Diese Option ist erforderlich, wenn der Name nicht main lautet. Dieser Wert ist optional. Der Standardwert ist main.

--maxexecutiontime, --met

Die maximale Zeit in Sekunden, die diese Funktion zum Abschließen ihrer Ausführung benötigt. Dieser Wert ist optional. Der Standardwert ist 60.

--memory, -m

Die für die Funktion festgelegte Speichergröße. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 4G.

--no-wait, --nw

Warten Sie nicht, bis die Ausführung des Builds abgeschlossen worden ist. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--scale-down-delay, --sdd

Die Zeit in Sekunden, die eine Instanz nach Abschluss eines Aufrufs aktiv ist. Diese Option kann die Kaltstartzeiten reduzieren. Weitere Informationen finden Sie unter Kann ich meine Funktionsinstanz länger am Leben halten?. Dieser Wert ist optional. Der Standardwert ist 1.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens für die Ausführung der Funktion. Dieser Wert ist optional. Der Standardwert ist false.

--visibility, -v

Die Sichtbarkeit für die Funktion Gültige Werte sind public, private, und project. Die Sichtbarkeit kann nur gegeben sein, private wenn das Projekt die private Sichtbarkeit der Funktion unterstützt. Dieser Wert ist optional. Der Standardwert ist public.

--wait, -w

Warten Sie bis zur vollständigen Beendigung der Buildausführung. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Die Wartezeit in Sekunden, bis die Funktion bereit ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce fn create --name myfunction --build-source main.js --runtime nodejs

Beispielausgabe

Preparing function 'myfunction' for build push...
Creating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'private.stg.icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK                                                
Run 'ibmcloud ce function get -n myfunction' to see more details.

https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud

Wenn Sie ausführen, um den ibmcloud ce fn get -n 'myfunction' Funktionsstatus zu überprüfen, wird die URL für Ihre Funktion angezeigt.

Befehlsoptionen

--name, -n

Der Name der Funktion. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fn delete --name myfunction

Beispielausgabe

Are you sure you want to delete function 'myfunction'? [y/N]> y
Deleting function 'myfunction'...
OK

Befehlsoptionen

--name, -n

Der Name der Funktion. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--save, -s

Speichern Sie den Quellcode der Funktion im lokalen Dateisystem. Diese Option wird nur für Funktionen unterstützt, die mit Inline-Code erstellt wurden. Dieser Wert ist optional.

Beispiel

ibmcloud ce fn get --name myfunction

Beispielausgabe

Getting function 'myfunction'...
OK

Name:          myfunction  
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           6m8s  
Created:       2023-06-22T19:59:51Z
URL:           https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud  
Status:        Ready  

Resources:    
  CPU:                 0.25  
  Memory:              500M  
  Max Execution Time:  60 seconds  

Build Information:    
  Build Run Name:     myfunction-run-111111-12345678
  Build Type:         local  
  Build Strategy:     codebundle-nodejs-20  
  Timeout:            600  
  Source:             main.js  

  Build Run Summary:  Succeeded  
  Build Run Status:   Succeeded  
  Build Run Reason:   All Steps have completed executing  
  Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' for details.  

Function Code:    
  Runtime:        nodejs-20 (managed)  
  Bundle Secret:  ce-auto-icr-private-us-south  
  Code Bundle:    cr://icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla
  Main:           main()

Befehlsoptionen

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce fn delete --name myfunction

Beispielausgabe

Name           Status     URL                                                                    CPU   Memory  Age  
hellofunction  Ready      https://hellofunction.4svg40kna19.us-south.codeengine.appdomain.cloud  0.25  500M    25h  
myfunction     Ready      https://myfun1.4svg40kna19.us-south.codeengine.appdomain.cloud         0.25  1G      8d   
helloworld     Ready      https://myfunction1.4svg40kna19.us-south.codeengine.appdomain.cloud    0.25  1G      16d  
myfunction1    Ready      https://myfunction111.4svg40kna19.us-south.codeengine.appdomain.cloud  0.25  500M    25h  
myfunction3    Ready      https://myfunction41.4svg40kna19.us-south.codeengine.appdomain.cloud   0.25  500M    25h  

Befehlsoptionen

--all, -A

Zeigt alle Laufzeiten an, einschließlich veralteter Laufzeiten. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fn runtimes

Beispielausgabe

Name         ID           Family  Default  
Python 3.11  python-3.11  python  true  
Node.js 20   nodejs-20    nodejs  true  
Node.js 22   nodejs-22    nodejs  false  
Python 3.13  python-3.13  python  false  

Befehlsoptionen

--name, -n

Der Name der Funktion, deren Bindung aufgehoben werden soll. Dieser Wert ist erforderlich.

--all, -A

Hebt die Bindung aller Serviceinstanzen für diese Funktion auf. Dieser Wert ist erforderlich, wenn --binding nicht angegeben ist. Der Standardwert ist false.

--binding, -b

Der Name der Bindung, die aufgehoben werden soll. Führen Sie den Befehl ibmcloud ce function get -n FUNCTION_NAME aus, um die Bindungsnamen anzuzeigen. Dieser Wert ist erforderlich, wenn --all nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce fn unbind --name myfunction --all

Beispielausgabe

Removing bindings from 'myfunction'...
OK

Befehlsoptionen

--name, -n

Erforderlich. Der Name der Funktion. Dieser Wert ist erforderlich.

--build-clear, --bc

Zuordnung eines Builds zu dieser Funktion entfernen. Die Option „Build löschen“ ist nur verfügbar, wenn Ihre Funktion derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--build-commit, --commit, --bcm, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Dieser Wert ist optional.

--build-commit-clear, --commit-clear, --bcmc, --cmc

Löschen Sie das Commit, den Tag oder die Verzweigung im Quellenrepository, um eine Pull-Operation durchzuführen. Die Option 'commit clear' ist nur zulässig, wenn Ihrer Funktion momentan ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist false.

--build-context-dir, --context-dir, --bcdr, --cdr

Das Verzeichnis im Repository, das den Quellcode für Ihre Funktion enthält. Diese Option ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Der Name des SSH-Geheimnisses, das die Anmeldedaten für den Zugriff auf das private Repository enthält, in dem sich der Quellcode zum Erstellen Ihres Images befindet. Dieser Wert ist optional.

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Löschen Sie den geheimen SSH-Schlüssel. Diese Option ist nur zulässig, wenn Ihrer Funktion derzeit ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist false.

--build-source, --source, --bsrc, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Dieser Wert ist optional.

--build-timeout, --bto

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Dieser Wert ist optional. Der Standardwert ist 600.

--code-bundle, --cb

Der Name des code-bundle-Image, das für diese Funktion verwendet wird. Wenn angegeben build-source ist, ist dieser Wert der Pfad zum Ausgabebild, das durch den Build-Push generiert wurde. Wenn nicht angegeben build-source ist, ist dieser Wert der Pfad zum vorhandenen Code-Bundle-Image. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei ist TAG optional. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

--code-bundle-secret, --cs, --cbs

Der Name des geheimen Registry-Schlüssels, der für die Authentifizierung bei einer privaten Registry verwendet wird. Sie können den Registrierungsschlüssel hinzufügen, indem Sie den registry create Befehl ausführen. Dieser Wert ist optional.

--cpu

Die für die Instanz der Funktion festgelegte CPU-Menge. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 1.

--env, -e

Legen Sie Umgebungsvariablen in der Funktion fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: --env envA=A --env envB=B. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-from-configmap-rm, --env-cm-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige Konfigurationszuordnungen mithilfe des Konfigurationszuordnungsnamens. Wenn Sie einzelne Schlüsselverweise auf Konfigurationszuordnungen entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--env-from-secret-rm, --env-sec-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige geheime Schlüssel mithilfe des Namens des geheimen Schlüssels. Wenn Sie einzelne Schlüsselverweise auf geheime Schlüssel entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-rm

Entfernt Verweise von Umgebungsvariablen auf den Schlüssel eines Schlüssel/Wert-Paars in einer Konfigurationszuordnung oder in einem geheimen Schlüssel. Wenn Sie einzelne Schlüsselverweise und Literalwerte entfernen möchten, geben Sie den Namen des Schlüssels an. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit den Optionen --env-from-configmap oder --mount-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit den Optionen --env-from-secret, --mount-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--inline-code

Geben Sie den Pfad zu einer Datei an, die den Quellcode für Ihre Funktion enthält. Der Code wird inline mit der Funktion gespeichert. Dieser Wert ist optional.

--main, --fn-main

Geben Sie den Namen Ihrer Hauptfunktion im bereitgestellten Quellcode an. Diese Option ist erforderlich, wenn der Name nicht main lautet. Dieser Wert ist optional. Der Standardwert ist main.

--maxexecutiontime, --met

Die maximale Ausführungszeit in Sekunden, die diese Funktion für ihre Ausführung benötigt. Dieser Wert ist optional. Der Standardwert ist 60.

--memory, -m

Die für die Funktion festgelegte Speichergröße. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 4G.

--no-wait, --nw

Übergibt die Buildausführung und wartet nicht darauf, dass diese Buildausführung abgeschlossen wird. Wenn Sie die Option --no-wait angeben, wird die Übergabe der Buildausführung ohne Warten gestartet. Den Status der Buildausführung können Sie mit dem Befehl buildrun get überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--rebuild

Das Image aus der Quelle neu erstellen. Die Option „Neu erstellen“ ist nur verfügbar, wenn Ihre Funktion derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--runtime, -r

Die für die Funktion zu verwendende Laufzeit Führen Sie ibmcloud ce function runtimes aus, um unterstützte Laufzeiten für diese Region zu suchen. Siehe Laufzeiten. Dieser Wert ist optional.

--scale-down-delay, --sdd

Die Zeit in Sekunden, die eine Instanz nach Abschluss eines Aufrufs aktiv ist. Diese Option kann die Kaltstartzeiten reduzieren. Weitere Informationen finden Sie unter Kann ich meine Funktionsinstanz länger am Leben halten?. Dieser Wert ist optional. Der Standardwert ist 1.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens für die Ausführung der Funktion. Dieser Wert ist optional. Der Standardwert ist false.

--visibility, -v

Die Sichtbarkeit für die Funktion Gültige Werte sind public, private, und project. Die Sichtbarkeit kann nur gegeben sein, private wenn das Projekt die private Sichtbarkeit der Funktion unterstützt. Dieser Wert ist optional.

--wait, -w

Warten Sie bis zur vollständigen Beendigung der Buildausführung. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Die Wartezeit in Sekunden, bis die Funktion bereit ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce fn update --name myfunction --runtime nodejs-20 --build-source main.js

Beispielausgabe

Preparing function 'myfunction' for build push...
Updating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK                                                
Run 'ibmcloud ce function get -n myfunction' to see more details.

https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud

Wenn Sie ibmcloud ce fn get -n 'myfunction' ausführen, um den Funktionsstatus zu überprüfen, wird die URL für Ihre Funktion angezeigt.

Beispiel

ibmcloud ce help

Beispielausgabe

NAME:
  code-engine, ce - Manage Code Engine components

USAGE:
  ibmcloud ce command [arguments...] [options...]

COMMANDS:
  application, app     Manage applications.
  binding              Manage bindings.
  build, bd, b         Manage configurations for generating images from source code.
  buildrun, br         Generate images from a build.
  configmap, cm        Manage configmaps.
  domainmapping, dm    Manage domain mappings.
  experimental, exp    Experimental Code Engine commands
  function, fn         Manage functions.
  help, h              Show help.
  job                  Manage jobs to configure tasks.
  jobrun, jr           Manage instances of a job.
  connectivity, conn   Manage connectivity commands
  project, proj        Manage Code Engine projects.
  reclamation, recl    Manage Code Engine project reclamations.
  registry             Manage image registry access secrets.
  repo                 Manage Git repository access secrets.
  revision, rev        Manage application revisions.
  secret               Manage secrets.
  serviceaccess        Manage service access secrets.
  subscription, sub    Manage event subscriptions.
  version, v           Display the 'code-engine' command-line interface version.

Enter 'ibmcloud ce help command' for more information about a command.

Befehlsoptionen

--name, -n

Der Name des zu bindenden Jobs. Dieser Wert ist erforderlich.

--no-wait, --nw

Bindet die Serviceinstanz und wartet nicht, bis die Servicebindung bereit ist. Wenn Sie die Option --no-wait angeben, wird die Erstellung der Servicebindung gestartet und der Befehl wird beendet, ohne dass der Abschluss der Erstellung abgewartet wird. Den Bindungsstatus des Jobs können Sie mit dem Befehl job get überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--prefix, -p

Ein Präfix für Umgebungsvariablen, die für diese Servicebindung erstellt werden. Darf nur Großbuchstaben, Zahlen und Unterstreichungszeichen (_) enthalten und darf nicht mit einer Zahl beginnen. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--role, -r

Der Name einer Servicerolle für den neuen Serviceberechtigungsnachweis, der für die Servicebindung erstellt wird. Gültige Werte sind Reader, Writer, Manager oder eine servicespezifische Rolle. Die Option nimmt standardmäßig die Rolle Manager an bzw. die erste vom Service bereitgestellte Rolle, wenn Manager nicht unterstützt wird. Diese Option wird ignoriert, wenn die Option --service-credential angegeben ist. Dieser Wert ist optional.

--service-credential, --sc

Der Name eines vorhandenen Serviceberechtigungsnachweises, der für die Servicebindung verwendet werden soll. Wenn Sie keinen Berechtigungsnachweis für die Serviceinstanz angeben, werden während der Bindeaktion neue Berechtigungsnachweise generiert. Dieser Wert ist optional.

--service-instance, --si

Der Name einer vorhandenen IBM Cloud-Serviceinstanz, die an den Job gebunden werden soll. Dieser Wert ist optional.

--service-instance-id, --siid

Die GUID einer vorhandenen IBM Cloud-Serviceinstanz, die an den Job gebunden werden soll Dieser Wert ist optional.

--wait, -w

Bindet die Serviceinstanz und wartet, bis die Servicebindung bereit ist. Wenn Sie die Option --wait angeben, wartet der Befehl für die Jobbindung darauf, dass die Jobbindung erfolgreich ausgeführt wird; die maximale Wartezeit hierfür wird in Sekunden durch die Option --wait-timeout angegeben. Falls die Jobbindung innerhalb des durch --wait-timeout angegebenen Zeitraums nicht erfolgreich ausgeführt wird oder fehlschlägt, schlägt der Befehl fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum, der abgewartet werden soll, bis die Servicebindung bereit ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 300.

Beispiel

Im folgenden Beispiel wird die Serviceinstanz my-object-storage an die Anwendung hello gebunden.

ibmcloud ce job bind --name hello --service-instance my-object-storage

Beispielausgabe

Binding service instance...
Waiting for service binding to become ready...
Status: Pending (Processing Resource)
Status: Pending (Processing Resource)
Status: Creating service binding
Status: Creating service binding
Status: Ready
OK

Befehlsoptionen

-n, --name

Der Name des Jobs. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 63 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist erforderlich.

--argument, --arg, -a

Legt die Argumente für die Ausführungen des Jobs fest. Geben Sie für jede Option des Typs --argument ein Argument an; Beispiel: -a argA -a argB. Dieser Wert ist optional.

--array-indices, --ai

Gibt die Arrayindizes an, die für die Ausführung des Jobs verwendet werden. Geben Sie die Liste oder den Bereich der Indizes durch Bindestriche (-) oder Kommas (,) getrennt an. Beispiel: 0,3,6,9 oder 1-5,7-8,10. Das Maximum ist 999999. Diese Option kann nur angegeben werden, wenn die --array-size Option nicht angegeben ist. Dieser Wert ist optional. Der Standardwert ist 0.

--array-size, --as, --instances, --is

Gibt die Anzahl der Instanzen an, die für die Ausführung des Jobs verwendet werden. Wenn Sie diese Option verwenden, konvertiert das System in Array-Indizes. Wenn Sie zum Beispiel instances von 5 angeben, konvertiert das System in array-indices von 0 - 4. Diese Option kann nur angegeben werden, wenn die Option --array-indices nicht angegeben ist. Dieser Wert ist optional. Der Standardwert ist 1.

--build-commit, --commit, --bcm, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Die Option "build commit" ist nur zulässig, wenn die Option " --build-source " auf die E-Mail-Adresse " URL " eines " Git "-Repositorys gesetzt ist. Dieser Wert ist optional.

--build-context-dir, --context-dir, --bcdr, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Die Option für das Buildkontextverzeichnis ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional.

--build-dockerfile, --dockerfile, --bdf, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Die Option für die Build-Docker-Datei ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf die URL eines Git-Repositorys gesetzt ist. Dieser Wert ist optional.

--build-size, --size, --bsz, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Die Option für die Buildgröße ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist medium.

--build-source, --source, --bsrc, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Dieser Wert ist optional.

--build-strategy, --strategy, --bstr, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Gültige Werte sind dockerfile und buildpacks. Die Option für die Buildstrategie ist nur zulässig, wenn die Option --build-source festgelegt ist. Wenn nicht angegeben, wird die Build-Strategie dadurch bestimmt Code Engine, ob angegeben --build-source ist und sich die Quelle auf Ihrem lokalen Rechner befindet. Dieser Wert ist optional. Der Standardwert ist dockerfile.

--build-timeout, --bto

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Die Option für das Buildzeitlimit ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist 600.

--command, --cmd, -c

Legt die Befehle für die Ausführungen des Jobs fest. Geben Sie für jede Option des Typs --command einen Befehl an; Beispiel: --cmd cmdA --cmd cmdB. Dieser Wert überschreibt den Standardbefehl, der im Container-Image angegeben ist. Dieser Wert ist optional.

--cpu

Die CPU-Kapazität, die für die Ausführungen des Jobs festgelegt wurde. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 1.

--env, -e

Legt die Umgebungsvariablen für die Ausführungen des Jobs fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: --env envA=A --env envB=B. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--ephemeral-storage, --es

Die Kapazität des ephemeren Speichers, die für die Ausführungen des Jobs festgelegt wurde. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional. Der Standardwert ist 400M.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit der Option --env-from-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit den Optionen --env-from-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--image, -i

Der Name des Images, das für Ausführungen dieses Jobs wird. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei sind REGISTRY und TAG optional. Wird REGISTRY nicht angegeben, ist docker.io der Standardwert. Wird TAG nicht angegeben, ist latest der Standardwert. Die Imageoption ist erforderlich, wenn die Option --build-source nicht angegeben ist. Dieser Wert ist optional.

--maxexecutiontime, --met

Die maximale Ausführungszeit in Sekunden, die für Ausführungen des Jobs festgelegt wurde. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 7200.

--memory, -m

Die Kapazität des Hauptspeichers, die für Ausführungen des Jobs festgelegt wurde. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 4G.

--mode

Der Modus für Ausführungen des Jobs. Gültige Werte sind task und daemon. Im task Modus gelten die Optionen maxexecutiontime retrylimit und. Im daemon Modus sind die Optionen --maxexecutiontime --retrylimit und nicht zulässig, da es keine Zeitüberschreitung gibt und fehlgeschlagene Instanzen unbegrenzt neu gestartet werden. Dieser Wert ist optional. Der Standardwert ist task.

--mount-configmap, --mount-cm

Fügen Sie den Inhalt einer Konfigurationszuordnung zum Dateisystem der Ausführungen des Jobs hinzu, indem Sie ein Mountverzeichnis und den Namen einer Konfigurationszuordnung im Format MOUNT_DIRECTORY=CONFIGMAP_NAME angeben. Jede angehängte Konfigurationszuordnung muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in der Konfigurationszuordnung wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-configmap an; Beispiel: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Dieser Wert ist optional.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--mount-secret, --mount-sec

Fügen Sie den Inhalt eines geheimen Schlüssels zum Dateisystem der Ausführungen des Jobs hinzu, indem Sie ein Mountverzeichnis und den Namen eines geheimen Schlüssels im Format MOUNT_DIRECTORY=SECRET_NAME angeben. Jeder angehängte geheime Schlüssel muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in dem geheimen Schlüssel wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-secret an; Beispiel: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Dieser Wert ist optional.

--no-wait, --nw

Warten Sie nicht, bis die Ausführung des Builds abgeschlossen worden ist. Wenn Sie die Option --no-wait angeben, beginnt die Build-Ausführung ohne Wartezeit. Den Status der Buildausführung können Sie mit dem Befehl buildrun get überprüfen. Die Option 'no-wait' ist nur zulässig, wenn die Option --build-source festgelegt ist. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Dieser Wert ist optional.

--retrylimit, -r

Gibt an, wie oft eine Instanz des Jobs erneut ausgeführt werden soll, bevor der Job als fehlgeschlagen markiert wird. Ein Arrayindex eines Jobs wird bei einem anderen Beendigungscode als null erneut ausgeführt. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 3.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens für die Ausführung des Jobs. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Warten Sie bis zur vollständigen Beendigung der Buildausführung. Wenn Sie die Option --wait angeben, wartet die Buildausführung eine maximale Zeit in Sekunden, die durch die Option --wait-timeout festgelegt wird, bis die Build-Ausführung abgeschlossen ist. Wenn die Build-Ausführung nicht innerhalb des angegebenen Zeitraums --wait-timeout abgeschlossen wird, schlägt die Build-Ausführung fehl. Die Option 'wait' ist nur zulässig, wenn die Option --build-source definiert ist. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Die Zeitspanne in Sekunden, die auf die vollständige Beendigung der Buildausführung gewartet wird. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Die Option wait-timeout ist nur zulässig, wenn die Option --build-source definiert ist. Der Standardwert ist 600.

Beispiel

Im folgenden Beispiel wird das Container-Image icr.io/codeengine/firstjob verwendet und dem Container 2G MB als Hauptspeicher und 1 CPU zugeordnet. Weitere Informationen zum Auswählen von gültigen Werten für Speicher und CPU finden Sie im Abschnitt Unterstützte Speicher- und CPU-Kombinationen.

ibmcloud ce job create --image icr.io/codeengine/firstjob --name hellojob --memory 2G --cpu 1

Beispielausgabe

Creating job 'hellojob'...
OK

Befehlsoptionen

--name, -n

Der Name des Jobs. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--orphan-job-runs, -o

Gibt an, dass alle Jobausführungen, die dieser Jobkonfiguration zugeordnet sind, beibehalten werden sollen. Diese verwaisten Jobausführungen müssen danach separat gelöscht werden. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce job delete --name hello

Beispielausgabe

Are you sure you want to delete job hello? [y/N]> y
Deleting job 'hello'...
OK

Wenn Sie den ibmcloud ce job delete Befehl zum Löschen eines Auftrags ausführen, werden auch alle übermittelten Auftragsausführungen gelöscht, die auf diesen Auftrag verweisen.

Befehlsoptionen

--name, -n

Der Name des Jobs. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce job get --name hellojob

Beispielausgabe

Getting job 'hellojob'...
OK

Name:          hellojob
ID:            abcdabcd-abcd-abcd-abcd-abcdabcd1111
Project Name:  myproj
Project ID:    01234567-abcd-abcd-abcd-abcdabcd2222
Age:           59s
Created:       2021-03-01T15:33:30-05:00

Last Job Run:
  Name:     hellojob-jobrun-abcde
  Age:      32d
  Created:  2021-06-06T13:52:42-04:00

Image:                icr.io/codeengine/firstjob
Resource Allocation:
    CPU:     1
    Memory:  4G

Runtime:
    Mode:                  task
    Array Indices:         0
    Array Size:            1
    Max Execution Time:    7200
    Retry Limit:           3

Befehlsoptionen

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce job list

Beispielausgabe

Name           Age   Last Job Run Name      Last Job Run Age
demo           110d  demo-jobrun-hkkmx      108d
myjob-envvar   107d
hellojob       7s
myjob          60d   myjob-977v7            58d
testjob        88d   testjob-jobrun-kzxlp   72d

Befehlsoptionen

--name, -n

Der Name des Jobs, dessen Bindung aufgehoben werden soll. Dieser Wert ist erforderlich.

--all, -A

Hebt die Bindung aller Serviceinstanzen an diesen Job auf. Dieser Wert ist erforderlich, wenn --binding nicht angegeben ist. Der Standardwert ist false.

--binding, -b

Der Name der Bindung, die aufgehoben werden soll. Führen Sie den Befehl ibmcloud ce job get -n JOB_NAME aus, um die Bindungsnamen anzuzeigen. Dieser Wert ist erforderlich, wenn --all nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel werden alle Bindungen des Jobs hello entfernt.

ibmcloud ce job unbind --name hello --all

Beispielausgabe

Removing service bindings...
OK

Befehlsoptionen

--name, -n

Der Name des Jobs. Dieser Wert ist erforderlich.

--argument, --arg, -a

Legt die Argumente für die Ausführungen des Jobs fest. Geben Sie für jede Option des Typs --argument ein Argument an; Beispiel: -a argA -a argB. Dieser Wert ist optional.

--arguments-clear, --ac

Jobargumente löschen. Dieser Wert ist optional. Der Standardwert ist false.

--array-indices, --ai

Gibt die Arrayindizes an, die für die Ausführung des Jobs verwendet werden. Geben Sie die Liste oder den Bereich der Indizes durch Bindestriche (-) oder Kommas (,) getrennt an. Beispiel: 0,3,6,9 oder 1-5,7-8,10. Das Maximum ist 999999. Diese Option kann nur angegeben werden, wenn die --array-size Option nicht angegeben ist. Dieser Wert ist optional.

--array-size, --as, --instances, --is

Gibt die Anzahl der Instanzen an, die für die Ausführung des Jobs verwendet werden. Wenn Sie diese Option verwenden, konvertiert das System in Array-Indizes. Wenn Sie zum Beispiel instances von 5 angeben, konvertiert das System in array-indices von 0 - 4. Diese Option kann nur angegeben werden, wenn die Option --array-indices nicht angegeben ist. Dieser Wert ist optional. Der Standardwert ist 0.

--build-clear, --bc

Zuordnung eines Builds zu diesem Job aufheben. Die Option „Build löschen“ ist nur verfügbar, wenn Ihr Job derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--build-commit, --commit, --bcm, --cm, --revision

Festschreibung, Tag oder Verzweigung im Quellenrepository, aus dem die Extraktion durch die Pull-Operation durchgeführt werden soll. Die Option „Build Commit“ ist nur zulässig, wenn die --build-source Option auf eines Git URL Repositorys in diesem job update Befehl gesetzt ist oder Ihr Job derzeit über einen zugehörigen Build aus einer Git Repository-Quelle verfügt. Dieser Wert ist optional.

--build-commit-clear, --commit-clear, --bcmc, --cmc

Löschen Sie das Commit, den Tag oder die Verzweigung im Quellenrepository, um eine Pull-Operation durchzuführen. Die Option „commit clear“ ist nur zulässig, wenn Ihr Job derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--build-context-dir, --context-dir, --bcdr, --cdr

Das Verzeichnis in dem Repository, in dem die Datei mit den Buildpacks oder die Dockerfile enthalten ist. Die Option „Build-Kontextverzeichnis“ ist nur zulässig, wenn die --build-source Option in diesem job update Befehl festgelegt ist oder Ihrem Auftrag derzeit ein Build zugeordnet ist. Dieser Wert ist optional.

--build-dockerfile, --dockerfile, --bdf, --df

Der Pfad zur Dockerfile. Geben Sie diese Option nur an, wenn der Name nicht Dockerfile ist. Die Build-Dockerfile-Option ist zulässig, wenn die Option --build-source in diesem job update-Befehl festgelegt ist oder wenn Ihrem Job aktuell ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Der Name des geheimen SSH-Schlüssels, der die Berechtigungsnachweise für den Zugriff auf das private Repository enthält, das den Quellcode zum Erstellen Ihres Container-Image enthält. Verwenden Sie zum Erstellen dieses geheimen SSH-Schlüssels den Befehl secret create --format SSH. Ein geheimer SSH-Schlüssel wird auch als geheimer Repositoryzugriffsschlüssel für Git verwendet. Diese Option ist nur zulässig, wenn die --build-source Option auf das GitURL Repository dieses job update Befehls gesetzt ist oder Ihr Job derzeit über einen zugehörigen Build aus einer Git Repository-Quelle verfügt. Dieser Wert ist optional.

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Löschen Sie den geheimen SSH-Schlüssel. Diese Option ist zulässig, wenn Ihr Job derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--build-size, --size, --bsz, --sz

Die Größe für den Build; mit diesem Wert wird die Menge der verwendeten Ressourcen festgelegt. Gültige Werte sind small, medium, large, xlarge und xxlarge. Einzelheiten finden Sie unter Bestimmen der Größe des Builds. Die Option „Build-Größe“ ist nur zulässig, wenn die --build-source Option in diesem job update Befehl festgelegt ist oder Ihrem Auftrag derzeit ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist medium.

--build-source, --source, --bsrc, --src

Die URL des Git-Repositorys oder der Pfad zu der lokalen Quelle, die Ihren Quellcode enthält, z. B. https://github.com/IBM/CodeEngine oder .. Dieser Wert ist optional.

--build-strategy, --strategy, --bstr, --str

Die Strategie, die für die Erstellung des Images verwendet werden soll. Gültige Werte sind dockerfile und buildpacks. Die Option „Build-Strategie“ ist nur zulässig, wenn die --build-source Option in diesem job update Befehl festgelegt ist oder Ihrem Auftrag derzeit ein Build zugeordnet ist. Wenn keine Angabe erfolgt, wird die Erstellungsstrategie von Code Engine bestimmt, wenn --build-source angegeben ist und sich die Quelle auf Ihrer lokalen Workstation befindet. Dieser Wert ist optional. Der Standardwert ist dockerfile.

--build-timeout, --bto

Die Zeit in Sekunden, die verstreichen kann, damit die Erstellung erfolgreich ausgeführt wird; nach Ablauf dieses Zeitraums schlägt die Anwendung fehl. Die Option „Build-Timeout“ ist nur zulässig, wenn die --build-source Option in diesem job update Befehl festgelegt ist oder Ihrem Auftrag derzeit ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist 600.

--command, --cmd, -c

Legt die Befehle für die Ausführungen des Jobs fest. Geben Sie für jede Option des Typs --command einen Befehl an; Beispiel: --cmd cmdA --cmd cmdB. Dieser Wert überschreibt den Standardbefehl, der im Container-Image angegeben ist. Dieser Wert ist optional.

--commands-clear, --cc

Jobbefehle löschen. Dieser Wert ist optional. Der Standardwert ist false.

--cpu

Die CPU-Kapazität, die für die Ausführungen des Jobs festgelegt wurde. Von diesem Wert wird jeder Wert von --cpu aktualisiert, der im Job zugeordnet ist. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 0.

--env, -e

Legt die Umgebungsvariablen für die Ausführungen des Jobs fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: --env envA=A --env envB=B. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-from-configmap-rm, --env-cm-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige Konfigurationszuordnungen mithilfe des Konfigurationszuordnungsnamens. Wenn Sie einzelne Schlüsselverweise auf Konfigurationszuordnungen entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--env-from-secret-rm, --env-sec-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige geheime Schlüssel mithilfe des Namens des geheimen Schlüssels. Wenn Sie einzelne Schlüsselverweise auf geheime Schlüssel entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-rm

Entfernt Verweise von Umgebungsvariablen auf den Schlüssel eines Schlüssel/Wert-Paars in einer Konfigurationszuordnung oder in einem geheimen Schlüssel. Wenn Sie einzelne Schlüsselverweise und Literalwerte entfernen möchten, geben Sie den Namen des Schlüssels an. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--ephemeral-storage, --es

Die Kapazität des ephemeren Speichers, die für die Ausführungen des Jobs festgelegt wurde. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit der Option --env-from-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit den Optionen --env-from-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--image, -i

Der Name des Images, das für Ausführungen dieses Jobs wird. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei sind REGISTRY und TAG optional. Wird REGISTRY nicht angegeben, ist docker.io der Standardwert. Wird TAG nicht angegeben, ist latest der Standardwert. Dieser Wert ist optional.

--maxexecutiontime, --met

Die maximale Ausführungszeit in Sekunden, die für Ausführungen des Jobs festgelegt wurde. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 7200.

--memory, -m

Die Kapazität des Hauptspeichers, die für Ausführungen des Jobs festgelegt wurde. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional.

--mode

Der Modus für Ausführungen des Jobs. Gültige Werte sind task und daemon. Im task Modus gelten die Optionen maxexecutiontime retrylimit und. Im daemon Modus sind die Optionen --maxexecutiontime --retrylimit und nicht zulässig, da es keine Zeitüberschreitung gibt und fehlgeschlagene Instanzen unbegrenzt neu gestartet werden. Dieser Wert ist optional.

--mount-configmap, --mount-cm

Fügen Sie den Inhalt einer Konfigurationszuordnung zum Dateisystem der Ausführungen des Jobs hinzu, indem Sie ein Mountverzeichnis und den Namen einer Konfigurationszuordnung im Format MOUNT_DIRECTORY=CONFIGMAP_NAME angeben. Jede angehängte Konfigurationszuordnung muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in der Konfigurationszuordnung wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-configmap an; Beispiel: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Dieser Wert ist optional.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--mount-rm

Entfernen Sie den Inhalt einer Konfigurationszuordnung oder eines geheimen Schlüssels aus dem Dateisystem der Ausführungen des Jobs, indem Sie das Verzeichnis angeben, in dem die Konfigurationszuordnung oder der geheime Schlüssel angehängt ist. Geben Sie ein Mountverzeichnis pro Option des Typs --mount-rm an. Beispiel: --mount-rm /etc/configmap-a --mount-rm /etc/secret-b. Dieser Wert ist optional.

--mount-secret, --mount-sec

Fügen Sie den Inhalt eines geheimen Schlüssels zum Dateisystem der Ausführungen des Jobs hinzu, indem Sie ein Mountverzeichnis und den Namen eines geheimen Schlüssels im Format MOUNT_DIRECTORY=SECRET_NAME angeben. Jeder angehängte geheime Schlüssel muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in dem geheimen Schlüssel wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-secret an; Beispiel: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Dieser Wert ist optional.

--no-wait, --nw

Warten Sie nicht, bis die Ausführung des Builds abgeschlossen worden ist. Wenn Sie die Option --no-wait angeben, beginnt die Build-Ausführung ohne Wartezeit. Den Status der Buildausführung können Sie mit dem Befehl buildrun get überprüfen. Die Option „No-Wait“ ist nur zulässig, wenn die --build-source Option in diesem job update Befehl festgelegt ist oder Ihrem Auftrag derzeit ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--rebuild

Wiederholen Sie die Erstellung des Image aus der Quelle. Die Option „Neu erstellen“ ist zulässig, wenn Ihr Auftrag derzeit über einen zugehörigen Build verfügt. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Dieser Wert ist optional.

--registry-secret-clear, --rsc

Löschen Sie den geheimen Registry-Schlüssel. Dieser Wert ist optional. Der Standardwert ist false.

--retrylimit, -r

Gibt an, wie oft eine Instanz des Jobs erneut ausgeführt werden soll, bevor der Job als fehlgeschlagen markiert wird. Ein Arrayindex eines Jobs wird bei einem anderen Beendigungscode als null erneut ausgeführt. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 3.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--service-account-clear, --sac

Löschen Sie das Dienstkonto. Dieser Wert ist optional. Der Standardwert ist false.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens für die Ausführung des Jobs. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Warten Sie bis zur vollständigen Beendigung der Buildausführung. Wenn Sie die Option --wait angeben, wartet die Buildausführung eine maximale Zeit in Sekunden, die durch die Option --wait-timeout festgelegt wird, bis die Build-Ausführung abgeschlossen ist. Wenn die Build-Ausführung nicht innerhalb des angegebenen Zeitraums --wait-timeout abgeschlossen wird, schlägt die Build-Ausführung fehl. Die Option „Warten“ ist nur zulässig, wenn die --build-source Option in diesem job update Befehl aktiviert ist oder Ihrem Auftrag derzeit ein Build zugeordnet ist. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Die Zeitspanne in Sekunden, die auf die vollständige Beendigung der Buildausführung gewartet wird. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Die Option für das Wartezeitlimit ist zulässig, wenn die Option --build-source in diesem job update-Befehl festgelegt ist oder Ihrem Job aktuell ein Build zugeordnet ist. Der Standardwert ist 600.

Beispiel

ibmcloud ce job update --name hellojob --cpu 2

Beispielausgabe

Updating job 'hellojob'...
OK

Befehlsoptionen

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--job, -j

Verwenden Sie diese Option, um alle Job-Läufe des angegebenen Jobs zu löschen. Die Option --job ist erforderlich, wenn Sie den Wert für --name nicht angeben. Dieser Wert ist optional.

--name, -n

Der Name der Jobausführung, die gelöscht werden soll. Die Option --name ist erforderlich, wenn Sie den Wert für --job nicht angeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce jobrun delete --name myjobrun -f

Beispielausgabe

Deleting job run 'myjobrun'...
OK

Befehlsoptionen

--instance, -i

Der Name einer bestimmten Instanz der Jobausführung. Verwenden Sie den Befehl jobrun get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --jobrun nicht angegeben ist.

--jobrun, -j, --name, -n

Zeigt die Ereignisse aller Instanzen der angegebenen Jobausführung an. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel werden die Systemereignisinformationen für alle Instanzen einer angegebenen Jobausführung angezeigt.

ibmcloud ce jobrun events --jobrun myjobrun

Beispielausgabe

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Getting events for all instances of job run 'myjobrun'...
OK

myjobrun-1-0:
    Type     Reason                  Age  Source                  Messages
    Normal   Scheduled               49s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-1-0 to 10.240.64.136
    [...]
    Normal   Pulling                 34s  kubelet, 10.240.64.136  Pulling image "icr.io/codeengine/testjob"

myjobrun-2-0:
    Type    Reason     Age  Source                  Messages
    Normal  Scheduled  50s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-2-0 to 10.240.64.131
    Normal  Pulling    48s  kubelet, 10.240.64.131  Pulling image "icr.io/codeengine/testjob"

Beispiel für Systemereignisinformationen für eine angegebene Instanz einer Jobausführung

Sie können auch Systemereignisinformationen für eine angegebene Instanz einer Jobausführung anzeigen, indem Sie die Option --instance im Befehl ibmcloud ce jobrun events verwenden. Verwenden Sie den Befehl jobrun get, um Details zu Ihrer Jobausführung anzuzeigen, einschließlich der aktiven Instanzen der Jobausführung.

ibmcloud ce jobrun events --instance myjobrun-2-0

Getting events for job run instance 'myjobrun-2-0'...
OK

myjobrun-2-0:
    Type    Reason     Age    Source                  Messages
    Normal  Scheduled  3m39s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-2-0 to 10.240.64.131
    Normal  Pulling    3m37s  kubelet, 10.240.64.131  Pulling image "icr.io/codeengine/testjob"
    Normal  Pulled     2m42s  kubelet, 10.240.64.131  Successfully pulled image "icr.io/codeengine/testjob"
    Normal  Created    2m42s  kubelet, 10.240.64.131  Created container myjobrun
    Normal  Started    2m41s  kubelet, 10.240.64.131  Started container myjobrun

Befehlsoptionen

--name, -n

Der Name der Jobausführung. Dieser Wert ist erforderlich.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce jobrun get --name myjobrun  

Beispielausgabe

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Getting events of jobrun 'myjobrun'...
Run 'ibmcloud ce jobrun events -n myjobrun' to get the system events of the job run instances.
Run 'ibmcloud ce jobrun logs -f -n myjobrun' to follow the logs of the job run instances.
OK

Name:          myjobrun
[...]
Created:       2021-03-02T10:31:13-05:00

Image:                icr.io/codeengine/firstjob
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G

Runtime:
    Mode:                  task
    Array Indices:         1-5
    Array Size:            5
    JOP_ARRAY_SIZE Value:  5
    Max Execution Time:    7200
    Retry Limit:           3

Status:
    Completed:          2m58s
    Instance Statuses:
        Succeeded:  5
    Conditions:
        Type      Status  Last Probe  Last Transition
    Pending   True    3m55s       3m55s
    Running   True    3m51s       3m51s
    Complete  True    2m58s       2m58s

Events:
    Type     Reason         Age                     Source                Messages
    [...]
    Normal   Updated        3m38s (x23 over 3m56s)  batch-job-controller  Updated JobRun "myjobrun"
    Normal   Updated        3m38s (x22 over 3m56s)  batch-job-controller  Updated JobRun "myjobrun"

Instances:
    Name           Running  Status     Restarts  Age
    myjobrun-1-0  0/1      Succeeded  0         3m58s
    myjobrun-2-0  0/1      Succeeded  0         3m58s
    myjobrun-3-0  0/1      Succeeded  0         3m57s
    myjobrun-4-0  0/1      Succeeded  0         3m58s
    myjobrun-5-0  0/1      Succeeded  0         3m58s

Befehlsoptionen

--job, -j

Verwenden Sie diese Option, um nur Job-Läufe des angegebenen Jobs anzuzeigen. Dieser Wert ist optional.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce jobrun list

Beispielausgabe

Listing job runs...
OK

Name                         Failed  Pending  Requested  Running  Succeeded  Unknown  Age
firstjob-jobrun-shnj5        0       0        0          0        1          0        11d
myjob-jobrun-fji48           0       0        0          0        5          0        11d
myjob-jobrun-xeqc8           0       0        0          0        5          0        12d
myjobrun                     0       0        0          0        5          0        7m47s
mytestjob-jobrun-el0o8       0       0        0          0        1          0        11d
testjobrun                   0       0        0          0        5          0        11d

Der Name der aufgelisteten Jobausführung gibt den Namen der Jobausführung und die aktuelle Revision der Jobausführung an.

Befehlsoptionen

--follow, -f

Verfolgt die Protokolle der Jobausführungsinstanzen. Verwenden Sie diese Option, um Protokolle von Jobausführungsinstanzen zu streamen. Wenn Sie die Option --follow angeben, müssen Sie diesen Protokollbefehl mit der Tastenkombination Ctrl+C beenden. Dieser Wert ist optional. Der Standardwert ist false.

--instance, -i

Der Name einer bestimmten Instanz der Jobausführung. Verwenden Sie den Befehl jobrun get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --jobrun nicht angegeben ist.

--jobrun, -j, --name, -n

Zeigt die Protokolle aller Instanzen der angegebenen Jobausführung an. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--raw, -r

Protokolle ohne Instanz-und Containerbeschriftungen anzeigen. Dieser Wert ist optional. Der Standardwert ist false.

--tail, -t

Begrenzt die Anzeige von Protokollen der angegebenen Jobausführungsinstanzen auf eine maximale Anzahl von zuletzt ausgeführten Zeilen. Um beispielsweise die letzten 3 Zeilen der Protokolle der angegebenen Jobausführungsinstanzen anzuzeigen, geben Sie --tail 3 an. Wird diese Option nicht angegeben, werden alle Zeilen der Protokolle der angegebenen Jobausführungsinstanzen angezeigt. Dieser Wert ist optional. Der Standardwert ist -1.

--timestamps, --ts

Zeitmarke in jeder Zeile der Protokollausgabe einfügen. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

Im folgenden Beispiel werden die Protokolle für eine bestimmte Instanz einer Jobausführung angezeigt. Verwenden Sie den Befehl jobrun get, um den Namen der Jobausführungsinstanzen abzurufen.

ibmcloud ce jobrun logs --instance myjobrun-3-0

Beispielausgabe

Getting logs for job run instance 'myjobrun-3-0'...
OK

myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3

Beispiel für Protokolle aller Instanzen einer Jobausführung

Im folgenden Beispiel werden die Protokolle aller Instanzen einer Jobausführung angezeigt.

ibmcloud ce jobrun logs --jobrun myjobrun

Getting logs for all instances of job run 'myjobrun'...
Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
OK

myjobrun-1-0/myjobrun:
Hi from a batch job! My index is: 1

myjobrun-2-0/myjobrun:
Hi from a batch job! My index is: 2

myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3

myjobrun-4-0/myjobrun:
Hi from a batch job! My index is: 4

myjobrun-5-0/myjobrun:
Hi from a batch job! My index is: 5

Befehlsoptionen

--instance, -i

Der Name einer bestimmten Instanz der Jobausführung. Verwenden Sie den Befehl jobrun get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --jobrun nicht angegeben ist.

--jobrun, -j, --name, -n

Starten Sie alle aktiven Instanzen der angegebenen Jobausführung erneut. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce jobrun restart --name myjobrun   

Beispielausgabe

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Restarting all running instances of job run 'myjobrun'...
OK

Befehlsoptionen

--jobrun, -j

Der Name der vorherigen Jobausführung, auf der diese Jobausführung basiert. Dieser Wert ist erforderlich.

--argument, --arg, -a

Legt die Argumente für diese Jobausführung fest. Geben Sie für jede Option des Typs --argument ein Argument an; Beispiel: -a argA -a argB. Dieser Wert ist optional.

--arguments-clear, --ac

Jobausführungsargumente löschen. Dieser Wert ist optional. Der Standardwert ist false.

--array-indices, --ai

Gibt die Arrayindizes an, die für diese Jobausführung verwendet werden. Geben Sie die Liste oder den Bereich der Indizes durch Bindestriche (-) oder Kommas (,) getrennt an. Beispiel: 0,3,6,9 oder 1-5,7-8,10. Das Maximum ist 999999. Diese Option kann nur angegeben werden, wenn die --array-size Option nicht angegeben ist. Dieser Wert ist optional.

--array-size, --as, --instances, --is

Gibt die Anzahl der Instanzen an, die für diesen Joblauf verwendet werden. Wenn Sie diese Option verwenden, konvertiert das System in Array-Indizes. Wenn Sie zum Beispiel instances von 5 angeben, konvertiert das System in array-indices von 0 - 4. Diese Option kann nur angegeben werden, wenn die Option --array-indices nicht angegeben ist. Dieser Wert ist optional. Der Standardwert ist 0.

--array-size-var-override, --array-size-variable-override, --asvo

Legt einen benutzerdefinierten Wert für die JOB_ARRAY_SIZE Umgebungsvariable fest. Standardmäßig ist die JOB_ARRAY_SIZE Umgebungsvariable entweder auf den array-size Wert oder auf die Anzahl der durch angegebenen array-indices Indizes gesetzt. Der Wert der Umgebungsvariablen JOB_ARRAY_SIZE wirkt sich nicht auf die konfigurierte Arraygröße aus. Verwenden Sie diese Option, um einen konstanten Array-Größenwert für Jobwiederholungsszenarios zu erzwingen, in denen nur einige Jobinstanzen übergeben oder erneut übergeben werden. Dieser Wert ist optional.

--command, --cmd, -c

Legt die Befehle für diese Jobausführung fest. Geben Sie für jede Option des Typs --command einen Befehl an; Beispiel: --cmd cmdA --cmd cmdB. Dieser Wert überschreibt den Standardbefehl, der im Container-Image angegeben ist. Dieser Wert ist optional.

--commands-clear, --cc

Jobausführungsbefehle löschen. Dieser Wert ist optional. Der Standardwert ist false.

--cpu

Die CPU-Kapazität, die für jeden Arrayindex für diese Jobausführung festgelegt ist. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 0.

--env, -e

Legt die Umgebungsvariablen für diese Jobausführung fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: -e envA -e envB. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-from-configmap-rm, --env-cm-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige Konfigurationszuordnungen mithilfe des Konfigurationszuordnungsnamens. Wenn Sie einzelne Schlüsselverweise auf Konfigurationszuordnungen entfernen möchten, verwenden Sie die Option --env-rm. Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--env-from-secret-rm, --env-sec-rm

Entfernt Verweise von Umgebungsvariablen auf vollständige geheime Schlüssel mithilfe des Namens des geheimen Schlüssels. Wenn Sie einzelne Schlüsselverweise auf geheime Schlüssel entfernen möchten, verwenden Sie die Option --env-rm. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--env-rm

Entfernt Verweise von Umgebungsvariablen auf den Schlüssel eines Schlüssel/Wert-Paars in einer Konfigurationszuordnung oder in einem geheimen Schlüssel. Wenn Sie einzelne Schlüsselverweise und Literalwerte entfernen möchten, geben Sie den Namen des Schlüssels an. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--ephemeral-storage, --es

Die Menge des ephemeren Speichers für diese Jobausführung. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit der Option --env-from-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit der Option ---env-from-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--maxexecutiontime, --met

Die maximale Ausführungszeit in Sekunden, die für diese Jobausführung festgelegt wurde. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 7200.

--memory, -m

Die Speichermenge, die dieser Jobausführung zugeordnet werden soll. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional.

--mode

Der Modus der Jobausführung. Gültige Werte sind task und daemon. Im task Modus gelten die Optionen maxexecutiontime retrylimit und. Im daemon Modus sind die Optionen maxexecutiontime retrylimit und nicht zulässig, da es keine Zeitüberschreitung gibt und fehlgeschlagene Instanzen unbegrenzt neu gestartet werden. Dieser Wert ist optional.

--mount-configmap, --mount-cm

Fügen Sie dem Dateisystem dieser Jobausführung den Inhalt einer Konfigurationszuordnung hinzu, indem Sie ein Mountverzeichnis und den Namen einer Konfigurationszuordnung im Format MOUNT_DIRECTORY=CONFIGMAP_NAME angeben. Jede angehängte Konfigurationszuordnung muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in der Konfigurationszuordnung wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-configmap an; Beispiel: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Dieser Wert ist optional.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--mount-rm

Entfernen Sie den Inhalt einer Konfigurationszuordnung oder eines geheimen Schlüssels aus dem Dateisystem dieser Jobausführung, indem Sie das Verzeichnis angeben, in dem die Konfigurationszuordnung oder der geheime Schlüssel angehängt ist. Geben Sie ein Mountverzeichnis pro Option des Typs --mount-rm an. Beispiel: --mount-rm /etc/configmap-a --mount-rm /etc/secret-b. Dieser Wert ist optional.

--mount-secret, --mount-sec

Fügen Sie den Inhalt eines geheimen Schlüssels zum Dateisystem dieser Jobausführung hinzu, indem Sie ein Mountverzeichnis und den Namen eines geheimen Schlüssels im Format MOUNT_DIRECTORY=SECRET_NAME angeben. Jeder angehängte geheime Schlüssel muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in dem geheimen Schlüssel wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-secret an; Beispiel: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Dieser Wert ist optional.

-n, --name

Der Name dieser Jobausführung. Dieser Wert ist erforderlich, wenn der referenzierte Job nicht über eine zugehörige Jobkonfiguration verfügt. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 53 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist optional.

--no-wait, --nw

Übergibt die Jobausführung erneut und wartet nicht darauf, dass die Instanzen dieser Jobausführung abgeschlossen werden. Wenn Sie die Option --no-wait angeben, wird die erneute Übergabe der Jobausführung gestartet, ohne zu warten. Den Status der Jobausführung können Sie mit dem Befehl jobrun get überprüfen. Dieser Wert ist optional. Der Standardwert ist true.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--retrylimit, -r

Gibt an, wie oft eine Instanz dieser Jobausführung erneut ausgeführt werden soll, bevor die Jobausführung als fehlgeschlagen markiert wird. Ein Arrayindex einer Jobausführung wird bei einem anderen Beendigungscode als null erneut ausgeführt. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 3.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--service-account-clear, --sac

Löschen Sie das Dienstkonto. Dieser Wert ist optional. Der Standardwert ist false.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens für Instanzen dieser Jobausführung. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Übergibt die Jobausführung erneut und wartet darauf, dass die Instanzen dieser Jobausführung abgeschlossen werden. Wenn Sie die Option --wait angeben, wartet der Befehl für die erneute Übergabe der Jobausführung darauf, dass die Jobausführung abgeschlossen wird; die maximale Wartezeit hierfür wird in Sekunden durch die Option --wait-timeout angegeben. Falls die Jobausführung innerhalb des durch --wait-timeout angegebenen Zeitraums nicht abgeschlossen wird, schlägt die erneute Übergabe der Jobausführung fehl. Dieser Wert ist optional. Der Standardwert ist false.

--wait-timeout, --wto

Gibt in Sekunden an, wie lange gewartet werden soll, bis diese Jobausführung abgeschlossen ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

Im folgenden Beispiel wird die Jobausführung myjobrun für die Instanzen 4-5 erneut ausgeführt. Der Name der erneut übergebenen Jobausführung lautet myjobresubmit.

ibmcloud ce jobrun resubmit --name myjobresubmit --jobrun myjobrun --array-indices 4-5

Beispielausgabe

Getting job run 'myjobrun'...
Rerunning job run 'myjobresubmit'...
Run 'ibmcloud ce jobrun get -n myjobresubmit' to check the job run status.
OK

Befehlsoptionen

--argument, --arg, -a

Legt die Argumente für diese Jobausführung fest. Geben Sie für jede Option des Typs --argument ein Argument an; Beispiel: -a argA -a argB. Dieser Wert ist optional.

--array-indices, --ai

Gibt die Arrayindizes an, die für diese Jobausführung verwendet werden. Geben Sie die Liste oder den Bereich der Indizes durch Bindestriche (-) oder Kommas (,) getrennt an. Beispiel: 0,3,6,9 oder 1-5,7-8,10. Das Maximum ist 999999. Diese Option kann nur angegeben werden, wenn die --array-size Option nicht angegeben ist. Dieser Wert ist optional. Der Standardwert ist 0.

--array-size, --as, --instances, --is

Gibt die Anzahl der Instanzen an, die für diesen Joblauf verwendet werden. Wenn Sie diese Option verwenden, konvertiert das System in Array-Indizes. Wenn Sie zum Beispiel instances von 5 angeben, konvertiert das System in array-indices von 0 - 4. Diese Option kann nur angegeben werden, wenn die Option --array-indices nicht angegeben ist. Dieser Wert ist optional. Der Standardwert ist 1.

--array-size-var-override, --array-size-variable-override, --asvo

Legt einen benutzerdefinierten Wert für die JOB_ARRAY_SIZE Umgebungsvariable fest. Standardmäßig ist die JOB_ARRAY_SIZE Umgebungsvariable entweder auf den array-size Wert oder auf die Anzahl der durch angegebenen array-indices Indizes gesetzt. Der Wert der Umgebungsvariablen JOB_ARRAY_SIZE wirkt sich nicht auf die konfigurierte Arraygröße aus. Verwenden Sie diese Option, um einen konstanten Array-Größenwert für Jobwiederholungsszenarios zu erzwingen, in denen nur einige Jobinstanzen übergeben oder erneut übergeben werden. Dieser Wert ist optional.

--command, --cmd, -c

Legt die Befehle für diese Jobausführung fest. Geben Sie für jede Option des Typs --command einen Befehl an; Beispiel: --cmd cmdA --cmd cmdB. Dieser Wert überschreibt den Standardbefehl, der im Container-Image angegeben ist. Dieser Wert ist optional.

--cpu

Die CPU-Kapazität, die für jeden Arrayindex für diese Jobausführung festgelegt ist. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 1.

--env, -e

Legt die Umgebungsvariablen für diese Jobausführung fest. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue Umgebungsvariable hinzugefügt oder eine vorhandene Umgebungsvariable überschrieben. Geben Sie für jede Option des Typs --env eine Umgebungsvariable an; Beispiel: -e envA -e envB. Dieser Wert ist optional.

--env-cm, --env-from-configmap

Legen Sie Umgebungsvariablen aus den Schlüssel-/Wert-Paaren fest, die in dieser Konfigurationszuordnung gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie bei der Referenz der Konfigurationszuordnung ein Präfix angeben. Verwenden Sie den Wert PREFIX=CONFIGMAP_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_CONFIGMAP> auf. Wenn Sie beispielsweise das Präfix für alle Variablennamen von Schlüsseln in der Konfigurationszuordnung configmapName auf CUSTOM_ setzen möchten, verwenden Sie den Wert CUSTOM_=configmapName. Wenn die Konfigurationszuordnung configmapName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Wenn Sie beispielsweise eine Umgebungsvariable für den einzelnen Schlüssel key1 in der Konfigurationszuordnung configmapName hinzufügen möchten, verwenden Sie den Wert configmapName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Um beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einer Konfigurationszuordnung namens configmapName hinzuzufügen, verwenden Sie den Wert configmapName:myKey=key1.

Dieser Wert ist optional.

--env-sec, --env-from-secret

Legen Sie Umgebungsvariablen aus den Schlüssel-Wert-Paaren fest, die in einem Geheimnis gespeichert sind, indem Sie eine der folgenden Methoden verwenden:

• Wenn Sie Umgebungsvariablen für alle Schlüssel im geheimen Schlüssel secretName hinzufügen möchten, verwenden Sie den Wert secretName. Sie können die Namen der Umgebungsvariablen ändern, indem Sie beim Verweis auf den geheimen Schlüssel ein Präfix angeben. Verwenden Sie den Wert PREFIX=SECRET_NAME, um ein Präfix anzugeben. Jede resultierende Umgebungsvariable weist das Format <PREFIX><NAME_OF_KEY_IN_SECRET> auf. Um beispielsweise das Präfix für alle Variablennamen von Schlüsseln im geheimen Schlüssel secretName auf CUSTOM_ zu setzen, verwenden Sie den Wert CUSTOM_=secretName. Wenn der geheime Schlüssel secretName die Angabe KEY_A enthält, lautet der Name der Umgebungsvariablen CUSTOM_KEY_A.
• Um Umgebungsvariablen für einzelne Schlüssel hinzuzufügen, verwenden Sie das Format NAME:KEY_A,KEY_B. Um beispielsweise eine Umgebungsvariable für einen einzelnen Schlüssel key1 in einem geheimen Schlüssel mit dem Namen secretName hinzuzufügen, verwenden Sie den Wert secretName:key1. Um einem referenzierten Schlüssel einen anderen Namen zuzuordnen, verwenden Sie das Format NAME:NEW_NAME=KEY_A. Wenn Sie beispielsweise eine Umgebungsvariable namens myKey für key1 mit einzelnem Schlüssel in einem geheimen Schlüssel namens secretName hinzufügen möchten, verwenden Sie den Wert secretName:myKey=key1.

Dieser Wert ist optional.

--ephemeral-storage, --es

Die Menge des ephemeren Speichers für diese Jobausführung. Verwenden Sie M für Megabyte und G für Gigabyte. Dieser Wert ist optional. Der Standardwert ist 400M.

--force, -f

Die Existenz der angegebenen Configmap- und Secret-Referenzen wird nicht überprüft. Configmap-Referenzen werden mit der Option --env-from-configmap angegeben. Referenzen zu geheimen Schlüsseln werden mit den Optionen --env-from-secret oder --registry-secret angegeben. Dieser Wert ist optional. Der Standardwert ist false.

--image, -i

Der Name des Images, das für diese Jobausführung verwendet wird. Das Format ist REGISTRY/NAMESPACE/REPOSITORY:TAG. Dabei sind REGISTRY und TAG optional. Wird REGISTRY nicht angegeben, ist docker.io der Standardwert. Wird TAG nicht angegeben, ist latest der Standardwert. Wenn Sie die Option --job nicht angeben, sind die Werte für --name und --image erforderlich. Dieser Wert ist optional.

--job, -j

Der Name der Jobkonfiguration. Jobkonfigurationen können Sie mit dem Befehl job list anzeigen. Wenn Sie den Wert --job angeben, können Sie optional den Wert --name angeben. Wenn Sie den Wert --job nicht angeben, müssen Sie Werte für --name und --image angeben. Dieser Wert ist optional.

--maxexecutiontime, --met

Die maximale Ausführungszeit in Sekunden, die für diese Jobausführung festgelegt wurde. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 7200.

--memory, -m

Die Speichermenge, die dieser Jobausführung zugeordnet werden soll. Verwenden Sie M für Megabyte und G für Gigabyte. Informationen zu gültigen Werten finden Sie unter Unterstützte Speicher-und CPU-Kombinationen. Dieser Wert ist optional. Der Standardwert ist 4G.

--mode

Der Modus der Jobausführung. Gültige Werte sind task und daemon. Im task Modus gelten die Optionen maxexecutiontime retrylimit und. Im daemon Modus sind die Optionen maxexecutiontime retrylimit und nicht zulässig, da es keine Zeitüberschreitung gibt und fehlgeschlagene Instanzen unbegrenzt neu gestartet werden. Dieser Wert ist optional. Der Standardwert ist task.

--mount-configmap, --mount-cm

Fügen Sie dem Dateisystem dieser Jobausführung den Inhalt einer Konfigurationszuordnung hinzu, indem Sie ein Mountverzeichnis und den Namen einer Konfigurationszuordnung im Format MOUNT_DIRECTORY=CONFIGMAP_NAME angeben. Jede angehängte Konfigurationszuordnung muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in der Konfigurationszuordnung wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-configmap an; Beispiel: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Dieser Wert ist optional.

--mount-data-store, --mount-ds

Anhängen eines persistenten Datenspeichers. Das Format lautet MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Der SUBPATH ist optional. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.

--mount-secret, --mount-sec

Fügen Sie den Inhalt eines geheimen Schlüssels zum Dateisystem dieser Jobausführung hinzu, indem Sie ein Mountverzeichnis und den Namen eines geheimen Schlüssels im Format MOUNT_DIRECTORY=SECRET_NAME angeben. Jeder angehängte geheime Schlüssel muss ein eindeutiges Mountverzeichnis verwenden. Für jedes Schlüssel/Wert-Paar in dem geheimen Schlüssel wird eine Datei zum angegebenen Mountverzeichnis hinzugefügt, wobei der Dateiname der Schlüssel und der Inhalt der Datei der Wert des Schlüssel/Wert-Paars ist. Geben Sie eine einzige Mountkonfiguration pro Option des Typs --mount-secret an; Beispiel: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Dieser Wert ist optional.

-n, --name

Der Name dieser Jobausführung. Wenn Sie den Wert für --job nicht angeben, sind die Werte für --name und --image erforderlich. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 53 Zeichen bestehen und kann Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.

Dieser Wert ist optional.

--no-wait, --nw

Übergibt die Jobausführung und wartet nicht darauf, dass die Instanzen dieser Jobausführung abgeschlossen werden. Wenn Sie die Option --no-wait angeben, wird die Übergabe der Jobausführung ohne Warten gestartet. Den Status der Jobausführung können Sie mit dem Befehl jobrun get überprüfen. Dieser Wert ist optional. Der Standardwert ist true.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--registry-secret, --rs

Der Name des geheimen Registry-Schlüssels. Der geheime Registry-Schlüssel wird für die Authentifizierung bei einer privaten Registry verwendet, wenn Sie das Container-Image herunterladen. Dieser Wert ist optional.

--retrylimit, -r

Gibt an, wie oft eine Instanz dieser Jobausführung erneut ausgeführt werden soll, bevor die Jobausführung als fehlgeschlagen markiert wird. Ein Arrayindex einer Jobausführung wird bei einem anderen Beendigungscode als null erneut ausgeführt. Diese Option kann nur angegeben werden, wenn mode ist task. Dieser Wert ist optional. Der Standardwert ist 3.

--service-account, --sa

Der Name des Dienstkontos. Ein Dienstkonto bietet eine Identität für Prozesse, die in einer Instanz laufen. Für integrierte Service-Konten können Sie die verkürzten Namen manager, none, reader und writer verwenden. Sie können auch die vollständigen Namen verwenden, denen der Kubernetes Config Context vorangestellt ist, der mit dem Befehl project current ermittelt werden kann. Dieser Wert ist optional.

--trusted-profiles-enabled, --trusted, --tpe

Aktivieren Sie das Anhängen eines Rechenressourcentokens für Instanzen dieser Jobausführung. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Übergibt die Jobausführung und wartet darauf, dass die Instanzen dieser Jobausführung abgeschlossen werden. Wenn Sie die Option --wait angeben, wartet der Befehl für die Übergabe der Jobausführung darauf, dass die Jobausführung abgeschlossen wird; die maximale Wartezeit hierfür wird in Sekunden durch die Option --wait-timeout angegeben. Falls die Jobausführung innerhalb des durch --wait-timeout angegebenen Zeitraums nicht abgeschlossen wird, schlägt die Übergabe der Jobausführung fehl. Dieser Wert ist optional. Der Standardwert ist false.

--wait-timeout, --wto

Gibt in Sekunden an, wie lange gewartet werden soll, bis diese Jobausführung abgeschlossen ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce jobrun submit --name myjobrun --image icr.io/codeengine/firstjob --array-indices 1-5

Beispielausgabe

Submitting job run 'myjobrun'...
Run 'ibmcloud ce jobrun get -n myjobrun' to check the job run status.
OK

Befehlsoptionen

--cos-access-secret, --cos-sec

Erforderlich. Der Name des Geheimnisses, das die Anmeldedaten für den Zugriff auf die COS-Instanz enthält. Dieser Wert ist erforderlich.

--cos-bucket-name, --cos-bucket

Erforderlich. Der Name des COS-Buckets. Dieser Wert ist erforderlich.

--name, -n

Erforderlich. Der Name des persistenten Datenspeichers. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist. Dieser Wert ist erforderlich.

--cos-bucket-location, --cos-loc

Der Standort des COS-Eimers. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce persistentdatastore create --name my-pds-2 --cos-bucket-name my-test-bucket-2 --cos-access-secret my-hmac-secret-2

Beispielausgabe

Successfully created persistent data store named 'my-pds-2'.
OK

Befehlsoptionen

--name, -n

Erforderlich. Name des persistenten Datenspeichers. Dieser Wert ist erforderlich.

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--ignore-not-found, --inf

Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce persistentdatastore delete --name my-pds-3 -f

Beispielausgabe

Deleting persistent data store 'my-pds-3'...
OK

Befehlsoptionen

--name, -n

Erforderlich. Der Name des persistenten Datenspeichers. Dieser Wert ist erforderlich.

--output, -o

Ausgabeformat. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce persistentdatastore get --name my-pds-2

Beispielausgabe

Getting persistent data store 'my-pds-2'...
OK

Name:          my-pds-2  
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  
Type:          object_storage  
Created:       Fri, 11 Jul 2025 13:52:30 +0200  
Age:           103s  
Project Name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  

Data:    
  COS bucket:     my-test-bucket-2  
  Access secret:  my-hmac-secret-2  
  Bucket region:  eu-de  

Befehlsoptionen

--output, -o

Ausgabeformat. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

Dieser Befehl listet alle persistenten Datenspeicher in einem Projekt auf.

ibmcloud ce persistentdatastore list

Beispielausgabe

Listing persistent data stores...
OK
Name                       COS bucket          Access secret     Bucket region  Age  
my-pds-1                   my-test-bucket-1    my-hmac-secret-1  eu-gb          36d  
my-pds-2                   my-test-bucket-2    my-hmac-secret-2  eu-de          86s  
my-pds-3                   my-test-bucket-3    my-hmac-secret-3  us-south       6m30s  

Befehlsoptionen

-n, --name

Der Name des Projekts. Verwenden Sie einen Namen, der in Ihrer Region eindeutig ist. Der Name darf aus maximal 128 Zeichen bestehen und folgendes enthalten:

• Alle Unicode-Zeichen und alphanumerischen Zeichen.
• Nur die folgenden Sonderzeichen: Leerzeichen ( ), Punkte (.), Doppelpunkte (:), Unterstriche (_) und Bindestriche (-).

Dieser Wert ist erforderlich.

--endpoint, -e

Der Endpunkt für das Projekt Gültige Werte sind public und private. Wenn die Option --endpoint nicht explizit angegeben wird, wird das Verhalten vom System bestimmt. Wenn die IBM Cloud-CLI mit private.cloud.ibm.com verbunden ist, verhält sich das Code Engine-Projekt so, als wäre --endpoint private. Wenn die IBM Cloud-CLI mit cloud.ibm.com verbunden ist, verhält sich das Code Engine-Projekt so, als wäre --endpoint public. Dieser Wert ist optional.

--no-select, --ns

Wählen Sie das Projekt nicht nach seiner Erstellung als aktueller Kontext aus. Wenn Sie diese Option nicht auswählen, wird das Projekt automatisch ausgewählt. Dieser Wert ist optional. Der Standardwert ist false.

--no-wait, --nw

Projekt erstellen und nicht auf die Erstellung des Projekts warten. Wenn Sie die Option no-wait angeben, wird die Projekterstellung gestartet und nicht abgewartet. Mit dem Befehl project get können Sie den Projektstatus überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--tag, -t

Eine Bezeichnung, die Sie Ihrem Projekt zuweisen. Die Bezeichnung darf maximal 128 Zeichen lang sein und darf Buchstaben, Zahlen, Leerzeichen ( ), Punkte (.), Doppelpunkte (:), Unterstreichungszeichen (_) und Bindestriche (-) enthalten. Geben Sie eine Beschriftung pro --tag-Option an, z. B. --tag tagA --tag tagB. Dieser Wert ist optional.

--wait, -w

Projekt erstellen und auf die Erstellung des Projekts warten. Wenn Sie die Option --wait angeben, wartet die Projekterstellung für eine maximale Dauer in Sekunden (wie durch die Option --wait-timeout festgelegt) darauf, dass das Projekt erstellt wird. Falls das Projekt nicht innerhalb des mit --wait-timeout angegebenen Zeitraums erstellt wird, schlägt die Projekterstellung fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Gibt an, wie viele Sekunden auf die Erstellung des Projekts gewartet wird. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce project create --name myproject  

Beispielausgabe

Creating project 'myproject'...
OK

Befehlsoptionen

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce project current  

Beispielausgabe

Getting the current project context...
OK

Name:       myproject
ID:         01234567-abcd-abcd-abcd-abcdabcd1111
Subdomain:  aabon2dfwa0
Domain:     us-south.codeengine.appdomain.cloud
Region:     us-south
Kubectl Context:  4svg40kna19

Kubernetes Config:
Context:             aabon2dfwa0
Environment Variable: export KUBECONFIG=/user/myusername/.bluemix/plugins/code-engine/myproject-01234567-abcd-abcd-abcd-abcdabcd1111.yaml

Befehlsoptionen

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--hard

Das Projekt sofort löschen. Wenn Sie die Option --hard nicht angeben, kann das Projekt innerhalb von 7 Tagen entweder mit dem Befehl project restore oder mit dem Befehl reclamation restore wiederhergestellt werden. Dieser Wert ist optional. Der Standardwert ist false.

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--no-wait, --nw

Das Projekt löschen und nicht warten, bis das Projekt gelöscht wird. Wenn Sie die Option no-wait angeben, wird die Löschung des Projekts ohne Warten gestartet. Mit dem Befehl project get können Sie den Projektstatus überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Das Projekt löschen und warten, bis das Projekt gelöscht wird. Wenn Sie die Option --wait angeben, wird mit der Projektlöschung eine bestimmte maximale Zeit in Sekunden, die durch die Option --wait-timeout angegeben wird, gewartet. Wenn das Projekt nicht innerhalb des in --wait-timeout angegebenen Zeitraums gelöscht wird, schlägt das Löschen des Projekts fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum in Sekunden, der abgewartet werden soll, bis das Projekt gelöscht wird. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

ibmcloud ce project delete --name myproject -f

Beispielausgabe

Deleting project 'myproject'...
OK

Befehlsoptionen

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce project get --name myproject

Beispielausgabe

Getting project 'myproject'...
OK

Name:                       myproject
ID:                         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
Status:                     active
Selected:                   true
Tags:                       tag1, tag2
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500

Quotas:
    Category                                  Used      Limit
    App revisions                             1         100
    Apps                                      1         100
    Build runs                                0         100
    Builds                                    0         100
    Configmaps                                2         100
    CPU                                       1.025     64
    Ephemeral storage                         902625Ki  256G
    Instances (active)                        1         250
    Instances (total)                         2         2500
    Job runs                                  1         100
    Jobs                                      1         100
    Memory                                    4400M     256G
    Secrets                                   5         100
    Subscriptions (cron)                      0         100
    Subscriptions (IBM Cloud Object Storage)  0         100

Befehlsoptionen

--all-resource-groups, --all

Zeigt Projekte aus allen Ressourcengruppen an. Standardmäßig werden nur Projekte aus der aktuellen Ressourcengruppe angezeigt. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--regions, -r

Begrenzt die Anzeige von Projekten auf angegebene Regionen. Geben Sie den Namen von einer oder mehreren Regionen an. Beispiel: us-south,eu-de. Dieser Wert ist optional.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce project list

Beispielausgabe

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      09768af4-abcd-abcd-abcd-24674ba90db0  active  false           eu-de     default         27d
myproject        cd09cfe1-abcd-abcd-abcd-0f8a8a1d0ddf  active  true            us-south  default         52d

Befehlsoptionen

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--no-wait, --nw

Stellen Sie das Projekt wieder her und warten Sie nicht, bis das Projekt wiederhergestellt ist. Wenn Sie die Option no-wait angeben, beginnt die Projektzurückschreibung und wartet nicht. Mit dem Befehl project get können Sie den Projektstatus überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Stellen Sie das Projekt wieder her und warten Sie, bis das Projekt wiederhergestellt werden soll. Wenn Sie die Option --wait angeben, wartet die Projektzurückschreibung auf eine maximale Zeit in Sekunden, die durch die Option --wait-timeout festgelegt wurde, für das Projekt, das zurückgeschrieben werden soll. Wenn das Projekt nicht innerhalb des angegebenen Zeitraums --wait-timeout wiederhergestellt wird, schlägt die Projektwiederherstellung fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Die Zeit in Sekunden, die gewartet wird, bis das Projekt wiederhergestellt ist. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

In diesem Beispiel wird das Projekt myproject , das sich im Status soft deleted befindet, in einen aktiven Status zurückgeschrieben. Verwenden Sie den Befehl project list , um eine Liste aller Projekte mit ihrem Status anzuzeigen.

ibmcloud ce project restore --name myproject

Beispielausgabe

Restoring project 'myproject'...
OK

Befehlsoptionen

--endpoint, -e

Der Endpunkt für das Projekt Gültige Werte sind public und private. Wenn die Option --endpoint nicht explizit angegeben wird, wird das Verhalten vom System bestimmt. Wenn die IBM Cloud-CLI mit private.cloud.ibm.com verbunden ist, verhält sich das Code Engine-Projekt so, als wäre --endpoint private. Wenn die IBM Cloud-CLI mit cloud.ibm.com verbunden ist, verhält sich das Code Engine-Projekt so, als wäre --endpoint public. Dieser Wert ist optional.

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--kubecfg, -k

Hängt das Projekt an die Kubernetes-Konfigurationsdatei an. Sie können die Kubernetes-Standardkonfigurationsdatei überschreiben, indem Sie die Umgebungsvariable KUBECONFIG festlegen. Dieser Wert ist optional. Der Standardwert ist false.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce project select --name myproject

Beispielausgabe

Selecting project 'myproject'...
OK

Befehlsoptionen

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--tag, -t

Eine Bezeichnung, die Sie Ihrem Projekt zuweisen. Die Bezeichnung darf maximal 128 Zeichen lang sein und darf Buchstaben, Zahlen, Leerzeichen ( ), Punkte (.), Doppelpunkte (:), Unterstreichungszeichen (_) und Bindestriche (-) enthalten. Geben Sie eine Beschriftung pro --tag-Option an, z. B. --tag tagA --tag tagB. Dieser Wert ist optional.

--tag-rm, --trm

Entfernen Sie ein Ihrem Projekt zugewiesenes Etikett. Geben Sie eine Bezeichnung pro Option --tag-rm an, z. B. --tag-rm tagA --tag-rm tagB. Dieser Wert ist optional.

Beispiel

ibmcloud ce project tag --name myproject --tag tag1 --tag tag2

Beispielausgabe

Getting project 'myproject'...
OK

Befehlsoptionen

--binding-resource-group, --brg

Der Name einer Ressourcengruppe zur Authentifizierung für die Servicebindungen dieses Projekts. Es wird eine Service-ID mit den Rollen Operator und Manager für alle Services in dieser Ressourcengruppe erstellt. Mit "*" können Sie alle Ressourcengruppen in diesem Konto angeben. Dieser Wert ist optional.

--binding-resource-group-id, --brgid

Die ID einer Ressourcengruppe, die für die Authentifizierung für die Servicebindungen dieses Projekts verwendet werden soll. Es wird eine Service-ID mit den Rollen Operator und Manager für alle Services in dieser Ressourcengruppe erstellt. Dieser Wert ist optional.

--binding-service-id, --bsid

Die ID einer Service-ID zur Authentifizierung für die Servicebindungen dieses Projekts. Diese Service-ID muss über die Rolle Operator verfügen sowie über eine entsprechende Servicerolle für mindestens eine Serviceinstanz, einen Servicetyp oder eine Ressourcengruppe. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce project update --binding-service-id ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f

Beispielausgabe

Configuring your project for service bindings...
Creating service binding API key 'my-project-api-key' for service ID 'my-custom-service-id'...
OK

Befehlsoptionen

--force, -f

Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--no-wait, --nw

Projektrückforderung löschen und nicht auf das Löschen der Projektrückforderung warten. Wenn Sie die Option no-wait angeben, wird der Löschvorgang für die Projektrückforderung gestartet und nicht abgewartet. Mit dem Befehl reclamation get können Sie den Status der Projektrückforderung überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Projektrückforderung löschen und auf das Löschen der Projektrückforderung warten. Wenn Sie die Option --wait angeben, wartet der Löschvorgang für die Projektrückforderung für eine maximale Dauer in Sekunden (wie durch die Option --wait-timeout festgelegt) darauf, dass die Projektrückforderung gelöscht wird. Wenn die Projektrückforderung nicht innerhalb des mit --wait-timeout angegebenen Zeitraums gelöscht wird, schlägt der Löschvorgang für die Projektrückforderung fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Gibt an, wie viele Sekunden auf das Löschen der Projektrückforderung gewartet wird. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

In diesem Beispiel wird das Projekt myproject, das sich im Status soft deleted befindet, permanent gelöscht. Durch die Verwendung der Option --force bei diesem Befehl wird der Löschvorgang ohne Bestätigung erzwungen. Mit dem Befehl reclamation list können Sie eine Liste aller Projekte anzeigen, die den Status soft deleted (Nicht permanent gelöscht) aufweisen.

ibmcloud ce reclamation delete --name myproject --f

Beispielausgabe

Hard deleting project 'myproject'...
OK

Befehlsoptionen

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

Beispiel

ibmcloud ce reclamation get --name myproject

Beispielausgabe

Getting project reclamation
OK

Name:                   myproject
Reclamation ID:         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
Status:                 soft deleted
Region:                 us-south
Resource Group:         default
Age:                    27m
Created:                Thu, 09 Sep 2021 13:24:15 -0400
Updated:                Thu, 09 Sep 2021 13:33:45 -0400
Time to Hard Deletion:  6d23h

Befehlsoptionen

--all-resource-groups, --all

Zeigt Projektrückforderungen aus allen Ressourcengruppen an. Standardmäßig werden nur Projektrückforderungen aus der aktuellen Ressourcengruppe angezeigt. Dieser Wert ist optional. Der Standardwert ist false.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--regions, -r

Begrenzt die Anzeige von Projektrückforderungen auf bestimmte Regionen. Geben Sie den Namen von einer oder mehreren Regionen an. Beispiel: us-south,eu-de. Dieser Wert ist optional.

--sort-by, -s

Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und age. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce reclamation list

Beispielausgabe

Getting project reclamations...
OK
Name          ID                                    Reclamation ID                        Status        Region    Resource Group  Age   Time to Hard Deletion
myproject     def218c5-abcd-abcd-abcd-97854c288d76  48e3d7a2-abcd-abcd-abcd-99db7152b8fe  soft deleted  us-south  default         40h   6d23h
myproject2    01f0bc66-abcd-abcd-abcd-3ef7e99f6f69  af2cd017-abcd-abcd-abcd-d32e2bb79136  soft deleted  jp-osa    default         8m58s 2d11h

Befehlsoptionen

--id, --guid

Die ID des Projekts. Dieser Wert ist erforderlich, wenn --name nicht angegeben ist.

--name, -n

Der Name des Projekts. Dieser Wert ist erforderlich, wenn --id nicht angegeben ist.

--no-wait, --nw

Projektrückforderung wiederherstellen und nicht auf die Wiederherstellung der Projektrückforderung warten. Wenn Sie die Option no-wait angeben, wird die Wiederherstellung für die Projektrückforderung gestartet und nicht abgewartet. Mit dem Befehl reclamation get können Sie den Status der Projektrückforderung überprüfen. Dieser Wert ist optional. Der Standardwert ist false.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--wait, -w

Projektrückforderung wiederherstellen und auf die Wiederherstellung der Projektrückforderung warten. Wenn Sie die Option --wait angeben, wartet die Wiederherstellung für die Projektrückforderung für eine maximale Dauer in Sekunden (wie durch die Option --wait-timeout festgelegt) darauf, dass die Projektrückforderung wiederhergestellt wird. Wenn die Projektrückforderung nicht innerhalb des mit --wait-timeout angegebenen Zeitraums wiederhergestellt wird, schlägt die Wiederherstellung der Projektrückforderung fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Gibt an, wie viele Sekunden auf die Wiederherstellung der Projektrückforderung gewartet wird. Dieser Wert ist erforderlich, wenn die Option --wait angegeben wird. Dieser Wert wird ignoriert, wenn die Option --no-wait angegeben wird. Der Standardwert ist 600.

Beispiel

In diesem Beispiel wird das Projekt myproject , das sich im Status soft deleted befindet, in einen aktiven Status zurückgeschrieben. Mit dem Befehl reclamation list können Sie eine Liste aller Projekte anzeigen, die den Status soft deleted (Nicht permanent gelöscht) aufweisen.

ibmcloud ce reclamation restore --name myproject

Beispielausgabe

Restoring project 'myproject'...
OK

Befehlsoptionen

-n, --name

Der Name des geheimen Schlüssels für den Zugriff auf die Image-Registry. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist.

• Der Name muss mit einem alphanumerischen Zeichen in Kleinschreibung beginnen und enden.
• Der Name darf aus maximal 253 Zeichen bestehen und kann Kleinbuchstaben, Zahlen, Punkte (.) und Bindestriche (-) enthalten.

Dieser Wert ist erforderlich.

--email, -e

Die E-Mail-Adresse für den Zugriff auf den Registry-Server. Dieser Wert ist optional.

--output, -o

Gibt das Format der Befehlsausgabe an. Gültige Werte sind json, yaml, jsonpath=JSONPATH_EXPRESSION und jsonpath-as-json=JSONPATH_EXPRESSION. Verwenden Sie jsonpath, um den Pfad zu einem Element der JSON-Ausgabe anzugeben. Dieser Wert ist optional.

--password, -p

Das Kennwort für den Zugriff auf den Registry-Server. Wenn weder die Option --password noch die Option --password-from-file oder die Option --password-from-json-file angegeben ist, werden Sie aufgefordert, das Kennwort einzugeben. Dieser Wert ist optional.

--password-from-file, --pf

Der Pfad zu der Datei, die das Kennwort für den Zugriff auf den Registry-Server enthält. Die erste Zeile der Datei wird für das Kennwort verwendet. Wenn weder die Option --password noch die Option --password-from-file oder die Option --password-from-json-file angegeben ist, werden Sie aufgefordert, das Kennwort einzugeben. Dieser Wert ist optional.

--password-from-json-file, --pfj

Der Pfad zu einer JSON-Datei, die das Kennwort für den Zugriff auf den Registry-Server enthält. Für das Kennwort wird das Feld apikey verwendet. Wenn weder die Option --password noch die Option --password-from-file oder die Option --password-from-json-file angegeben ist, werden Sie aufgefordert, das Kennwort einzugeben. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Dieser Wert ist optional. Der Standardwert ist false.

--server, -s

Die URL des Registry-Servers. Dieser Wert ist optional. Der Standardwert ist us.icr.io.

--username, -u

Der Benutzername für den Zugriff auf den Registry-Server. Dieser Wert ist optional. Der Standardwert ist iamapikey.