IBM Cloud Code Engine-CLI

Führen Sie die in diesem Abschnitt beschriebenen Befehle zum Verwalten der Entitäten aus, aus denen sich IBM Cloud® Code Engine zusammensetzt. Weitere Informationen zu Code Engine enthält der Abschnitt Einführung in Code Engine.

Verwenden Sie zum Ausführen von IBM Cloud Code Engine-Befehlen ibmcloud code-engine oder ibmcloud ce.

Voraussetzungen

  • Installieren Sie die IBM Cloud-CLI.

  • Installieren Sie die Code Engine-Befehlszeilenschnittstelle mit dem folgenden Befehl:

    ibmcloud plugin install code-engine

Anwendungsbefehle

Eine Anwendung oder App führt den Code für die Verarbeitung von HTTP-Anforderungen aus. Zusätzlich zu den traditionellen HTTP-Anforderungen unterstützt IBM Cloud® Code Engine auch Anwendungen, die WebSockets als Kommunikationsprotokoll verwenden. Die Anzahl der laufenden Instanzen einer App wird je nach eingehenden Anfragen und Ihren Konfigurationseinstellungen automatisch erhöht oder verringert (bis auf null). Eine App enthält eine oder mehrere Revisionen. Eine Revision stellt eine unveränderliche Version der Konfigurationseigenschaften der App dar. Bei jeder Aktualisierung einer Konfigurationseigenschaft der App wird eine neue Revision der App erstellt.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie application-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Apps finden Sie unter Anwendungen bereitstellen.

Sie können application oder app in Ihren application-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für application-Befehle anzeigen möchten, führen Sie ibmcloud ce app -h aus.

Informationen zur Verwaltung von Anwendungsrevisionen finden Sie in den Abschnitten zu den Befehlen ibmcloud ce revision.

ibmcloud ce application bind

IBM Cloud-Serviceinstanz an Anwendung binden.

ibmcloud ce application bind --name APP_NAME (--service-instance SI_NAME | --service-instance-id SI_ID)  [--no-wait] [--prefix PREFIX] [--quiet] [--role ROLE] [--service-credential SERVICE_CREDENTIAL] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

In diesem Beispiel verbinden Sie Ihre „ IBM Cloud Object Storage “-Service-Instanz mit dem Namen „ my-object-storage “ mit Ihrer 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

ibmcloud ce application create

Anwendung erstellen

ibmcloud ce application create --name APP_NAME ((--image IMAGE_REF | (--build-source SOURCE [--image IMAGE_REF])) [--argument ARGUMENT] [--build-commit BUILD_COMMIT] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-size BUILD_SIZE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--cluster-local] [--command COMMAND] [--concurrency CONCURRENCY] [--concurrency-target CONCURRENCY_TARGET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--max-scale MAX_SCALE] [--memory MEMORY] [--min-scale MIN_SCALE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-secret MOUNT_SECRET] [--no-cluster-local] [--no-wait] [--output OUTPUT] [--port PORT] [--probe-live PROBE_LIVE] [--probe-ready PROBE_READY] [--quiet] [--registry-secret REGISTRY_SECRET] [--request-timeout REQUEST_TIMEOUT] [--revision-name REVISION_NAME] [--scale-down-delay SCALE_DOWN_DELAY] [--service-account SERVICE_ACCOUNT] [--trusted-profiles-enabled] [--user USER] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

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 Option build commit ist nur zulässig, wenn die Option --build-source 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 build context directory ist nur zulässig, wenn die Option --build-source gesetzt 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 Option --build-source gesetzt 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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf 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 build size ist nur zulässig, wenn die Option --build-source gesetzt 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 strategy ist nur zulässig, wenn die Option --build-source gesetzt ist. Sofern nicht anders angegeben, wird die Build-Strategie von Code Engine bestimmt, wenn --build-source angegeben 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 build timeout ist nur zulässig, wenn die Option --build-source gesetzt 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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]. 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 mehrfach angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel: --probe-live type=tcp --probe-live port=8080. Weitere Informationen zur Arbeit mit Sonden finden Sie unter Konfigurieren von Sonden für Ihre Anwendung. 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 mehrfach angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel: --probe-ready type=tcp --probe-ready port=8080. Weitere Informationen zur Arbeit mit Sonden finden Sie unter Konfigurieren von Sonden für Ihre Anwendung. 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. Ein Anstieg der Anzahl gleichzeitiger Anfragen führt zu einer Skalierung einer Anwendung. Wenn die Anzahl der Anfragen sinkt (verringerte Gleichzeitigkeit), bestimmt die für diese Option angegebene Zeitspanne, wie lange die verringerte Gleichzeitigkeit bestehen bleiben muss, bevor die Anwendung herunterskaliert wird. Standardmäßig wird die Anwendung sofort verkleinert, wenn eine verminderte Gleichzeitigkeit festgestellt 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 ibmcloud ce application get -n 'myapp' ausführen, um den Anwendungsstatus zu überprüfen, wird die URL für Ihre Anwendung angezeigt.

ibmcloud ce application delete

Eine Anwendung löschen.

ibmcloud ce application delete --name APPLICATION_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

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'

ibmcloud ce application events

Zeigen Sie die Systemereignisse von Anwendungsinstanzen an. Systemereignisse werden bis zu 60 Minuten aufbewahrt.

ibmcloud ce application events (--instance APP_INSTANCE | --application APP_NAME) [--output OUTPUT] [--quiet]

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
Beispielausgabe
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
Beispielausgabe von Systemereignisinformationen für die angegebene Instanz einer App
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
    [...]

ibmcloud ce application get

Details einer Anwendung anzeigen.

ibmcloud ce application get --name APPLICATION_NAME [--output OUTPUT] [--quiet] [--show-all-revisions]

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

ibmcloud ce application list

Alle Anwendung im Projekt auflisten.

ibmcloud ce application list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce application logs

Die Protokolle der Anwendungsinstanzen anzeigen.

ibmcloud ce application logs (--instance APP_INSTANCE | --application APP_NAME) [--all-containers] [--follow] [--output OUTPUT] [--quiet] [--raw] [--tail TAIL] [--timestamps]

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. Wenn diese Option nicht angegeben wird, 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
Beispielausgabe für Protokolle aller Instanzen einer App
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/

ibmcloud ce application restart

Starten Sie aktive Anwendungsinstanzen erneut.

ibmcloud ce application restart (--instance APP_INSTANCE | --application APP_NAME) [--quiet]

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

ibmcloud ce application unbind

Bindung von IBM Cloud-Serviceinstanzen an eine Anwendung aufheben.

ibmcloud ce application unbind --name APP_NAME (--binding BINDING_NAME | --all) [--quiet]

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

ibmcloud ce application update

Anwendung aktualisieren. Durch die Aktualisierung der Anwendung wird eine Revision erstellt. Wenn Aufrufe für die Anwendung erstellt werden, wird der Datenverkehr an die Revision umgeleitet.

ibmcloud ce application update --name APP_NAME [--argument ARGUMENT] [--arguments-clear] [--build-clear] [--build-commit BUILD_COMMIT] [--build-commit-clear] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-git-repo-secret-clear] [--build-size BUILD_SIZE] [--build-source BUILD_SOURCE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--cluster-local] [--command COMMAND] [--commands-clear] [--concurrency CONCURRENCY] [--concurrency-target CONCURRENCY_TARGET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--image IMAGE] [--max-scale MAX_SCALE] [--memory MEMORY] [--min-scale MIN_SCALE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-rm MOUNT_RM] [--mount-secret MOUNT_SECRET] [--no-cluster-local] [--no-wait] [--output OUTPUT] [--port PORT] [--probe-live PROBE_LIVE] [--probe-live-clear] [--probe-ready PROBE_READY] [--probe-ready-reset] [--quiet] [--rebuild] [--registry-secret REGISTRY_SECRET] [--registry-secret-clear] [--request-timeout REQUEST_TIMEOUT] [--revision-name REVISION_NAME] [--scale-down-delay SCALE_DOWN_DELAY] [--service-account SERVICE_ACCOUNT] [--service-account-clear] [--trusted-profiles-enabled] [--user USER] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

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 zulässig, wenn für Ihre App derzeit ein zugehöriger Build vorhanden 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 Option „ --build-source “ auf den URL eines Git-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 für Ihre Anwendung derzeit ein zugehöriger Build vorhanden ist. 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 bei diesem Befehl „ app update “ die Option „ --build-source “ gesetzt ist oder Ihrer Anwendung derzeit 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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist nur zulässig, wenn die Option „ --build-source “ auf den URL eines Git-Repositorys in diesem application 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-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Löschen Sie den geheimen SSH-Schlüssel. Diese Option ist zulässig, wenn für Ihre Anwendung derzeit ein zugehöriger Build vorhanden ist. 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 bei diesem Befehl „ app update “ die Option „ --build-source “ gesetzt ist oder Ihrer Anwendung derzeit ein zugehöriger 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 bei diesem Befehl „ app update “ die Option „ --build-source “ gesetzt ist oder Ihrer Anwendung derzeit ein zugehöriger 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 bei diesem Befehl „ app update “ die Option „ --build-source “ gesetzt 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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]. 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 mehrfach angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel: --probe-live type=tcp --probe-live port=8080. Weitere Informationen zur Arbeit mit Sonden finden Sie unter Konfigurieren von Sonden für Ihre Anwendung. Dieser Wert ist optional.

--probe-live-clear, --plr

Entfernen Sie den Aktivitätsprüfung. Diese Option ist nur zulässig, wenn Ihre Anwendung derzeit über einen Liveness Probe 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 mehrfach angegeben werden. Die Eigenschaft type ist erforderlich und gültige Werte sind tcp und http. Zum Beispiel: --probe-ready type=tcp --probe-ready port=8080. Weitere Informationen zur Arbeit mit Sonden finden Sie unter Konfigurieren von Sonden für Ihre Anwendung. 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. Ein Anstieg der Anzahl gleichzeitiger Anfragen führt zu einer Skalierung einer Anwendung. Wenn die Anzahl der Anfragen sinkt (verringerte Gleichzeitigkeit), bestimmt die für diese Option angegebene Zeitspanne, wie lange die verringerte Gleichzeitigkeit bestehen bleiben muss, bevor die Anwendung herunterskaliert wird. Standardmäßig wird die Anwendung sofort verkleinert, wenn eine verminderte Gleichzeitigkeit festgestellt 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

Beta-Befehl

Code Engine beta-Befehle sind nicht allgemein verfügbar. Diese Befehlsgruppe bietet Zugang zu potenziellen zukünftigen Funktionen, die von ausgewählten Early Adopters leicht erkundet werden können.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie beta-Befehle verwenden können.

Um die CLI-Hilfe zu den Befehlen „ beta “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce beta -h “ aus.

ibmcloud ce beta

Code Engine beta-Befehle sind nicht allgemein verfügbar. Diese Befehlsgruppe bietet Zugang zu potenziellen zukünftigen Funktionen, die von ausgewählten Early Adopters leicht erkundet werden können.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie beta-Befehle verwenden können.

Um die CLI-Hilfe zu den Befehlen „ beta “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce beta -h “ aus.

ibmcloud ce beta COMMAND

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.

Befehle für einen Build (build)

Ein Build oder ein Image-Build ist ein Mechanismus, mit dem Sie ein Container-Image aus Ihrem Quellcode erstellen können. Code Engine unterstützt die Erstellung aus einer Dockerfile und Cloud Native Buildpacks. Mit build-Befehlen können Sie Buildkonfigurationen erstellen, anzeigen, aktualisieren und löschen. Nach dem Erstellen einer Buildkonfiguration können auf Basis dieser Buildkonfiguration buildrun-Befehle übergeben werden.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie build-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Builds finden Sie im Abschnitt Container-Image erstellen.

Sie können build oder bd in Ihren build-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für build-Befehle anzeigen möchten, führen Sie ibmcloud ce build -h aus.

ibmcloud ce build create

Build erstellen.

ibmcloud ce build create --name BUILD_NAME [--build-type BUILD_TYPE] [--commit COMMIT] [--context-dir CONTEXT_DIR] [--dockerfile DOCKERFILE] [--force] [--git-repo-secret GIT_REPO_SECRET] [--image IMAGE] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--size SIZE] [--source SOURCE] [--strategy STRATEGY] [--timeout TIMEOUT]

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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist erlaubt, wenn die Option --build-type git lautet und nicht erlaubt, wenn die Option --build-type local lautet. 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

Der Registrierungsschlüssel, der für den Zugriff auf die Registrierung verwendet wird. Sie können den Registrierungsschlüssel hinzufügen, indem Sie den Befehl „ registry create “ 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 Bewerbungen und Stellenangebote sind gültige Werte dockerfile und buildpacks. Bei Funktionen haben gültige Werte das Format „ codebundle-[RUNTIME-ID] “. Wenn Sie z. B. ein Code-Bundle für Ihre Funktion mit der Laufzeit-ID nodejs-24 erstellen möchten, verwenden Sie codebundle-nodejs-24 als Erstellungsstrategie. Sie können die ID jeder unterstützten Funktionslaufzeit ermitteln, 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

ibmcloud ce build delete

Build löschen.

ibmcloud ce build delete --name BUILD_NAME [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce build get

Details eines Builds anzeigen.

ibmcloud ce build get --name BUILD_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce build list

Alle Builds im Projekt auflisten.

ibmcloud ce build list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce build update

Build aktualisieren.

ibmcloud ce build update --name BUILD_NAME [--commit COMMIT] [--commit-clear] [--context-dir CONTEXT_DIR] [--dockerfile DOCKERFILE] [--force] [--git-repo-secret GIT_REPO_SECRET] [--git-repo-secret-clear] [--image IMAGE] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--size SIZE] [--source SOURCE] [--strategy STRATEGY] [--timeout TIMEOUT]

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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository 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 Bewerbungen und Stellenangebote sind gültige Werte dockerfile und buildpacks. Bei Funktionen haben gültige Werte das Format „ codebundle-[RUNTIME-ID] “. Wenn Sie z. B. ein Code-Bundle für Ihre Funktion mit der Laufzeit-ID nodejs-24 erstellen möchten, verwenden Sie codebundle-nodejs-24 als Erstellungsstrategie. Sie können die ID jeder unterstützten Funktionslaufzeit ermitteln, 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

Befehle für eine Buildausführung (buildrun)

Ein Build oder ein Image-Build ist ein Mechanismus, mit dem Sie ein Container-Image aus Ihrem Quellcode erstellen können. Code Engine unterstützt die Erstellung aus einer Dockerfile und Cloud Native Buildpacks. Mit buildrun-Befehlen können Sie Builds übergeben, Details anzeigen und Buildausführungen löschen.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie buildrun-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Builds und Buildausführungen finden Sie im Abschnitt Container-Image erstellen.

Sie können buildrun oder br in Ihren buildrun-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für buildrun-Befehle anzeigen möchten, führen Sie ibmcloud ce br -h aus.

ibmcloud ce buildrun cancel

Bricht die Ausführung eines Builds ab.

ibmcloud ce buildrun cancel --name BUILDRUN_NAME [--quiet]

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

Canceling build run 'mybuildrun'...
OK

ibmcloud ce buildrun delete

Buildausführung löschen.

ibmcloud ce buildrun delete (--name BUILDRUN_NAME | --build BUILD_NAME) [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce buildrun events

Zeigen Sie die Systemereignisse einer Buildausführung an. Systemereignisse werden bis zu 60 Minuten aufbewahrt.

ibmcloud ce buildrun events --buildrun BUILDRUN_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce buildrun get

Details einer Buildausführung anzeigen.

ibmcloud ce buildrun get --name BUILDRUN_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce buildrun list

Alle Buildausführungen im Projekt auflisten.

ibmcloud ce buildrun list [--build BUILD] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce buildrun logs

Die Protokolle einer Buildausführung anzeigen.

ibmcloud ce buildrun logs --buildrun BUILDRUN_NAME [--follow] [--output OUTPUT] [--quiet] [--raw] [--tail TAIL] [--timestamps]

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. Wenn diese Option nicht angegeben wird, werden alle Zeilen der Protokolle der Container des angegebenen Build-Laufs 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"}}

ibmcloud ce buildrun submit

Buildausführung übergeben.

ibmcloud ce buildrun submit (--build BUILD_NAME [--name NAME]) | (--name NAME [--commit COMMIT] [--context-dir CONTEXT_DIR] [--dockerfile DOCKERFILE] [--git-repo-secret GIT_REPO_SECRET] [--registry-secret REGISTRY_SECRET] [--size SIZE] [--strategy STRATEGY]) [--image IMAGE] [--no-wait] [--output OUTPUT] [--quiet] [--service-account SERVICE_ACCOUNT] [--source SOURCE] [--timeout TIMEOUT] [--wait] [--wait-timeout WAIT_TIMEOUT]

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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf 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 Option „ --build “ nicht gesetzt ist, und unzulässig, wenn die Option „ --build “ 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 Option „ --build “ nicht gesetzt ist, und unzulässig, wenn die Option „ --build “ 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 Bewerbungen und Stellenangebote sind gültige Werte dockerfile und buildpacks. Bei Funktionen haben gültige Werte das Format „ codebundle-[RUNTIME-ID] “. Wenn Sie z. B. ein Code-Bundle für Ihre Funktion mit der Laufzeit-ID nodejs-24 erstellen möchten, verwenden Sie codebundle-nodejs-24 als Erstellungsstrategie. Sie können die ID jeder unterstützten Funktionslaufzeit ermitteln, indem Sie den Befehl ibmcloud ce fn runtimes ausführen. Die Option „build strategy“ ist zulässig, wenn die Option „ --build “ nicht gesetzt ist, und nicht zulässig, wenn die Option „ --build “ gesetzt ist. Sofern nicht anders angegeben, wird die Build-Strategie von Code Engine bestimmt, wenn --source angegeben 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

Befehle für eine Konfigurationszuordnung (configmap)

Von einer Konfigurationszuordnung wird eine Methode zum Einschließen nicht sensibler Dateninformationen in die Bereitstellung bereitgestellt. Indem Sie Werte aus Ihrer ConfigMap als Umgebungsvariablen verwenden, können Sie bestimmte Informationen von Ihrem Deployment entkoppeln und die Portabilität Ihrer App, Ihres Jobs oder Ihrer Funktion gewährleisten. Eine Konfigurationszuordnung enthält die Informationen in Form von Schlüssel/Wert-Paaren. Mit configmap-Befehlen können Sie Konfigurationszuordnungen erstellen, anzeigen, aktualisieren und löschen.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie configmap-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Configmaps finden Sie unter Arbeiten mit Configmaps.

Sie können configmap oder cm in Ihren configmap-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für configmap-Befehle anzeigen möchten, führen Sie ibmcloud ce configmap -h aus.

ibmcloud ce configmap create

Konfigurationszuordnung erstellen.

ibmcloud ce configmap create --name CONFIGMAP_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE) [--output OUTPUT] [--quiet]

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
Beispielausgabe einer Konfigurationszuordnung mit Werten aus mehreren Dateien
Creating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

ibmcloud ce configmap delete

Konfigurationszuordnung löschen.

ibmcloud ce configmap delete --name CONFIGMAP_NAME [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce configmap get

Details einer Konfigurationszuordnung anzeigen.

ibmcloud ce configmap get --name CONFIGMAP_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce configmap list

Alle Konfigurationszuordnungen im Projekt auflisten.

ibmcloud ce configmap list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce configmap update

Konfigurationszuordnung aktualisieren.

ibmcloud ce configmap update --name CONFIGMAP_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE | --rm KEY) [--output OUTPUT] [--quiet]

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
Beispielausgabe einer Konfigurationszuordnung mit Werten aus einer Datei
Updating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

Konnektivitätsbefehle

Die Konnektivitätsfunktion IBM Cloud® Code Engine unterstützt Sie bei der Konfiguration verschiedener Aspekte der Netzwerkkonnektivität der Workloads in Ihrem Code Engine Projekt.

  • Definieren Sie erreichbare Endpunkte, indem Sie zulässige Ziel-IP-Adressbereiche für ausgehende Verbindungen angeben
  • Verbinden Sie sich mit IBM Cloud VPC Private Path Services.
  • Definieren Sie VPC-Subnetzpool-Referenzen einschließlich Sicherheitsgruppen, um die Netzwerkplatzierung Ihrer Code Engine Fleetworker zu konfigurieren.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie connectivity-Befehle verwenden können.

Sie können connectivity oder conn in Ihren connectivity-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für connectivity-Befehle anzeigen möchten, führen Sie ibmcloud ce connectivity -h aus.

ibmcloud ce connectivity outbound

Die Funktion IBM Cloud® Code Engine für ausgehende Verbindungen unterstützt die Definition erreichbarer Endpunkte für Ihre Code Engine Projekte.

  • Verwenden Sie für ausgehende Verbindungen zulässige Ziel-IP-Adressbereiche in CIDR-Notation.
  • Verbinden Sie Ihr Code Engine Projekt mit IBM Cloud VPC Private Path Services über die Code Engine Konsole oder CLI.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie connectivity outbound-Befehle verwenden können.

Weitere Informationen zum Arbeiten mit Befehlen zur ausgehenden Konnektivität finden Sie unter Arbeiten mit ausgehender Konnektivität in Code Engine.

Sie können connectivity outbound oder conn outbound in Ihren connectivity outbound-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für connectivity outbound-Befehle anzeigen möchten, führen Sie ibmcloud ce connectivity outbound -h aus.

ibmcloud ce connectivity outbound COMMAND

ibmcloud ce connectivity outbound create

Erstellen Sie ein zulässiges Ziel für ausgehende Verbindungen.

ibmcloud ce connectivity outbound create --name OUTBOUND_DESTINATION_NAME (--cidr CIDR_IP_ADDRESS | --pps-crn PPS_CRN) [--force] [--format FORMAT] [--pps-isolation-policy PPS_ISOLATION_POLICY] [--quiet]

Befehlsoptionen

--n, --cidr-name, --name
Erforderlich. Name des zulässigen ausgehenden Ziels. Dieser Wert ist erforderlich.
--cidr, -c
Geben Sie einen gültigen IP-Adressbereich im CIDR-Format an (z. B. 1.2.3.0/24). Dieser Wert ist optional.
--force, -f
Erstellung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.
--format, --fo
Format des zulässigen Zielorts für ausgehenden Datenverkehr. Gültige Werte sind [cidr, cidr_block, pps, private_path_gateway_service]. Wird kein Wert angegeben, ist der Standardwert cidr. Dieser Wert ist optional. Der Standardwert ist cidr_block.
--pps-crn, --private-path-service-crn
Geben Sie die CRN des Ziel-Private-Path-Service an, mit dem eine Verbindung hergestellt werden soll. Dieser Wert ist optional.
--pps-isolation-policy, --pip
Die Isolationsrichtlinie der Private-Path-Verbindung. Gültige Werte sind [„ dedicated “ und „ shared] “. Sofern nicht anders angegeben, lautet die Standardeinstellung „ shared “. Dieser Wert ist optional. Der Standardwert ist shared.
--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 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

ibmcloud ce connectivity outbound delete

Löschen Sie ein zulässiges ausgehendes Ziel.

ibmcloud ce connectivity outbound delete --name OUTBOUND_DESTINATION_NAME [--force] [--ignore-not-found] [--quiet]

Befehlsoptionen

--n, --cidr-name, --name
Erforderlich. Name des zulässigen ausgehenden Ziels. 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 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

ibmcloud ce connectivity outbound get

Zeigen Sie die Details eines zulässigen ausgehenden Ziels an.

ibmcloud ce connectivity outbound get --name OUTBOUND_DESTINATION_NAME [--output OUTPUT] [--quiet]

Befehlsoptionen

--n, --cidr-name, --name
Erforderlich. Name des zulässigen ausgehenden Ziels. 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 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

ibmcloud ce connectivity outbound list

Listen Sie alle zulässigen ausgehenden Ziele auf.

ibmcloud ce connectivity outbound list [--format FORMAT] [--output OUTPUT] [--quiet]

Befehlsoptionen

--format
Beschränken Sie die Anzeige zulässiger ausgehender Ziele auf ein bestimmtes Format. Geben Sie ein oder mehrere Formate in einer kommagetrennten Liste an. Gültige Werte sind [cidr, cidr_block, pps, private_path_gateway_service]. Dieser Wert ist optional. Der Standardwert ist cidr_block,private_path_service_gateway.
--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 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

ibmcloud ce connectivity outbound update

Aktualisieren Sie ein zulässiges Ziel für ausgehende Verbindungen.

ibmcloud ce connectivity outbound update --name OUTBOUND_DESTINATION_NAME (--cidr CIDR_IP_ADDRESS | --pps-isolation-policy PPS_ISOLATION_POLICY) [--force] [--quiet]

Befehlsoptionen

--n, --cidr-name, --name
Erforderlich. Name des zulässigen ausgehenden Ziels. Dieser Wert ist erforderlich.
--cidr, -c
Geben Sie einen gültigen IP-Adressbereich im CIDR-Format an (z. B. 1.2.3.0/24). Dieser Wert ist optional.
--force, -f
Aktualisierung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.
--pps-isolation-policy, --pip
Die Isolationsrichtlinie der Private-Path-Verbindung. Gültige Werte sind [„ dedicated “ und „ shared] “. 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 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

ibmcloud ce connectivity subnetpool

Die Funktion IBM Cloud® Code Engine für Subnetzpool-Verbindungen unterstützt die Verwaltung von VPC-Subnetzpool-Referenzen, einschließlich Sicherheitsgruppen. Flotten sind immer mit einer VPC verbunden, und bei der Erstellung einer Flotte kann auf einen Subnetzpool verwiesen werden, um festzulegen, in welcher Netzwerkzone die Mitarbeiter der Code Engine Flotte eingesetzt werden. Sie erstellen einen Subnetz-Pool, um die VPC-Subnetze und Verfügbarkeitszonen anzugeben, in denen Ihr Workload verarbeitet werden soll. Sie können zum Beispiel einen Subnetz-Pool mit einem einzelnen Subnetz in der Zone eu-de-1 oder einen Subnetz-Pool mit mehreren Subnetzen für alle 3 Zonen in eu-de erstellen. Darüber hinaus können Sie die Sicherheitsgruppe angeben, der Ihr Workload zugeordnet werden soll.

Bei IBM Cloud® Virtual Private Cloud (VPC) handelt es sich um ein virtuelles Netz, das mit Ihrem Kundenkonto verknüpft ist. Das Produkt bietet Ihnen Cloudsicherheit und die Möglichkeit zur dynamischen Skalierung Ihres Systems, die durch die Bereitstellung fein abgestimmter Steuerungsinstrumente für Ihre virtuelle Infrastruktur und die Segmentierung Ihres Netzdatenverkehrs erreicht wird. Subnetze in Ihrer VPC bieten private Konnektivität. Teilnetze in Ihrer VPC-Instanz können über ein optionales öffentliches Gateway eine Verbindung zum öffentlichen Internet herstellen. Sie können die Sicherheit Ihrer VPC und Ihrer Workloads gewährleisten, indem Sie den Netzwerkverkehr mithilfe von Sicherheitsgruppen steuern. Weitere Informationen finden Sie unter Über Netzwerke und Sicherheit in Ihrer VPC.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie connectivity subnetpool-Befehle verwenden können.

Weitere Informationen zum Arbeiten mit Subnetzpool-Konnektivitätsbefehlen finden Sie unter Arbeiten mit Subnetzpool-Konnektivität in Code Engine.

Sie können connectivity oder conn in Ihren connectivity subnetpool-Befehlen verwenden. Um die CLI-Hilfe für die Befehle connectivity subnetpool anzuzeigen, führen Sie ibmcloud ce connectivity subnetpool -h aus.

ibmcloud ce connectivity subnetpool COMMAND

ibmcloud ce connectivity subnetpool create

Erstellen Sie einen Subnetzpool.

ibmcloud ce connectivity subnetpool create [--name NAME] [--quiet] [--security-group-crn SECURITY_GROUP_CRN] [--subnet-crn SUBNET_CRN]

Befehlsoptionen

--name, -n
Erforderlich. Name des Subnetzpools. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist. Dieser Wert ist erforderlich.
--subnet-crn, --crn
Geben Sie eine gültige Subnetz-CRN für den Pool an. Muss im Format S1=crn:v1:example vorliegen. 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.
--security-group-crn, --sg-crn
Geben Sie eine gültige CRN für die Sicherheitsgruppe für den Pool an. Dieser Wert ist optional.

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'

ibmcloud ce connectivity subnetpool delete

Löschen Sie einen Subnetzpool.

ibmcloud ce connectivity subnetpool delete (--name SUBNET_POOL_NAME || --id SUBNET_POOL_ID) [--force] [--ignore-not-found] [--quiet]

Befehlsoptionen

--force, -f
Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.
--id
ID des Subnetzpools. Dieser Wert ist optional.
--ignore-not-found, --inf
Falls nicht gefunden, nicht fehlschlagen. Dieser Wert ist optional. Der Standardwert ist false.
--name, -n
Name des Subnetzpools. 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 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

ibmcloud ce connectivity subnetpool get

Details eines Subnetzpools anzeigen.

ibmcloud ce connectivity subnetpool get (--id SUBNET_POOL_ID || --name SUBNET_POOL_NAME) [--output OUTPUT] [--quiet]

Befehlsoptionen

--id
ID des Subnetzpools. Dieser Wert ist optional.
--name, -n
Name des Subnetzpools. Dieser Wert ist optional.
--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 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

ibmcloud ce connectivity subnetpool list

Listen Sie alle Subnetzpools in einem Projekt auf.

ibmcloud ce connectivity subnetpool list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

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

Domainmapping-Befehle

Domain-Zuordnungen stellen die Route URL zu Ihren Code Engine-Anwendungen und -Funktionen innerhalb eines Projekts bereit. Bei „ Code Engine “ werden diese Zuordnungen standardmäßig automatisch erstellt, sobald Sie eine Anwendung bereitstellen oder eine Funktion erstellen. Sie können jedoch Ihre eigene benutzerdefinierte Domain einer „ Code Engine “-Anwendung oder -Funktion zuordnen, um Anfragen von Ihrer benutzerdefinierten URL mithilfe von Code Engine an Ihre Anwendung oder Funktion weiterzuleiten. Verwenden Sie die Befehle „ domainmapping “, um Domänenzuordnungen zu erstellen, deren Details anzuzeigen, sie zu aktualisieren und zu löschen.

Wenn Sie eine benutzerdefinierte Domänenzuordnung in Code Engine festlegen, definieren Sie eine 1-to-1 Zuordnung zwischen Ihrem voll qualifizierten Domänennamen (FQDN) und einer Code Engine Anwendung in Ihrem Projekt. Zum Konfigurieren und Arbeiten mit benutzerdefinierten Domänenzuordnungen in der CLI verwenden Sie die Befehle domainmapping.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie domainmapping-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Domänenzuordnungen finden Sie unter Konfigurieren von benutzerdefinierten Domänenzuordnungen für Ihre Anwendung.

Sie können domainmapping oder dm in Ihren domainmapping-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für domainmapping-Befehle anzeigen möchten, führen Sie ibmcloud ce domainmapping -h aus.

ibmcloud ce domainmapping create

Erstellen Sie eine angepasste Domänenzuordnung.

ibmcloud ce domainmapping create --domain-name DOMAIN_NAME [--target-type TARGET_TYPE] --tls-secret SECRET_NAME [--quiet]

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 einen „ TLS “-Schlüssel an, der das Zertifikat einschließlich aller dazwischenliegenden Zertifikate sowie 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

Das folgende Beispiel erstellt eine benutzerdefinierte Domänenzuordnung zwischen der Anwendung Code Engine myapp und der benutzerdefinierten Domäne www.example.com und verwendet das Geheimnis TLS, mytlssecret.

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

Beispielausgabe

OK
Domain mapping successfully created.

ibmcloud ce domainmapping delete

Löschen Sie eine angepasste Domänenzuordnung.

ibmcloud ce domainmapping delete --domain-name DOMAIN_NAME [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce domainmapping get

Zeigen Sie die Details einer angepassten Domänenzuordnung an.

ibmcloud ce domainmapping get --domain-name DOMAIN_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce domainmapping list

Listen Sie Domänenzuordnungen in einem Projekt auf.

ibmcloud ce domainmapping list [--all] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

Im folgenden Beispiel wird eine Liste aller benutzerdefinierten Domänenzuordnungen angezeigt.

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

Um eine Liste aller Domänenzuordnungen für Ihre Anwendungen anzuzeigen, einschließlich der benutzerdefinierten Domänenzuordnungen und aller automatisch generierten Systemdomänenzuordnungen, geben Sie die Option --all mit dem Befehl ibmcloud ce domainmapping list befehl an.

ibmcloud ce domainmapping update

Aktualisieren Sie eine angepasste Domänenzuordnung.

ibmcloud ce domainmapping update --domain-name DOMAIN_NAME --target TARGET_NAME --tls-secret SECRET_NAME [--quiet] [--target-type TARGET_TYPE]

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 einen „ TLS “-Schlüssel an, der das Zertifikat einschließlich aller dazwischenliegenden Zertifikate sowie 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

Das folgende Beispiel aktualisiert die www.example.com-Domänenzuordnung, um mytlssecret2 anstelle von mytlssecret zu verwenden.

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

Beispielausgabe

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

Experimenteller Befehl

Code Engine experimentelle Befehle sind nicht allgemein verfügbar. Diese Befehlsgruppe bietet Zugang zu potenziellen zukünftigen Funktionen, die von ausgewählten Early Adopters leicht erkundet werden können.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie experimental-Befehle verwenden können.

Sie können experimental oder exp in Ihren experimental-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für experimental-Befehle anzeigen möchten, führen Sie ibmcloud ce exp -h aus.

ibmcloud ce experimental

Code Engine experimentelle Befehle sind nicht allgemein verfügbar. Diese Befehlsgruppe bietet Zugang zu potenziellen zukünftigen Funktionen, die von ausgewählten Early Adopters leicht erkundet werden können.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie experimental-Befehle verwenden können.

Sie können experimental oder exp in Ihren experimental-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für experimental-Befehle anzeigen möchten, führen Sie ibmcloud ce exp -h aus.

ibmcloud ce experimental COMMAND

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.

Flottenkommandos

Verwalten Sie serverlose Flotten.

ibmcloud ce fleet cancel

Eine serverlose Flotte stornieren.

ibmcloud ce fleet cancel --id FLEET_ID [--force] [--hard] [--quiet]

Befehlsoptionen

--id, --fid, --fleet-id
Erforderlich. Die ID der serverlosen Flotte. Dieser Wert ist erforderlich.
--force, -f
Stornierung ohne vorherige Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.
--hard
Die serverlose Flotte einschließlich der Aufgaben im Status „ running “ sofort stornieren. Wenn Sie die Option „ hard “ nicht angeben, wird die Verarbeitung von Aufgaben im Status „ running “ fortgesetzt, bis diese einen Endstatus erreichen; erst dann wechselt die Flotte in den Status „ 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

ibmcloud ce fleet create

Starten Sie einen serverlosen Fleet.

ibmcloud ce fleet create --image IMAGE_REF --tasks-state-store TASKS_STATE_STORE (--subnetpool-name SUBNETPOOL_NAME | --subnetpool-id SUBNETPOOL_ID) (--tasks TASKS | --tasks-from-local-file TASKS_FROM_LOCAL_FILE | --tasks-from-cos-object TASKS_FROM_COS_OBJECT | --tasks-from-cos-bucket TASKS_FROM_COS_BUCKET) [--argument ARGUMENT] [--command COMMAND] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--gpu GPU] [--max-scale MAX_SCALE] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mount-data-store MOUNT_DATA_STORE] [--name NAME] [--quiet] [--registry-secret REGISTRY_SECRET] [--retrylimit RETRYLIMIT] [--task-indexes TASK_INDEXES] [--worker-profile WORKER_PROFILE]

Befehlsoptionen

--image, -i
Erforderlich. Der Name des Container-Images, das zur Verarbeitung der Tasks 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, der den Status der Tasks der Flotte speichert. Dieser Wert ist erforderlich.
--argument, --arg, -a
Legen Sie die Befehlsargumente fest, die der Befehl benötigt, um in der Task ausgeführt zu werden. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.
--command, --cmd, -c
Legen Sie einen Befehl fest, der in der Task 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
Legen Sie die Umgebungsvariablen fest, die in die Task übergeben werden sollen. Muss das Format NAME=WERT haben. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.
--env-from-configmap, --env-cm
Lege Umgebungsvariablen anhand der Schlüssel-Wert-Paare fest, die in diesem ConfigMap 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
Lege Umgebungsvariablen anhand der Schlüssel-Wert-Paare fest, die in diesem Secret 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. Der Standardwert für NUMBER_OF_GPUS ist 1, und er kann auch ein Bruch sein. Zum Beispiel: h100:0.5 Dieser Wert ist optional.
--max-scale, --maxscale, --max
Maximale Anzahl der gleichzeitig auszuführenden Taskinstanzen. Dieser Wert ist optional. Der Standardwert ist 1.
--maxexecutiontime, --met
Die maximale Ausführungszeit in Sekunden, die für die Ausführung einer Task zur Verfügung steht. 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]. 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 den Befehl „ ibmcloud ce registry create “ aus, um einen Registrierungs-Secret zu erstellen. Dieser Wert ist optional.
--retrylimit, -r
Die Anzahl der Wiederholungsversuche für eine Task, 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 Platzierung des Flottennetzwerks verwendet werden soll. Dieser Wert ist optional.
--task-indexes, --ti
Geben Sie die zu verarbeitenden Aufgabenindizes 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 „ --tasks “ angegeben ist. Dieser Wert ist optional.
--tasks, --ts
Geben Sie die Anzahl der Tasks an, die von der Flotte verarbeitet werden sollen. Wird keine Option zur Aufgabenspezifikation angegeben, wird diese Option mit dem Standardwert „ 1 “ verwendet.
--tasks-from-cos-bucket, --ts-bucket
Geben Sie den Speicherort der Dateien innerhalb eines COS-Buckets an. Für jede Datei müssen die Tasks von der Flotte bearbeitet werden. 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 Tasks, die von der Flotte bearbeitet werden sollen. Dieser Wert ist optional.
--tasks-from-local-file, --ts-file
Geben Sie den Speicherort einer lokalen JSONL-Datei an. Die Datei definiert Tasks, die von der Flotte bearbeitet werden sollen. Dieser Wert ist optional.
--worker-profile, --profile, --prof
Geben Sie eine unterstützte Worker-Profilpräferenz an. Dieser Wert ist optional.

Beispiel

ibmcloud ce fleet create --image icr.io/codeengine/helloworld --subnetpool-name my-pool --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

ibmcloud ce fleet delete

Löschen Sie eine serverlose Flotte.

ibmcloud ce fleet delete --id FLEET_ID [--force] [--ignore-not-found] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

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 wird, 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

ibmcloud ce fleet get

Anzeige von Details zu einem serverlosen Fleet.

ibmcloud ce fleet get --id FLEET_ID [--output OUTPUT] [--quiet]

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 pools:    
    Name:                my-pool-
    Number of subnets:   1  
                         
    Subnet CRN:          crn:v1:bluemix:public:is:eu-de-1: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  
Environment Variables:    
  Type     Name   Value  
  Literal  FOO    bar

ibmcloud ce fleet list

Listen Sie alle serverlosen Fleets in einem Projekt auf.

ibmcloud ce fleet list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce fleet task

Verwalten Sie serverlose Flotten-Tasks.

ibmcloud ce fleet task COMMAND [--quiet]

Befehlsoptionen

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

ibmcloud ce fleet task get

Anzeige von Details zu einer serverlosen Fleet-Task.

ibmcloud ce fleet task get --task-id TASK_ID --fleet-id FLEET_ID [--output OUTPUT] [--quiet]

Befehlsoptionen

--fleet-id, --fid
Erforderlich. Die UUID der Flotte, zu der die Task gehört. Dieser Wert ist erforderlich.
--task-id, --tid, --id
Erforderlich. Die UUID der Task. 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 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

ibmcloud ce fleet task list

Listen Sie alle Tasks einer serverlosen Flotte auf.

ibmcloud ce fleet task list --fleet-id FLEET_ID [--output OUTPUT] [--pagination-token PAGINATION_TOKEN] [--quiet] [--show-all-columns] [--sort-by SORT_BY] [--status STATUS]

Befehlsoptionen

--fleet-id, --fid
Erforderlich. Die UUID der Flotte, zu der die Tasks gehören. 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.
--pagination-token, --pt
Zeigen Sie die nächste Seite der Tasks an, beginnend mit diesem Paginierungs-Token. 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-columns, --sac
Zeigen Sie die zusätzlichen Spalten „ Created “ und „ Finished “ an. Dieser Wert ist optional. Der Standardwert ist false.
--sort-by, --sb
Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind id, index und status. Dieser Wert ist optional. Der Standardwert ist index.
--status, --st
Zeigen Sie Tasks mit dem angegebenen Status an. Gültige Werte sind canceled, failed, pending, running und succeeded. Dieser Wert ist optional.

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

ibmcloud ce fleet worker

Verwalten Sie serverlose Flotten-Worker.

ibmcloud ce fleet worker COMMAND [--quiet]

Befehlsoptionen

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

ibmcloud ce fleet worker delete

Löschen Sie einen serverlosen Fleet-Worker.

ibmcloud ce fleet worker delete --name WORKER_NAME --fleet-id FLEET_ID [--force] [--hard] [--ignore-not-found] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--fleet-id, --fid
Erforderlich. Die ID der Flotte, der der Worker angehört. Dieser Wert ist erforderlich.
--name, -n, --worker-name
Erforderlich. Der Name des serverlosen Fleet-Workers. Dieser Wert ist erforderlich.
--force, -f
Löschung ohne Bestätigung erzwingen. Dieser Wert ist optional. Der Standardwert ist false.
--hard
Löschen Sie den serverlosen Flotten-Worker unverzüglich. Wenn Sie die Option 'hard' nicht angeben, wird die Bearbeitung der von diesem Worker verarbeiteten Tasks im Status 'running' fortgesetzt, bis diese Tasks einen Endstatus erreichen; erst dann wird der Worker gelöscht. 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 den serverlosen Fleet-Worker und warten Sie, bis der Worker gelöscht wird. Dieser Wert ist optional. Der Standardwert ist false.
--wait-timeout, --wto
Die Zeit in Sekunden, die gewartet wird, bis der serverlose Fleet-Worker gelöscht wird. Dieser Wert ist optional. Der Standardwert ist 180.

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

ibmcloud ce fleet worker get

Anzeige von Details zu einem serverlosen Fleet-Worker.

ibmcloud ce fleet worker get --name WORKER_NAME --fleet-id FLEET_ID [--output OUTPUT] [--quiet]

Befehlsoptionen

--fleet-id, --fid
Erforderlich. Die ID der Flotte, der der Worker angehört. Dieser Wert ist erforderlich.
--name, -n, --worker-name
Erforderlich. Der Name des serverlosen Fleet-Workers. 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 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

ibmcloud ce fleet worker list

Listen Sie alle Worker einer serverlosen Flotte auf.

ibmcloud ce fleet worker list --fleet-id FLEET_ID [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Befehlsoptionen

--fleet-id, --fid, --id
Erforderlich. Die ID der Flotte, der der Worker angehört. 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.
--sort-by, -s
Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name und status. Dieser Wert ist optional. Der Standardwert ist name.

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

ibmcloud ce fleet worker profiles

Listen Sie die unterstützten Worker-Profile für serverlose Flotten auf.

ibmcloud ce fleet worker profiles [--output OUTPUT] [--profile-family PROFILE_FAMILY] [--quiet] [--region REGION] [--sort-by SORT_BY]

Befehlsoptionen

--output, -o
Ausgabeformat. Gültige Werte sind „json“, „yaml“, „jsonpath=JSONPATH_EXPRESSION“ und „jsonpath-as-json=JSONPATH_EXPRESSION“. Dieser Wert ist optional.
--profile-family, --pf
Zeigen Sie Profile an, die zur angegebenen Worker-Profilfamilie gehören. Gültige Werte sind [b, balanced, c, compute, m, memory, g, gpu, f, flex]. 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.
--region, -r
Worker-Profile anzeigen, die in der angegebenen Region unterstützt werden. Dieser Wert ist optional.
--sort-by, -s
Gibt die Spalte an, nach der die Liste sortiert werden soll. Gültige Werte sind name, cpu, disk und memory. Dieser Wert ist optional. Der Standardwert ist name.

Beispiel

ibmcloud ce fleet worker profiles --profile-family --region br-sao

Beispielausgabe

Listing fleet worker profiles...
OK
Name                 CPU  Memory  Disk  GPU family  Region  
gx2-8x64x1v100       8    64Gi    0     v100        br-sao  
gx2-32x256x2v100     32   256Gi   0     v100        br-sao  
gx3-48x240x2l40s     48   240Gi   0     l40s        br-sao  
gx3-64x320x4l4       64   320Gi   0     l4          br-sao  
gx3d-160x1792x8h100  160  1792Gi  60Ti  h100        br-sao

Funktionsbefehle

Eine Funktion ist ein zustandsloser Codeschnipsel, der Aufgaben ausführt, wenn er von HTTP Anfragen aufgerufen wird. Mit IBM Code Engine Funktionen können Sie Ihre Geschäftslogik auf skalierbare und serverlose Weise ausführen. IBM Code Engine funktionen bieten eine optimierte Laufzeitumgebung für niedrige Latenzzeiten und schnelle Scale-out-Szenarien. Ihr Funktionscode kann in einer verwalteten Laufzeitumgebung geschrieben werden, die bestimmte Node.js oder Python Versionen enthält.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie function-Befehle verwenden können.

Weitere Informationen zum Arbeiten mit Funktionen finden Sie unter Arbeiten mit Funktionen.

ibmcloud ce function bind

Eine Instanz des „ IBM Cloud “-Dienstes an eine Funktion binden.

ibmcloud ce function bind --name FUNCTION_NAME (--service-instance SI_NAME | --service-instance-id SI_ID) [--no-wait] [--prefix PREFIX] [--quiet] [--role ROLE] [--service-credential SERVICE_CREDENTIAL] [--wait] [--wait-timeout WAIT_TIMEOUT]

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 Befehl „ function get “, 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 an die Funktion gebunden werden soll. Dieser Wert ist optional.
--service-instance-id, --siid
Die GUID einer vorhandenen „ IBM Cloud “-Dienstinstanz, die an die Funktion 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 Funktion „bind“ maximal so viele Sekunden, wie durch die Option „ --wait-timeout “ festgelegt sind, bis der Vorgang erfolgreich abgeschlossen ist. Wenn die Funktion „bind“ nicht erfolgreich abgeschlossen wird oder innerhalb des angegebenen Zeitraums „ --wait-timeout “ 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

ibmcloud ce function create

Erstellen Sie eine Funktion.

ibmcloud ce function create --name FUNCTION_NAME [--build-commit BUILD_COMMIT] [--build-context-dir BUILD_CONTEXT_DIR] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-source BUILD_SOURCE] [--build-timeout BUILD_TIMEOUT] [--code-bundle CODE_BUNDLE] [--code-bundle-secret CODE_BUNDLE_SECRET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--force] [--inline-code INLINE_CODE] [--main MAIN] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--no-wait] [--output OUTPUT] [--quiet] [--runtime RUNTIME] [--scale-down-delay SCALE_DOWN_DELAY] [--trusted-profiles-enabled] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

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. Um unterstützte Laufzeiten für diese Region zu finden, führen Sie ibmcloud ce function runtimes aus. 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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf 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 Bildes, das für diese Funktion verwendet werden soll. Wenn „ build-source “ angegeben wird, ist dieser Wert der Pfad zu dem durch den Build-Push erzeugten Ausgabebild. Wenn „ build-source “ nicht angegeben ist, entspricht dieser Wert dem 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 Befehl „ registry create “ 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 anhand der in diesem ConfigMap gespeicherten Schlüssel-Wert-Paare auf eine der folgenden Weisen fest.

  • 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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 Ihrer Funktion enthält. Der Code ist direkt in der Funktion enthalten. 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 Speichermenge. 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 erhalten? 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 „ private “ lauten, wenn das Projekt die Sichtbarkeitsebene „private“ 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 „ ibmcloud ce fn get -n 'myfunction' “ ausführen, um den Funktionsstatus zu überprüfen, wird die „ URL “ für Ihre Funktion angezeigt.

ibmcloud ce function delete

Löschen Sie eine Funktion.

ibmcloud ce function delete --name FUNCTION_NAME [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce function get

Zeigen Sie die Details einer Funktion an.

ibmcloud ce function get --name FUNCTION_NAME [--output OUTPUT] [--quiet] [--save SAVE]

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-22
  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-22 (managed)
  Bundle Secret:  ce-auto-icr-private-us-south  
  Code Bundle:    cr://icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla
  Main:           main()

ibmcloud ce function list

Listen Sie alle Funktionen in einem Projekt auf.

ibmcloud ce function list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce function runtimes

Verfügbare Funktionslaufzeiten auflisten.

ibmcloud ce function runtimes [--all] [--output OUTPUT] [--quiet]

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 22   nodejs-22    nodejs  true
Node.js 24   nodejs-24    nodejs  false
Python 3.13  python-3.13  python  false

ibmcloud ce function unbind

Die Instanzen des Dienstes „ IBM Cloud “ von einer Funktion trennen.

ibmcloud ce function unbind --name FUNCTION_NAME (--binding BINDING_NAME | --all) [--quiet]

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

ibmcloud ce function update

Aktualisiert eine Funktion.

ibmcloud ce function update --name FUNCTION_NAME [--build-clear] [--build-commit BUILD_COMMIT] [--build-commit-clear] [--build-context-dir BUILD_CONTEXT_DIR] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-git-repo-secret-clear] [--build-source BUILD_SOURCE] [--build-timeout BUILD_TIMEOUT] [--code-bundle CODE_BUNDLE] [--code-bundle-secret CODE_BUNDLE_SECRET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--force] [--inline-code INLINE_CODE] [--main MAIN] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--no-wait] [--output OUTPUT] [--quiet] [--rebuild] [--runtime RUNTIME] [--scale-down-delay SCALE_DOWN_DELAY] [--trusted-profiles-enabled] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

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 zulässig, wenn Ihrer Funktion derzeit ein 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. 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 Ihre Funktion derzeit einen zugehörigen Build hat. 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 gesetzt ist. Dieser Wert ist optional.

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

Der Name des SSH-Schlüssels, der 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 Ihre Funktion derzeit ein zugehöriges Build hat. 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 Bildes, das für diese Funktion verwendet werden soll. Wenn „ build-source “ angegeben wird, ist dieser Wert der Pfad zu dem durch den Build-Push erzeugten Ausgabebild. Wenn „ build-source “ nicht angegeben ist, entspricht dieser Wert dem 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 Befehl „ registry create “ 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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 ist direkt in der Funktion enthalten. 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 Speichermenge. 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

Stellen Sie das Image aus dem Quellcode wieder her. Die Option „Neu erstellen“ ist nur zulässig, wenn für Ihre Funktion derzeit ein zugehöriger Build vorhanden ist. Dieser Wert ist optional. Der Standardwert ist false.

--runtime, -r

Die für die Funktion zu verwendende Laufzeit. Um unterstützte Laufzeiten für diese Region zu finden, führen Sie ibmcloud ce function runtimes aus. 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 erhalten? 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 „ private “ lauten, wenn das Projekt die Sichtbarkeitsebene „private“ 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-22 --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.

help (Befehl)

Der Befehl Code Engine help liefert Informationen über die verfügbaren Befehle pro Befehlsgruppe.

ibmcloud ce help

Der Befehl Code Engine help liefert Informationen über die verfügbaren Befehle pro Befehlsgruppe.

ibmcloud ce help COMMAND

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.

Jobbefehle

Ein Job führt eine oder mehrere Instanzen Ihres ausführbaren Codes parallel aus. Im Gegensatz zu Anwendungen, die HTTP-Anforderungen verarbeiten, sind Jobs so konzipiert, dass sie einmal ausgeführt werden und den Vorgang beenden. Wenn Sie einen Job erstellen, können Sie Informationen für die Workloadkonfiguration angeben, die bei jeder Ausführung des Jobs verwendet werden. Verwenden Sie job-Befehle zum Erstellen einer Konfiguration für einen Job.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie job-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Jobs finden Sie unter Jobs ausführen.

Um die CLI-Hilfe zu den Befehlen „ job “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce job -h “ aus.

ibmcloud ce job bind

Binden einer IBM Cloud-Serviceinstanz an einen Job.

ibmcloud ce job bind --name JOB_NAME (--service-instance SI_NAME | --service-instance-id SI_ID) [--no-wait] [--prefix PREFIX] [--quiet] [--role ROLE] [--service-credential SERVICE_CREDENTIAL] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

ibmcloud ce job create

Erstellen Sie einen Job.

ibmcloud ce job create --name JOB_NAME ((--image IMAGE_REF | (--build-source SOURCE [--image IMAGE_REF])) [--argument ARGUMENT] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--build-commit BUILD_COMMIT] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-size BUILD_SIZE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--command COMMAND] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-secret MOUNT_SECRET] [--no-wait] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

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-indexes, --array-indices, --ai

Gibt die Array-Indizes an, die für die Durchläufe des Jobs verwendet werden, zum Beispiel 0,3,6,9, 1-5,7-8,10. Die Ergebnismenge der Indizes ist auf 1000 Einträge begrenzt. Diese Option kann nur angegeben werden, wenn „ array-size “ 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 die Werte in Array-Indizes. Wenn Sie beispielsweise „ instances “ von „ 5 “ angeben, wandelt das System dies in „ array-indexes “ von „ 0 - 4 “ um. Diese Option kann nur angegeben werden, wenn die Option „ --array-indexes “ 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 erlaubt, wenn die Option --build-source auf 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 build context directory ist nur zulässig, wenn die Option --build-source gesetzt 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 Option --build-source gesetzt 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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist nur zulässig, wenn die Option --build-source auf 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 build size ist nur zulässig, wenn die Option --build-source gesetzt 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 strategy ist nur zulässig, wenn die Option --build-source gesetzt ist. Sofern nicht anders angegeben, wird die Build-Strategie von Code Engine bestimmt, wenn --build-source angegeben 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 build timeout ist nur zulässig, wenn die Option --build-source gesetzt 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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 “ auf „ task “ gesetzt ist. 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 Modus „ task “ gelten die Optionen „ maxexecutiontime “ und „ retrylimit “. Im Modus „ daemon “ sind die Optionen „ --maxexecutiontime “ und „ --retrylimit “ nicht zulässig, da es kein Timeout gibt und ausgefallene Instanzen unbegrenzt neu gestartet werden. Dieser Wert ist optional. Der Standardwert lautet „ 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]. 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 gesetzt 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 “ auf „ task “ gesetzt ist. 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 gesetzt 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 gesetzt 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

ibmcloud ce job delete

Job und zugehörige Jobausführungen löschen.

ibmcloud ce job delete --name JOB_NAME [--force] [--ignore-not-found] [--orphan-job-runs] [--quiet]

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 Befehl ibmcloud ce job delete ausführen, um einen Job zu löschen, werden auch alle übergebenen Jobausführungen gelöscht, von denen auf diesen Job verwiesen wird.

ibmcloud ce job get

Details eines Jobs anzeigen.

ibmcloud ce job get --name JOB_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce job list

Alle Jobs im Projekt auflisten.

ibmcloud ce job list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

ibmcloud ce job unbind

Bindung von IBM Cloud-Serviceinstanzen eines Jobs aufheben, um vorhandene Servicebindungen zu entfernen.

ibmcloud ce job unbind --name JOB_NAME (--binding BINDING_NAME | --all) [--quiet]

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

ibmcloud ce job update

Job aktualisieren.

ibmcloud ce job update --name JOB_NAME [--argument ARGUMENT] [--arguments-clear] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--build-clear] [--build-commit BUILD_COMMIT] [--build-commit-clear] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-git-repo-secret-clear] [--build-size BUILD_SIZE] [--build-source BUILD_SOURCE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--command COMMAND] [--commands-clear] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--image IMAGE] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-rm MOUNT_RM] [--mount-secret MOUNT_SECRET] [--no-wait] [--output OUTPUT] [--quiet] [--rebuild] [--registry-secret REGISTRY_SECRET] [--registry-secret-clear] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--service-account-clear] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

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-indexes, --array-indices, --ai

Gibt die Array-Indizes an, die für die Durchläufe des Jobs verwendet werden, zum Beispiel 0,3,6,9, 1-5,7-8,10. Die Ergebnismenge der Indizes ist auf 1000 Einträge begrenzt. Diese Option kann nur angegeben werden, wenn „ array-size “ 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 die Werte in Array-Indizes. Wenn Sie beispielsweise „ instances “ von „ 5 “ angeben, wandelt das System dies in „ array-indexes “ von „ 0 - 4 “ um. Diese Option kann nur angegeben werden, wenn die Option „ --array-indexes “ 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 zulässig, wenn Ihrem Auftrag derzeit ein 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 Option „ --build-source “ auf den URL eines Git-Repositorys in diesem job update-Befehl gesetzt ist oder Ihrem Job derzeit ein Build aus einer Git-Repositoryquelle zugeordnet ist. 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 Ihrem Job derzeit ein Build zugeordnet ist. 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 bei diesem Befehl „ job update “ die Option „ --build-source “ gesetzt ist oder Ihrem Job 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. Um dieses SSH-Geheimnis zu erstellen, verwenden Sie den Befehl secret create --format SSH. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Diese Option ist nur zulässig, wenn die Option „ --build-source “ auf den URL eines Git-Repositorys in diesem job update-Befehl gesetzt ist oder Ihrem Job derzeit ein Build aus einer Git-Repository-Quelle zugeordnet ist. 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 Ihrem Auftrag derzeit ein Build zugeordnet ist. 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 bei diesem Befehl „ job update “ die Option „ --build-source “ gesetzt 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 bei diesem Befehl „ job update “ die Option „ --build-source “ gesetzt ist oder Ihrem Job 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 bei diesem Befehl „ job update “ die Option „ --build-source “ gesetzt 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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 “ auf „ task “ gesetzt ist. 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 Modus „ task “ gelten die Optionen „ maxexecutiontime “ und „ retrylimit “. Im Modus „ daemon “ sind die Optionen „ --maxexecutiontime “ und „ --retrylimit “ nicht zulässig, da es kein Timeout gibt und ausgefallene 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]. 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 „ohne Wartezeit“ ist nur zulässig, wenn die Option „ --build-source “ für diesen Befehl „ job update “ gesetzt 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 für Ihren Auftrag derzeit ein zugehöriger Build vorhanden 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.

--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 “ auf „ task “ gesetzt ist. 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 „wait“ ist nur zulässig, wenn die Option „ --build-source “ für diesen Befehl „ job update “ gesetzt ist oder Ihrem Job 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

Befehle für eine Jobausführung (jobrun)

Ein Job führt eine oder mehrere Instanzen Ihres ausführbaren Codes parallel aus. Im Gegensatz zu Anwendungen, die HTTP-Anforderungen verarbeiten, sind Jobs so konzipiert, dass sie einmal ausgeführt werden und den Vorgang beenden. Wenn Sie einen Job erstellen, können Sie Informationen für die Workloadkonfiguration angeben, die bei jeder Ausführung des Jobs verwendet werden. Verwenden Sie die jobrun-Befehle zur Jobausführung, um Instanzen des Jobs auszuführen.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie jobrun-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Jobs und Jobausführungen finden Sie unter Jobs ausführen.

Um die CLI-Hilfe zu den Befehlen „ jobrun “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce jobrun -h “ aus.

ibmcloud ce jobrun delete

Jobausführung löschen.

ibmcloud ce jobrun delete (--name JOBRUN_NAME | --job JOB_NAME) [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce jobrun events

Zeigen Sie die Systemereignisse von Instanzen zur Jobausführung an. Systemereignisse werden bis zu 60 Minuten aufbewahrt.

ibmcloud ce jobrun events (--instance JOBRUN_INSTANCE | --jobrun JOBRUN_NAME) [--output OUTPUT] [--quiet]

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
Beispielausgabe von Systemereignisinformationen für die angegebene Instanz einer Jobausführung
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

ibmcloud ce jobrun get

Details einer Jobausführung anzeigen.

ibmcloud ce jobrun get --name JOBRUN_NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce jobrun list

Alle Jobausführungen im Projekt auflisten.

ibmcloud ce jobrun list [--job JOB] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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.

ibmcloud ce jobrun logs

Die Protokolle von Jobausführungsinstanzen anzeigen.

ibmcloud ce jobrun logs (--instance JOBRUN_INSTANCE | --jobrun JOBRUN_NAME) [--follow] [--output OUTPUT] [--quiet] [--raw] [--tail TAIL] [--timestamps]

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. Wenn diese Option nicht angegeben wird, werden alle Zeilen der Protokolle der angegebenen Joblaufinstanzen 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
Beispielausgabe für Protokolle aller Instanzen einer Jobausführung
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

ibmcloud ce jobrun restart

Starten Sie aktive Jobausführungsinstanzen erneut.

ibmcloud ce jobrun restart (--instance JOBRUN_INSTANCE | --jobrun JOBRUN_NAME) [--quiet]

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

ibmcloud ce jobrun resubmit

Jobausführung auf Basis der Konfiguration einer vorherigen Jobausführung erneut übergeben.

ibmcloud ce jobrun resubmit --jobrun REFERENCED_JOBRUN_NAME [--argument ARGUMENT] [--arguments-clear] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--array-size-var-override ARRAY_SIZE_VAR_OVERRIDE] [--command COMMAND] [--commands-clear] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-rm MOUNT_RM] [--mount-secret MOUNT_SECRET] [--name NAME] [--no-wait] [--output OUTPUT] [--quiet] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--service-account-clear] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

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-indexes, --array-indices, --ai

Gibt die Indizes der Instanzen an, die für diesen Joblauf verwendet werden, zum Beispiel 0,3,6,9, 1-5,7-8,10. Die Ergebnismenge der Indizes ist auf 1000 Einträge begrenzt. Diese Option kann nur angegeben werden, wenn „ array-size “ 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 die Werte in Array-Indizes. Wenn Sie beispielsweise „ instances “ von „ 5 “ angeben, wandelt das System dies in „ array-indexes “ von „ 0 - 4 “ um. Diese Option kann nur angegeben werden, wenn die Option „ --array-indexes “ 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 Umgebungsvariable „ JOB_ARRAY_SIZE “ fest. Standardmäßig ist die Umgebungsvariable „ JOB_ARRAY_SIZE “ entweder auf den Wert „ array-size “ oder auf die Anzahl der Indizes gesetzt, die über „ array-indexes “ festgelegt wurde. Der Wert der Umgebungsvariablen JOB_ARRAY_SIZE hat keinen Einfluss auf die konfigurierte Array-Größe. Verwenden Sie diese Option, um einen konstanten Wert für die Array-Größe für Job-Wiederholungs-Szenarien zu erzwingen, bei denen nur einige Job-Instanzen übermittelt oder erneut übermittelt 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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 “ auf „ task “ gesetzt ist. 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 Modus „ task “ gelten die Optionen „ maxexecutiontime “ und „ retrylimit “. Im Modus „ daemon “ sind die Optionen „ maxexecutiontime “ und „ retrylimit “ nicht zulässig, da es kein Timeout gibt und ausgefallene 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]. 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 “ auf „ task “ gesetzt ist. 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

ibmcloud ce jobrun submit

Jobausführung auf Basis eines Jobs übergeben

ibmcloud ce jobrun submit ((--name JOBRUN_NAME --image IMAGE) | (--job JOB_NAME [--name JOBRUN_NAME])) [--argument ARGUMENT] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--array-size-var-override ARRAY_SIZE_VAR_OVERRIDE] [--command COMMAND] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-secret MOUNT_SECRET] [--no-wait] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

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-indexes, --array-indices, --ai

Gibt die Indizes der Instanzen an, die für diesen Joblauf verwendet werden, zum Beispiel 0,3,6,9, 1-5,7-8,10. Die Ergebnismenge der Indizes ist auf 1000 Einträge begrenzt. Diese Option kann nur angegeben werden, wenn „ array-size “ 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 die Werte in Array-Indizes. Wenn Sie beispielsweise „ instances “ von „ 5 “ angeben, wandelt das System dies in „ array-indexes “ von „ 0 - 4 “ um. Diese Option kann nur angegeben werden, wenn die Option „ --array-indexes “ 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 Umgebungsvariable „ JOB_ARRAY_SIZE “ fest. Standardmäßig ist die Umgebungsvariable „ JOB_ARRAY_SIZE “ entweder auf den Wert „ array-size “ oder auf die Anzahl der Indizes gesetzt, die über „ array-indexes “ festgelegt wurde. Der Wert der Umgebungsvariablen JOB_ARRAY_SIZE hat keinen Einfluss auf die konfigurierte Array-Größe. Verwenden Sie diese Option, um einen konstanten Wert für die Array-Größe für Job-Wiederholungs-Szenarien zu erzwingen, bei denen nur einige Job-Instanzen übermittelt oder erneut übermittelt 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 anhand der Schlüssel-Wert-Paare fest, die in einem Secret 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 “ auf „ task “ gesetzt ist. 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 Modus „ task “ gelten die Optionen „ maxexecutiontime “ und „ retrylimit “. Im Modus „ daemon “ sind die Optionen „ maxexecutiontime “ und „ retrylimit “ nicht zulässig, da es kein Timeout gibt und ausgefallene Instanzen unbegrenzt neu gestartet werden. Dieser Wert ist optional. Der Standardwert lautet „ 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]. 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 “ auf „ task “ gesetzt ist. 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

Persistentdatastore-Befehle

Verwalten Sie persistente Datenspeicher.

ibmcloud ce persistentdatastore create

Erstellen Sie einen persistenten Datenspeicher.

ibmcloud ce persistentdatastore create --name NAME --cos-access-secret SECRET_NAME --cos-bucket-name BUCKET_NAME [--cos-bucket-location BUCKET_LOCATION] [--quiet]

Befehlsoptionen

--cos-access-secret, --cos-sec
Erforderlich. Der Name des geheimen Schlüssels, der die Berechtigungsnachweise 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 Speicherort des COS-Buckets. 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

ibmcloud ce persistentdatastore delete

Löschen Sie einen persistenten Datenspeicher.

ibmcloud ce persistentdatastore delete --name PERSISTENT_DATA_STORE_NAME [--force] [--ignore-not-found] [--quiet]

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

ibmcloud ce persistentdatastore get

Zeigen Sie die Details eines persistenten Datenspeichers an.

ibmcloud ce persistentdatastore get --name NAME [--output OUTPUT] [--quiet]

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

ibmcloud ce persistentdatastore list

Listen Sie alle persistenten Datenspeicher in einem Projekt auf.

ibmcloud ce persistentdatastore list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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

Projektbefehle

Mit project-Befehlen können Sie ein Projekt erstellen, auflisten, löschen und als aktuellen Kontext auswählen.

Ein Projekt ist eine Gruppierung von „ Code Engine “-Objekten wie Anwendungen, Funktionen, Jobs, Flotten und Builds. Ein Projekt basiert auf einem Kubernetes-Namensbereich. Der Name des Projekts muss innerhalb der Ressourcengruppe, des Benutzerkontos und der Region von IBM Cloud® eindeutig sein. Projekte dienen dazu, Ressourcen zu verwalten und Zugriff auf deren Elemente zu gewähren.

Ein Projekt bietet folgende Funktionen:

  • Ein eindeutiger Namensraum für Entitätsnamen.
  • Verwaltung des Zugriffs auf Projektressourcen von außen.
  • Verwaltung des ausgehenden Zugriffs auf Backing-Dienste, Register und Repositorien.
  • Ein automatisch generiertes Zertifikat für den Transport Layer Service ( TLS ).

Weitere Informationen zur Arbeit mit Projekten finden Sie unter Projekte verwalten.

Sie können project oder proj in Ihren project-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für project-Befehle anzeigen möchten, führen Sie ibmcloud ce proj -h aus.

ibmcloud ce project create

Erstellen Sie ein Projekt.

ibmcloud ce project create --name PROJECT_NAME [--endpoint ENDPOINT] [--no-select] [--no-wait] [--output OUTPUT] [--quiet] [--tag TAG] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

ibmcloud ce project current

Details des Projekts anzeigen, das derzeit als Ziel festgelegt ist.

ibmcloud ce project current [--output OUTPUT] [--quiet]

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

ibmcloud ce project delete

Löscht ein Projekt.

ibmcloud ce project delete (--name PROJECT_NAME | --id PROJECT_ID) [--force] [--hard] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

ibmcloud ce project get

Details eines einzelnen Projekts anzeigen.

ibmcloud ce project get (--name PROJECT_NAME | --id PROJECT_ID) [--output OUTPUT] [--quiet]

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
CRN:                                       crn:v1:bluemix:public:codeengine:au-syd:a/1a2b3c4d5e6f7g1a2b3c4d5e6f7g1234:abcdabcd-abcd-abcd-abcd-f1de4aab5d5d::
Status:                                    active
Enabled:                                   true
Application Private Visibility Supported:  true
Selected:                                  true
Tags:                                      tag1, tag2
Region:                                    us-south
Resource Group:                            default
Service Binding Service ID:                ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                                       52d
Created:                                   Mon, 30 Jun 2025 18:16:12 +0200
Updated:                                   Mon, 30 Jun 2025 18:16:58 +0200
Connectivity:    
  Outbound - Source IP addresses:                             
    Public internet  
    159.23.99.151  
    130.198.13.241  
    135.90.137.31  
    
    IBM Cloud private network  
    10.223.236.11  
    10.223.242.142  
    10.12.3.244  
  Inbound - Context-based restrictions for the data plane:    
    Enforcement status:         none  
    Public internet:            allowed  
    IBM Cloud private network:  allowed  
    Last applied:               Wed, 20 May 2026 15:52:02 +0200  
Quotas:
    Category                                  Used       Limit
    App revisions                             33         100
    Apps                                      10         100
    Build runs                                4          100
    Builds                                    4          100
    Configmaps                                7          100
    CPU                                       6.15       64
    Custom domain mappings                    4          80
    Ephemeral storage                         5415750Ki  256G
    Functions                                 2          20
    Instances (active)                        6          250
    Instances (total)                         9          2500
    Job runs                                  4          100
    Jobs                                      3          100
    Memory                                    26400M     256G
    Persistent data stores                    2          10
    Private path connections                  1          3
    Secrets                                   21         100
    Serverless fleets                         42         1000
    Subnet pools                              3          20
    Subscriptions (cron)                      1          100
    Subscriptions (IBM Cloud Object Storage)  0          100

ibmcloud ce project list

Alle Projekte auflisten.

ibmcloud ce project list [--all-resource-groups] [--output OUTPUT] [--quiet] [--regions REGIONS] [--sort-by SORT_BY]

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

ibmcloud ce project restore

Projekt wiederherstellen.

ibmcloud ce project restore (--name PROJECT_NAME | --id PROJECT_ID) [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

ibmcloud ce project select

Ein Projekt als aktuellen Kontext auswählen. Das Projekt muss den Status active aufweisen, bevor es ausgewählt werden kann.

ibmcloud ce project select (--name PROJECT_NAME | --id PROJECT_ID) [--endpoint ENDPOINT] [--kubecfg] [--quiet]

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

ibmcloud ce project tag

Verwaltet die Tags eines einzelnen Projekts.

ibmcloud ce project tag (--name PROJECT_NAME | --id PROJECT_ID) [--quiet] [--tag TAG] [--tag-rm TAG_RM]

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

ibmcloud ce project update

Das ausgewählte Projekt aktualisieren.

ibmcloud ce project update (--binding-service-id SERVICE_ID_ID | --binding-resource-group RESOURCE_GROUP_NAME | --binding-resource-group-id RESOURCE_GROUP_ID) [--quiet]

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

Rückforderungsbefehle

Code Engine-Projektreklamationen verwalten. Projekte, die nicht permanent gelöscht wurden ('soft-deleted'), können innerhalb von 7 Tagen mit dem Befehl reclamation restore wiederhergestellt werden.

ibmcloud ce reclamation delete

Löscht eine Projektrückforderung.

ibmcloud ce reclamation delete (--name PROJECT_NAME | --id PROJECT_ID) [--force] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

ibmcloud ce reclamation get

Details einer einzelnen Projektrückforderung anzeigen.

ibmcloud ce reclamation get (--name PROJECT_NAME | --id PROJECT_ID) [--output OUTPUT] [--quiet]

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

ibmcloud ce reclamation list

Listet alle Projektrückforderungen auf.

ibmcloud ce reclamation list [--all-resource-groups] [--output OUTPUT] [--quiet] [--regions REGIONS] [--sort-by SORT_BY]

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

ibmcloud ce reclamation restore

Stellt eine Projektrückforderung wieder her. Projekte, die nicht permanent gelöscht wurden ('soft-deleted'), können innerhalb von 7 Tagen mit dem Befehl reclamation restore wiederhergestellt werden.

ibmcloud ce reclamation restore (--name PROJECT_NAME | --id PROJECT_ID) [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

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

Befehle für eine Registry (registry)

Eine Container-Registry oder Registry ist ein Service, in dem Container-Images gespeichert werden. IBM Cloud Container Registry und Docker Hub sind beispielsweise Container-Registrys. Eine Container-Registry kann öffentlich oder privat sein. Bei einer öffentlichen Container-Registry sind keine Berechtigungsnachweise für den Zugriff erforderlich. Im Gegensatz dazu erfordert der Zugriff auf eine private Registry Berechtigungsnachweise.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie registry-Befehle verwenden können.

Weitere Informationen zum Zugriff auf Registrys finden Sie unter Zugriff auf private Container-Registry hinzufügen.

Um die CLI-Hilfe zu den Befehlen „ registry “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce registry -h “ aus.

Seit der CLI-Version 1.42.0 sind die Definition und die Arbeit mit Secrets in der CLI unter der secret befehlsgruppe zusammengefasst. Siehe ibmcloud ce secret befehle. Verwenden Sie die Option --format, um die Kategorie des Geheimnisses anzugeben, z. B. basic_auth, generic, hmac, ssh, tls oder registry. Sie können zwar weiterhin die registry befehlsgruppe verwenden können, nutzen Sie die Vorteile der vereinheitlichten secret befehlsgruppe. Um ein Geheimnis für den Zugriff auf eine Container-Registrierung zu erstellen, verwenden Sie den ibmcloud ce secret create --format registry befehl. Um mehr über die Arbeit mit Geheimnissen in Code Engine zu erfahren, siehe Arbeiten mit Geheimnissen.

ibmcloud ce registry create

Geheimen Schlüssel für Zugriff auf Image-Registry erstellen.

ibmcloud ce registry create --name NAME (--password PASSWORD | --password-from-file PASSWORD_FILE | --password-from-json-file) [--email EMAIL] [--output OUTPUT] [--quiet] [--server SERVER] [--username USERNAME]

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.

Beispiel

Im folgenden Beispiel wird der Zugriff auf eine Image-Registry mit dem Namen myregistry für eine Container Registry-Instanz erstellt, die sich an der Position us.icr.io befindet und den Benutzernamen iamapikey sowie den IAM-API-Schlüssel als Kennwort verwendet.

ibmcloud ce registry create --name myregistry --server us.icr.io --username iamapikey --password API_KEY

Beispielausgabe

Creating image registry access secret myregistry...
OK

ibmcloud ce registry delete

Geheimen Schlüssel für Zugriff auf Image-Registry löschen.

ibmcloud ce registry delete --name NAME [--force] [--ignore-not-found] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels für den Zugriff auf die Image-Registry. 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 registry delete --name myregistry -f

Beispielausgabe

Deleting image registry access secret myregistry...
OK

ibmcloud ce registry get

Details eines geheimen Schlüssels für den Zugriff auf Image-Registrys anzeigen.

ibmcloud ce registry get --name NAME [--decode] [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels für den Zugriff auf die Image-Registry. Dieser Wert ist erforderlich.
--decode, -d
Die Ausgabe von Data in den Details als decodiert anzeigen. Wenn diese Option nicht angegeben wird, sind die Data-Details mit Base64 codiert. 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 registry get --name myregistry

Beispielausgabe

Getting image registry access secret myregistry...
OK
Name:        myregistry
Project:     myproject
Project ID:  01234567-abcd-abcd-abcd-abcdabcd1111
Created:     2021-02-23T09:10:01-05:00
Data:
---
.dockerconfigjson: abcdabcdabcdabcdabcdnVzZXJuYW1lIjoiaWFtYXBpa2V5IiwicGFzc3dvcmQiOiJoQllTSTc5Uk8yQUIxSDV3RUs2UzhScV9uNzE4NkQ1eWt1M1FOUk85aFpfaCIsImVtYWlsIjoiYUBiLmMiLCabcdabcdabcdabcdabcdT21oQ1dWTkpOemxTVHpKQlFqRklOWGRGU3paVE9GSnhYMjQzTVRnMlJEVjabcdabcdabcdabcdabcdbG9XbDlvIn19fQ==

ibmcloud ce registry list

Alle geheimen Schlüssel für den Zugriff auf Image-Registrys im Projekt auflisten.

ibmcloud ce registry list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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 registry list

Beispielausgabe

Listing image registry access secrets...
OK
Name        Age
myregistry  19m22s

ibmcloud ce registry update

Geheimen Schlüssel für Zugriff auf Image-Registry aktualisieren.

ibmcloud ce registry update --name NAME [--email EMAIL] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--quiet] [--server SERVER] [--username USERNAME]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels für den Zugriff auf die Image-Registry. 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. 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. 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. 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.
--username, -u
Der Benutzername für den Zugriff auf den Registry-Server. Dieser Wert ist optional.

Beispiel

Im folgenden Beispiel wird ein Kennwort für den Zugriff auf die Image-Registry mit dem Namen myregistry aktualisiert.

ibmcloud ce registry update --name myregistry --password NEW_API_KEY

Beispielausgabe

Getting image registry access secret 'myregistry'...
Updating image registry access secret 'myregistry'...
OK

Befehle für ein Repository (repo)

Ein Code-Repository, wie zum Beispiel GitHub oder GitLab, in dem der Quellcode gespeichert wird. Mit Code Engine können Sie Zugriff auf ein privates Code-Repository hinzufügen und anschließend vom Build auf dieses Repository verweisen.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie repo-Befehle verwenden können.

Weitere Informationen zum Zugriff auf Repositorys finden Sie unter Auf private Code-Repositorys zugreifen.

Um die CLI-Hilfe zu den Befehlen „ repo “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce repo -h “ aus.

Seit der CLI-Version 1.42.0 sind die Definition und die Arbeit mit Secrets in der CLI unter der secret befehlsgruppe zusammengefasst. Siehe ibmcloud ce secret befehle. Verwenden Sie die Option --format, um die Kategorie des Geheimnisses anzugeben, z. B. basic_auth, generic, hmac, ssh, tls oder registry. Sie können zwar weiterhin die repo befehlsgruppe verwenden können, nutzen Sie die Vorteile der vereinheitlichten secret befehlsgruppe. Um ein Geheimnis für den Zugriff auf einen Dienst mit einem SSH-Schlüssel zu erstellen, z. B. für die Authentifizierung bei einem Git-Repository wie GitHub oder GitLab,, verwenden Sie den ibmcloud ce secret create --format ssh befehl. Ein SSH-Geheimnis wird auch als Zugriffsgeheimnis für das Repository Git verwendet. Um mehr über die Arbeit mit Geheimnissen in Code Engine zu erfahren, siehe Arbeiten mit Geheimnissen.

ibmcloud ce repo create

Geheimen Schlüssel für Zugriff auf Git-Repository erstellen.

ibmcloud ce repo create --name SECRET_NAME --key-path SSH_KEY_PATH --host HOST_ADDRESS [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--quiet]

Befehlsoptionen

--host, --ho

Die Adresse des Hosts; Beispiel: github.com. Dieser Wert ist erforderlich.

--key-path, --kp

Der Pfad des nicht verschlüsselten privaten SSH-Schlüsseldatei. Wenn Sie einen persönlichen privaten SSH-Schlüssel verwenden, befindet sich diese Datei normalerweise in $HOME/.ssh/id_rsa (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\id_rsa (Windows). Dieser Wert ist erforderlich.

-n, --name

Der Name des geheimen Schlüssels für den Zugriff auf das Git-Repository. 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.

--known-hosts-path, --khp
Der Pfad zur bekannten Hostdatei. Dieser Wert ist eine Sicherheitsfunktion und soll sicherzustellen, dass der private Schlüssel nur für die Authentifizierung bei Hosts verwendet wird, auf die Sie zuvor zugegriffen haben, insbesondere die GitHub- oder GitLab-Hosts. Diese Datei befindet sich normalerweise in $HOME/.ssh/known_hosts (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\known_hosts (Windows). 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.

Beispiel

Mit dem folgenden Befehl wird ein geheimer Git-Zugriffsschlüssel mit dem Namen github für den Host github.com erstellt und die Authentifizierung erfolgt mit einem SSH-Schlüssel unter /<filepath>/.ssh/id_rsa, wobei <filepath> der Pfad auf Ihrem System ist.

ibmcloud ce repo create -n github --key-path /<filepath>/.ssh/id_rsa --host github.com

Beispielausgabe

Creating Git access secret github...
OK

ibmcloud ce repo delete

Geheimen Schlüssel für Zugriff auf Git-Repository löschen.

ibmcloud ce repo delete --name NAME [--force] [--ignore-not-found] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels für den Zugriff auf das Git-Repository. 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 repo delete --name github

Beispielausgabe

Are you sure you want to delete the Git access secret github? [y/N]> y
Deleting Git access secret github...
OK

ibmcloud ce repo get

Details eines geheimen Schlüssels für den Zugriff auf Git-Repository anzeigen.

ibmcloud ce repo get --name NAME [--decode] [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels für den Zugriff auf das Git-Repository. Dieser Wert ist erforderlich.
--decode, -d
Die Ausgabe von Data in den Details als decodiert anzeigen. Wenn diese Option nicht angegeben wird, sind die Data-Details mit Base64 codiert. 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 repo get -n github

Beispielausgabe

Getting Git access secret github...
OK
Name:        github  
Project:     myproject  
Project ID:  01234567-abcd-abcd-abcd-abcdabcd1111
Age:         30s  
Created:     2021-03-14T14:05:56-05:00  
Host:        github.com
Data:          
---
ssh-privatekey:
ABCDABCDABCDABCDABCDU1NIIFBSSVZBVEUgS0VZLS0tLS0KYjABCDABCDABCDABCDhrdGRqRUFBQUFBQ21GbGN6STFOaABCDABCDABCDABCDABCDABCDE
...

ibmcloud ce repo list

Alle geheimen Schlüssel für den Zugriff auf Git-Repositorys im Projekt auflisten.

ibmcloud ce repo list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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 repo list

Beispielausgabe

Listing Git access secrets...
OK
Name    Age  
github  13m0s

ibmcloud ce repo update

Geheimen Schlüssel für Zugriff auf Git-Repository aktualisieren.

ibmcloud ce repo update --name SECRET_NAME [--host HOST] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels für den Zugriff auf das Git-Repository. Dieser Wert ist erforderlich.
--host, --ho
Die Adresse des Hosts; Beispiel: github.com. Dieser Wert ist optional.
--key-path, --kp
Der Pfad des nicht verschlüsselten privaten SSH-Schlüsseldatei. Wenn Sie einen persönlichen privaten SSH-Schlüssel verwenden, befindet sich diese Datei normalerweise in $HOME/.ssh/id_rsa (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\id_rsa (Windows). Dieser Wert ist optional.
--known-hosts-path, --khp
Der Pfad zur bekannten Hostdatei. Dieser Wert ist eine Sicherheitsfunktion und soll sicherzustellen, dass der private Schlüssel nur für die Authentifizierung bei Hosts verwendet wird, auf die Sie zuvor zugegriffen haben, insbesondere die GitHub- oder GitLab-Hosts. Diese Datei befindet sich normalerweise in $HOME/.ssh/known_hosts (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\known_hosts (Windows). 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.

Beispiel

Mit dem folgenden Befehl wird ein geheimer Git-Zugriffsschlüssel mit dem Namen github entsprechend aktualisiert, um einen neuen Host zu verwenden.

ibmcloud ce repo update  -n github --host NEW_HOST

Beispielausgabe

Getting Git access secret 'github'...
Updating Git access secret 'github'...
OK

Revisionsbefehle

Eine Anwendung oder App führt den Code für die Verarbeitung von HTTP-Anforderungen aus. Zusätzlich zu den traditionellen HTTP-Anforderungen unterstützt IBM Cloud® Code Engine auch Anwendungen, die WebSockets als Kommunikationsprotokoll verwenden. Eine App weist mindestens eine Revision auf. Eine Revision stellt eine unveränderliche Version der Konfigurationseigenschaften der App dar. Bei jeder Aktualisierung einer Konfigurationseigenschaft der App wird eine neue Revision der App erstellt.

Verwenden Sie die revision-Befehle zum Verwalten von Anwendungsrevisionen.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie revision-Befehle verwenden können.

Weitere Informationen zum Arbeiten mit Revisionen für Apps finden Sie unter Anwendungen bereitstellen.

Sie können revision oder rev in Ihren revision-Befehlen verwenden. Wenn Sie die Hilfe der Befehlszeilenschnittstelle für revision-Befehle anzeigen möchten, führen Sie ibmcloud ce revision -h aus.

ibmcloud ce revision delete

Anwendungsrevision löschen.

ibmcloud ce revision delete --name REVISION_NAME [--force] [--ignore-not-found] [--quiet]

Befehlsoptionen

--name, -n
Der Name der Anwendungsrevision. 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 revision delete -n newapp-mytest-00004 -f

Beispielausgabe

Deleting application revision 'newapp-mytest-00004'...
OK

ibmcloud ce revision events

Zeigen Sie die Systemereignisse von Instanzen zur Anwendungsrevision an. Systemereignisse werden bis zu 60 Minuten aufbewahrt.

ibmcloud ce revision events (--instance REVISION_INSTANCE | --revision REVISION_NAME) [--output OUTPUT] [--quiet]

Befehlsoptionen

--instance, -i
Der Name einer bestimmten Anwendungsinstanz. Verwenden Sie den Befehl rev get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --revision 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.
--revision, --rev, -r, --name, -n
Zeigt die Ereignisse aller Instanzen der angegebenen Anwendungsrevision an. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.

Beispiel

ibmcloud ce revision events -n myapp-00001

Beispielausgabe

Code Engine behält nur die letzte inaktive Revision Ihrer Anwendung bei, die zusätzlich zu Ihrer aktiven App-Revision enthalten ist. Ältere Revisionen werden nicht beibehalten.

Getting application revision 'newapp-mytest-00002'...
Getting events for all instances of application revision 'newapp-mytest-00002'...
OK
newapp-mytest-00002-deployment-7c87cfbf66-xnwkp:
Type     Reason     Age                Source                Messages
Normal   Scheduled  65s                default-scheduler     Successfully assigned bz8i2yh012p/newapp-mytest-00002-deployment-7c87cfbf66-xnwkp to 10.243.0.60
Normal   Pulling    63s                kubelet, 10.243.0.60  Pulling image "icr.io/codeengine/codeengine@sha256:b3150372958ab68eea5356a8cab31069ca5293c45959d64f6aaabbccddeeff123"
Normal   Created    60s                kubelet, 10.243.0.60  Created container queue-proxy
Normal   Created    60s                kubelet, 10.243.0.60  Created container user-container
Normal   Started    60s                kubelet, 10.243.0.60  Started container user-container
Normal   Pulled     60s                kubelet, 10.243.0.60  Container image "icr.io/obs/codeengine/knative-serving/knative.dev/serving/cmd/queue:v0.20.0-rc11@sha256:3fedfa9d9cdd74e85d11d4167043f13902074946caf415d16ff537620f04931a" already present on machine
Normal   Pulled     60s                kubelet, 10.243.0.60  Successfully pulled image "icr.io/codeengine/codeengine@sha256:b3150372958ab68eea5356a8cab31069ca5293c45959d64f6aaabbccddeeff123" in 2.67237432s
Normal   Started    60s                kubelet, 10.243.0.60  Started container queue-proxy
Normal   Pulling    60s                kubelet, 10.243.0.60  Pulling image "icr.io/obs/codeengine/istio/proxyv2:1.9.1-rc7"
Normal   Pulled     59s                kubelet, 10.243.0.60  Successfully pulled image "icr.io/obs/codeengine/istio/proxyv2:1.9.1-rc7" in 666.211288ms
Normal   Created    59s                kubelet, 10.243.0.60  Created container istio-proxy
Normal   Started    59s                kubelet, 10.243.0.60  Started container istio-proxy

ibmcloud ce revision get

Zeigt die Details einer Anwendungsrevision an.

ibmcloud ce revision get --name REVISION_NAME [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name der Anwendungsrevision. 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 revision get --name newapp-mytest-00002

Beispielausgabe

Getting application revision 'newapp-mytest-00002'...
Getting application 'newapp-mytest'...
OK
Name:            newapp-mytest-00002
ID:              abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:    myproject
Project ID:      01234567-abcd-abcd-abcd-abcdabcd1111
Age:             27d
Created:         2021-05-05T11:50:00-04:00
Status Summary:  Revision is ready
Environment Variables:
    Type                      Name               Value
    ConfigMap full reference  mycolorconfigmap
    Literal                   TARGET             Sunshine
Image:                  icr.io/codeengine/codeengine
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G
Port:                   8080
Runtime:
    Concurrency:    100
    Maximum Scale:  10
    Minimum Scale:  0
    Timeout:        300
Conditions:
    Type                OK     Age    Reason
    Active              false  5d22h  NoTraffic : The target is not receiving traffic.
    ContainerHealthy    true   5d22h
    Ready               true   5d22h
    ResourcesAvailable  true   5d22h

ibmcloud ce revision list

Listet alle Anwendungsrevisionen in einem Projekt auf.

ibmcloud ce revision list [--application APPLICATION] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Befehlsoptionen

--application, --app, -a
Verwenden Sie diese Option, wenn nur Revisionen aus der angegebenen Anwendung angezeigt werden sollen. 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 revision list

Beispielausgabe

Code Engine behält nur die letzte inaktive Revision Ihrer Anwendung bei, die zusätzlich zu Ihrer aktiven App-Revision enthalten ist. Ältere Revisionen werden nicht beibehalten.

Listing all application revisions...
OK
Name                   Application      Status  URL  Latest  Tag  Traffic  Age    Conditions  Reason
myapp-hc3u8-2           myapp            Ready                              16d    3 OK / 4
myapp-hc3u8-3           myapp            Ready        true         100%    2d8h    3 OK / 4  
newapp-mytest-00004     newapp-mytest    Ready                              4d20h  3 OK / 4
newapp-mytest-00005     newapp-mytest    Ready        true         100%     2d20h  3 OK / 4

ibmcloud ce revision logs

Zeigt die Protokolle der Anwendungsrevisionsinstanzen an.

ibmcloud ce revision logs (--instance REVISION_INSTANCE | --revision REVISION_NAME) [--all-containers] [--follow] [--output OUTPUT] [--quiet] [--tail TAIL] [--timestamps]

Befehlsoptionen

--all-containers, --all
Anzeige der Protokolle aller Container der angegebenen Anwendungsrevisionsinstanzen. Dieser Wert ist optional. Der Standardwert ist false.
--follow, -f
Folgen Sie den Protokollen der Anwendungsrevisionsinstanzen. Verwenden Sie diese Option, um Protokolle von Anwendungsrevisionsinstanzen 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 Anwendungsrevisionsinstanz. Verwenden Sie den Befehl revision get, um den Instanznamen zu suchen. Dieser Wert ist erforderlich, wenn --revision 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.
--revision, --rev, -r, --name, -n
Zeigt die Protokolle aller Instanzen der angegebenen Anwendungsrevision an. Dieser Wert ist erforderlich, wenn --instance nicht angegeben ist.
--tail, -t
Begrenzen Sie die Anzeige von Protokollen von Containern der angegebenen Anwendungsrevisionsinstanzen auf eine maximale Anzahl von aktuellen Zeilen pro Container. Um beispielsweise die letzten 3 Zeilen der Protokolle der Container der angegebenen Anwendungsrevisionsinstanzen anzuzeigen, geben Sie --tail 3 an. Wenn diese Option nicht angegeben wird, werden alle Zeilen der Protokolle der Container der angegebenen Anwendungsrevisionsinstanzen 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 revision logs -n myapp-00001

Beispielausgabe

Code Engine behält nur die letzte inaktive Revision Ihrer Anwendung bei, die zusätzlich zu Ihrer aktiven App-Revision enthalten ist. Ältere Revisionen werden nicht beibehalten.

Getting logs for all instances of application revision 'newapp-mytest-00002'...
Getting application revision 'newapp-mytest-00002'...
OK
newapp-mytest-00002-deployment-7c87cfbf66-xnwkp/user-container:
2021-07-15 20:40:56 Listening on port 8080

Befehle für geheime Schlüssel

Von einem geheimen Schlüssel wird eine Methode zum Einschließen sensibler Konfigurationsinformationen wie Kennwörter oder SSH-Schlüssel bereitgestellt. Indem Sie auf Werte aus Ihrem Secret verweisen, können Sie sensible Informationen von Ihrer Bereitstellung entkoppeln, um die Portabilität Ihrer App, Funktion oder Ihres Jobs zu gewährleisten. Alle, die über eine Zugriffsberechtigung für Ihr Projekt verfügen, können auch Ihre geheimen Schlüssel anzeigen; bedenken Sie, dass die Informationen des geheimen Schlüssels mit diesen Benutzern gemeinsam genutzt werden können. Geheime Schlüssel enthalten die Informationen in Form von Schlüssel/Wert-Paaren.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie secret-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Geheimnissen finden Sie unter Arbeiten mit Geheimnissen.

Um die CLI-Hilfe zu den Befehlen „ secret “ anzuzeigen, führen Sie den Befehl „ ibmcloud ce secret -h “ aus.

Seit der CLI-Version 1.42.0 sind die Definition und die Arbeit mit Secrets in der CLI unter der secret befehlsgruppe zusammengefasst. Verwenden Sie die Option --format, um die Kategorie des Geheimnisses anzugeben, z. B. basic_auth, generic, hmac, ssh, tls oder registry. Der Standardwert für die Option --format ist generic.

ibmcloud ce secret create

Geheimen Schlüssel erstellen.

ibmcloud ce secret create --name SECRET_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE) [--access-key-id ACCESS_KEY_ID] [--access-key-id-prompt] [--cert-chain-file CERT_CHAIN_FILE] [--email EMAIL] [--format FORMAT] [--from-json-file FROM_JSON_FILE] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--private-key-file PRIVATE_KEY_FILE] [--quiet] [--secret-access-key SECRET_ACCESS_KEY] [--secret-access-key-prompt] [--server SERVER] [--username USERNAME]

Befehlsoptionen

--access-key-id, --akid

Geben Sie 'access_key_id' für den HMAC-Berechtigungsnachweis an. Dieser Wert ist optional.

--access-key-id-prompt

Aufforderung zur Eingabe von 'access_key_id' für den HMAC-Berechtigungsnachweis. Dieser Wert ist optional. Der Standardwert ist false.

--cert-chain-file, --ccf

Geben Sie eine Datei an, die die von Ihrer Zertifizierungsstelle bereitgestellte Zertifikatskette für ein „ TLS “-Geheimnis enthält. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist erforderlich für tls secrets. Dieser Wert ist optional.

--email, --em

Die E-Mail-Adresse für den Zugriff auf den Registrierungsserver für ein Registrierungsgeheimnis. Dieser Wert gilt nur für registry Geheimnisse. Dieser Wert ist optional.

--format, --fo

Das Format des geheimen Schlüssels. Gültige Werte sind basic_auth, generic, hmac, registry, ssh oder tls. Dieser Wert ist optional. Der Standardwert ist generic.

--from-env-file, -e

Erstellt einen generischen geheimen Schlüssel auf der Basis einer Datei, 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. Dieser Wert gilt nur für generic Geheimnisse.

--from-file, -f

Erstellt einen generischen geheimen Schlüssel auf der Basis 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. Dieser Wert gilt nur für generic Geheimnisse.

--from-json-file, --json

Der Pfad zu einer Datei, die die Werte der geheimen Schlüssel im JSON-Format enthält. Diese Option wird für das geheime Format hmac unterstützt. Dieser Wert ist optional.

--from-literal, -l

Erstellt einen generischen geheimen Schlüssel auf der Basis eines Schlüssel/Wert-Paars. 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. Dieser Wert gilt nur für generic Geheimnisse.

--key-path, --kp

Der Pfad zu Ihrer unverschlüsselten privaten SSH-Schlüsseldatei für ein SSH-Geheimnis. Wenn Sie einen persönlichen privaten SSH-Schlüssel verwenden, befindet sich diese Datei normalerweise in $HOME/.ssh/id_rsa (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\id_rsa (Windows). Dieser Wert ist erforderlich für ssh secrets. Dieser Wert ist optional.

--known-hosts-path, --khp

Der Pfad zu Ihrer Datei mit den bekannten Hosts für ein SSH-Geheimnis. Dieser Wert ist eine Sicherheitsfunktion und soll sicherzustellen, dass der private Schlüssel nur für die Authentifizierung bei Hosts verwendet wird, auf die Sie zuvor zugegriffen haben, insbesondere die GitHub- oder GitLab-Hosts. Diese Datei befindet sich normalerweise in $HOME/.ssh/known_hosts (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\known_hosts (Windows). Dieser Wert gilt nur für ssh Geheimnisse. Dieser Wert ist optional.

-n, --name

Der Name des geheimen Schlüssels. 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 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, --pw

Das Kennwort für einen Basisautor oder ein Registrierungsgeheimnis. 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 für die Geheimnisse basic_auth und registry erforderlich. Dieser Wert ist optional.

--password-from-file, --spf

Der Pfad zu einer Datei, die das Kennwort für ein Basisautorisierungs- oder Registrierungsgeheimnis 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. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist für die Geheimnisse basic_auth und registry erforderlich. Dieser Wert ist optional.

--password-from-json-file, --spfj

Der Pfad zu einer JSON-Datei, die das Kennwort für eine Basisauthentifizierung oder ein Registrierungsgeheimnis 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. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist für die Geheimnisse basic_auth und registry erforderlich. Dieser Wert ist optional.

--private-key-file, --pkf

Geben Sie mit der Option „ cert-chain-file “ eine Datei an, die den privaten Schlüssel für ein „ TLS “-Geheimnis enthält, das mit der angegebenen Zertifikatskette übereinstimmt. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist erforderlich für tls secrets. Dieser Wert ist optional.

--quiet, -q

Geben Sie diese Option an, um die Ausgabe des Befehls zu reduzieren. Diese Option gilt für die Geheimnisse basic_auth, generic, registry, ssh, und tls. Dieser Wert ist optional. Der Standardwert ist false.

--secret-access-key, --sak

Geben Sie 'secret_access_key' für den HMAC-Berechtigungsnachweis an. Dieser Wert ist optional.

--secret-access-key-prompt

Aufforderung zur Eingabe von 'secret_access_key' für den HMAC-Berechtigungsnachweis. Dieser Wert ist optional. Der Standardwert ist false.

--server, -s

Die URL des Registrierungsservers für ein Registrierungsgeheimnis. Diese Option ist erforderlich für registry secrets. Dieser Wert ist optional. Der Standardwert ist us.icr.io.

--username, -u

Der Benutzername für Ihre Basisauthentifizierung oder Ihr Registrierungsgeheimnis. Diese Option ist für die Geheimnisse basic_auth und registry erforderlich. Dieser Wert ist optional.

Beispiel für ein einfaches Anmeldegeheimnis

Ein Basisauthentifizierungsgeheimnis enthält einen username- und einen password-Schlüssel und wird verwendet, wenn Sie auf einen Dienst zugreifen, der die Basisauthentifizierung HTTP erfordert.

Führen Sie ibmcloud ce secret create --format basic_auth aus, um die CLI-Hilfe zum Erstellen eines grundlegenden Authentifizierungsgeheimnisses anzuzeigen.

Das folgende Beispiel erstellt ein Basis-Auth-Geheimnis mit dem Namen mysecret-basicauth. Dieses Geheimnis enthält den Benutzernamen myusername, und der Passwortwert wird aus einer Datei auf dem lokalen Rechner bezogen. Wenn das Kennwort nicht aus einer Datei oder einer JSON-Datei bereitgestellt wird, werden Sie aufgefordert, den Kennwortwert einzugeben.

ibmcloud ce secret create --name mysecret-basicauth --format basic_auth --username myusername --password-from-file ./password.txt

Beispielausgabe für ein einfaches Authentifizierungsgeheimnis

Creating basic_auth secret 'mysecret-basicauth'...
OK

Beispiel für ein allgemeines Geheimnis

Ein generisches Geheimnis speichert einfache Schlüssel-Wert-Paare und Code Engine macht keine Annahmen über die definierten Schlüssel-Wert-Paare oder über die beabsichtigte Verwendung des Geheimnisses.

Um die CLI-Hilfe zum Erstellen eines allgemeinen Geheimnisses anzuzeigen, führen Sie ibmcloud ce secret create oder ibmcloud ce secret create --format generic aus.

Beachten Sie, dass --format generic der Standard ist, wenn Sie ein Geheimnis mit dem secret create befehl in der CLI erstellen.

Im folgenden Beispiel wird ein allgemeines Geheimnis mit dem Namen mysecret-generic erstellt und der Wert dieses Geheimnisses wird für ein Schlüssel-Wert-Paar mit der Option --from-literal angegeben.

ibmcloud ce secret create --name mysecret-generic --format generic --from-literal "TARGET=My literal secret"

Beispielausgabe für ein allgemeines Geheimnis

Creating generic secret 'mysecret-generic'...
OK

Beispiel für ein generisches Geheimnis mit Werten aus einer Datei

Im folgenden Beispiel wird ein geheimer Schlüssel mit dem Namen mysecret-fromfile und mit Werten aus einer Datei erstellt. Wenn Sie die Option --from-file verwenden, um auf eine Datei zu verweisen, wird der gesamte Inhalt der Datei zum Wert für das Schlüssel-Wert-Paar.

ibmcloud ce secret create --name mysecret-genericfromfile  --from-file ./value1.txt --from-file ./value2.txt
Beispielausgabe eines generischen Geheimnisses mit Werten aus einer Datei
Creating secret mysecret-genericfromfile...
OK

Beispiel für ein HMAC-Geheimnis

Ein HMAC-Geheimnis enthält einen access_key_id und einen secret_access_key Schlüssel und wird mit S3-compatible Tools und Bibliotheken verwendet, die eine Authentifizierung erfordern, aber keine IBM Cloud® Identity and Access Management API-Schlüssel unterstützen.

Um die CLI-Hilfe zur Erstellung eines HMAC-Geheimnisses anzuzeigen, führen Sie ibmcloud ce secret create --format hmac aus.

Im folgenden Beispiel wird ein HMAC-Geheimnis mit dem Namen mysecret-hmac erstellt. Dieses Geheimnis enthält die access_key_id und die secret_access_key Werte, die bei der Aufforderung angegeben werden. Wenn eine der beiden Optionen nicht mit dem Befehl oder aus einer JSON-Datei bereitgestellt wird, werden Sie aufgefordert, deren Werte einzugeben.

ibmcloud ce secret create --name mysecret-hmac --format hmac --access-key-id-prompt --secret-access-key-prompt

Beispielausgabe für ein HMAC-Geheimnis

Creating hmac_auth secret 'mysecret-hmac'...
OK

Beispiel für ein Registrierungsgeheimnis

Ein Registrierungsgeheimnis speichert Anmeldeinformationen für den Zugriff auf eine Container-Registrierung.

Um die CLI-Hilfe zum Erstellen eines Registrierungsgeheimnisses anzuzeigen, führen Sie ibmcloud ce secret create --format registry aus.

Das folgende Beispiel erstellt ein Registrierungsgeheimnis mit dem Namen mysecret-registry für eine Instanz IBM Cloud Container Registry, die sich auf dem Registrierungsserver us.icr.io befindet, und gibt Anmeldeinformationen für username und password an.

ibmcloud ce secret create --name mysecret-registry --format registry --server us.icr.io --username iamapikey --password API_KEY

Beispielausgabe für ein Registrierungsgeheimnis

Creating registry secret `mysecret-registry`...
OK

Beispiel für ein SSH-Geheimnis

Ein SSH-Geheimnis speichert Anmeldedaten, um sich bei einem Dienst mit einem SSH-Schlüssel zu authentifizieren, z. B. bei einem Git-Repository wie GitHub oder GitLab.

Um die CLI-Hilfe zum Erstellen eines SSH-Geheimnisses anzuzeigen, führen Sie ibmcloud ce secret create --format ssh aus.

Das folgende Beispiel erstellt ein SSH-Geheimnis mit dem Namen mysecret-ssh für einen Host, der in der Datei known_hosts enthalten ist, und authentifiziert sich mit einer unverschlüsselten privaten SSH-Schlüsseldatei unter /<filepath>/.ssh/<key_name>, wobei <filepath> der Pfad auf Ihrem System ist. Dieser Befehl erfordert einen Namen und einen Schlüsselpfad und erlaubt auch andere optionale Argumente wie den Pfad zur Datei der bekannten Hosts.

ibmcloud ce secret create --name mysecret-ssh --format ssh --key-path ~/.ssh/<key_name> --known-hosts-path  ~/.ssh/known_hosts

Beispielausgabe für ein SSH-Geheimnis

Creating SSH secret `mysecret-ssh`...
OK

Beispiel für ein TLS Geheimnis

Ein Transport Layer Security ( TLS )-Geheimnis enthält ein signiertes TLS-Zertifikat, einschließlich aller Zwischenzertifikate, und den zugehörigen privaten Schlüssel einer Zertifizierungsstelle (CA). Verwenden Sie TLS secrets, wenn Sie mit benutzerdefinierten Domänen-Zuordnungen arbeiten.

Um die CLI-Hilfe zum Erstellen eines TLS-Geheimnisses anzuzeigen, führen Sie ibmcloud ce secret create --format tls aus.

Das folgende Beispiel erstellt ein TLS Geheimnis mit dem Namen mysecret-tls. Die Zertifikatskette, die der benutzerdefinierten Domäne entspricht, ist in der Datei certificate.txt enthalten, und die passende private Schlüsseldatei ist in der Datei privatekey.txt enthalten. Diese beiden Dateien befinden sich im Stammverzeichnis der lokalen Workstation.

ibmcloud ce secret create --name mysecret-tls  --format tls  --cert-chain-file certificate.txt --private-key-file privatekey.txt

Beispielausgabe für ein TLS Geheimnis

Creating TLS secret `mysecret-tls`...
OK

ibmcloud ce secret delete

Geheimen Schlüssel löschen.

ibmcloud ce secret delete --name SECRET_NAME [--force] [--ignore-not-found] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels. 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 secret delete --name mysecret-genericfromfile -f

Beispielausgabe

Deleting secret mysecret-genericfromfile...
OK

ibmcloud ce secret get

Zeigen Sie die Details eines geheimen Schlüssels an.

ibmcloud ce secret get --name SECRET_NAME [--decode] [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels. Dieser Wert ist erforderlich.
--decode, -d
Die Ausgabe von Data in den Details als decodiert anzeigen. Wenn diese Option nicht angegeben wird, sind die Data-Details mit Base64 codiert. 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 secret get --name mysecret-basicauth

Beispielausgabe

Getting secret 'mysecret-basicauth'...
OK
Name:          mysecret-basicauth
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Format:        basic_auth
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           66s
Created:       2021-03-10T18:44:18-05:00
Data:    
---
password: REDACTED
username: bXl1c2VybmFtZQ==

ibmcloud ce secret list

Listen Sie alle geheimen Schlüssel in einem Projekt auf.

ibmcloud ce secret list [--all] [--format FORMAT] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Befehlsoptionen

--all, -a
Anzeige aller Geheimnisse aller Formate, einschließlich der Geheimnisse basic_auth, generic, registry, ssh, tls und other, die nicht von Code Engine verwaltet werden. Dieser Wert ist optional. Der Standardwert ist false.
--format, --fo
Geben Sie diese Option an, um die Anzeige von geheimen Schlüsseln zu filtern. Gültige Werte sind basic_auth, generic, registry, ssh und tls. 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

Dieser Befehl listet alle Geheimnisse in einem Projekt auf.

ibmcloud ce secret list

Beispielausgabe

Listing secrets...
OK
Name                          Format          Data  Age  
ce-auto-icr-private-us-south  registry        4     333d  
ce-auto-private-icr-us-south  registry        4     335d  
myregistry-seccmd             registry        4     3h31m  
mysecret-basicauth            basic_auth      2     7m37s  
mysecret-generic              generic         1     7m7s  
mysecret-genericfromfile      generic         2     2m29s  
mysecret-hmac                 hmac_auth       2     21m
mysecret-registry             registry        4     111s  
mysecret-ssh                  ssh_auth        2     42m  
mysecret-tls                  tls             2     3h47m

ibmcloud ce secret update

Geheimen Schlüssel aktualisieren.

ibmcloud ce secret update --name SECRET_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE | --rm KEY) [--access-key-id ACCESS_KEY_ID] [--access-key-id-prompt] [--cert-chain-file CERT_CHAIN_FILE] [--email EMAIL] [--from-json-file FROM_JSON_FILE] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--private-key-file PRIVATE_KEY_FILE] [--quiet] [--secret-access-key SECRET_ACCESS_KEY] [--secret-access-key-prompt] [--server SERVER] [--username USERNAME]

Befehlsoptionen

--name, -n
Der Name des geheimen Schlüssels. Dieser Wert ist erforderlich.
--access-key-id, --akid
Geben Sie 'access_key_id' für den HMAC-Berechtigungsnachweis an. Dieser Wert ist optional.
--access-key-id-prompt
Aufforderung zur Eingabe von 'access_key_id' für den HMAC-Berechtigungsnachweis. Dieser Wert ist optional. Der Standardwert ist false.
--cert-chain-file, --ccf
Geben Sie eine Datei an, die die von Ihrer Zertifizierungsstelle bereitgestellte Zertifikatskette für ein „ TLS “-Geheimnis enthält. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist optional.
--email, --em
Die E-Mail-Adresse für den Zugriff auf den Registrierungsserver für ein Registrierungsgeheimnis. Dieser Wert ist optional.
--from-env-file, -e
Aktualisiert einen generischen geheimen Schlüssel auf der Basis einer Datei, 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
Aktualisiert einen generischen geheimen Schlüssel auf der Basis 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.
--from-json-file, --json
Der Pfad zu einer Datei, die die Werte der geheimen Schlüssel im JSON-Format enthält. Diese Option wird für das geheime Format hmac unterstützt. Dieser Wert ist optional.
--from-literal, -l
Aktualisiert einen generischen geheimen Schlüssel auf der Basis eines Schlüssel/Wert-Paars. 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.
--key-path, --kp
Der Pfad zu Ihrer unverschlüsselten privaten SSH-Schlüsseldatei für ein SSH-Geheimnis. Wenn Sie einen persönlichen privaten SSH-Schlüssel verwenden, befindet sich diese Datei normalerweise in $HOME/.ssh/id_rsa (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\id_rsa (Windows). Dieser Wert ist optional.
--known-hosts-path, --khp
Der Pfad zu Ihrer Datei mit den bekannten Hosts für ein SSH-Geheimnis. Dieser Wert ist eine Sicherheitsfunktion und soll sicherzustellen, dass der private Schlüssel nur für die Authentifizierung bei Hosts verwendet wird, auf die Sie zuvor zugegriffen haben, insbesondere die GitHub- oder GitLab-Hosts. Diese Datei befindet sich normalerweise in $HOME/.ssh/known_hosts (Mac OS oder Linux) oder in %HOMEPATH%\.ssh\known_hosts (Windows). 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, --pw
Das Kennwort für einen Basisautor oder ein Registrierungsgeheimnis. 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, --spf
Der Pfad zu einer Datei, die das Kennwort für ein Basisautorisierungs- oder Registrierungsgeheimnis 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. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist optional.
--password-from-json-file, --spfj
Der Pfad zu einer JSON-Datei, die das Kennwort für eine Basisauthentifizierung oder ein Registrierungsgeheimnis 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. Sie müssen den Pfad zur Datei als Wert angeben. Dieser Wert ist optional.
--private-key-file, --pkf
Geben Sie mit der Option „ cert-chain-file “ eine Datei an, die den privaten Schlüssel für ein „ TLS “-Geheimnis enthält, das mit der angegebenen Zertifikatskette übereinstimmt. Sie müssen den Pfad zur Datei als Wert 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.
--rm
Entfernt ein einzelnes Schlüssel/Wert-Paar in einem generischen geheimen Schlüssel durch Angeben des Schlüsselnamens. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.
--secret-access-key, --sak
Geben Sie 'secret_access_key' für den HMAC-Berechtigungsnachweis an. Dieser Wert ist optional.
--secret-access-key-prompt
Aufforderung zur Eingabe von 'secret_access_key' für den HMAC-Berechtigungsnachweis. Dieser Wert ist optional. Der Standardwert ist false.
--server, -s
Die URL des Registrierungsservers für ein Registrierungsgeheimnis. Dieser Wert ist optional. Der Standardwert ist us.icr.io.
--username, -u
Der Benutzername für Ihre Basisauthentifizierung oder Ihr Registrierungsgeheimnis. Dieser Wert ist optional.

Beispiel

In diesem Beispiel wird ein TLS Geheimnis mit einem aktualisierten Zertifikat und privaten Schlüssel aktualisiert.

ibmcloud ce secret update --name mysecret-tls --cert-chain-file certificate2.txt --private-key-file privatekey2.txt

Beispielausgabe

Updating secret mysecret-tls..
OK

Cos-Subskriptionsbefehle

In verteilten Umgebungen ist es oftmals erwünscht, dass Anwendungen oder Jobs auf Nachrichten (Ereignisse) reagieren, die von anderen, zumeist als Ereignisproduzenten bezeichneten Komponenten generiert werden. Mit Code Engine können Ihre Anwendungen und Jobs relevante Ereignisse empfangen, indem Ereignisproduzenten abonniert werden. Ereignisinformationen werden für Anwendungen als POST-HTTP-Anforderungen und für Jobs als Umgebungsvariablen empfangen.

Der Ereignisproduzent Object Storage generiert Ereignisse, wenn Änderungen an den Objekten in Ihren Objektspeicherbuckets vorgenommen werden. Eine Anwendung kann beispielsweise Ereignisse empfangen, wenn Objekte zu einem Bucket hinzugefügt werden, und dann aufgrund dieser Änderung eine Aktion ausführen (z. B. die Verarbeitung dieses neuen Objekts).

Sie müssen sich im Kontext eines Projekts befinden, damit Sie subscription cos-Befehle verwenden können.

Weitere Informationen zur Arbeit mit den IBM Cloud Object Storage-Subskriptionen finden Sie unter Mit dem Ereignisproduzent IBM Cloud Object Storage arbeiten. Weitere Informationen zur Arbeit mit Subskriptionen in Code Engine finden Sie unter Erste Schritte mit Subskriptionen.

Sie können subscription oder sub in Ihren subscription cos-Befehlen verwenden. Führen Sie ibmcloud ce sub cos -h aus, um die CLI-Hilfe für den Befehl subscription cos anzuzeigen.

ibmcloud ce subscription cos create

Erstellt ein IBM Cloud Object Storage-Ereignisabonnement.

ibmcloud ce subscription cos create --name COS_SOURCE_NAME --destination DESTINATION_REF --bucket BUCKET_NAME [--destination-type DESTINATION_TYPE] [--event-type EVENT_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--path PATH] [--prefix PREFIX] [--quiet] [--suffix SUFFIX] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--bucket, -b

Der Bucket für Ereignisse. Das Ziel und der Bucket müssen sich in derselben Region des Projekts befinden. Dieser Wert ist erforderlich.

--destination, -d

Der Name der Anwendung oder Jobressource, die Ereignisse empfangen soll, z. B. myapp. Bei Bedarf können Sie ein Anwendungsziel mit der Option --path weiter qualifizieren. Dieser Wert ist erforderlich.

-n, --name

Der Name des IBM Cloud Object Storage-Ereignisabonnements. 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.

--destination-type, --dt
Der Typ des Ziels (Wert für destination). Gültige Werte sind app und job. Dieser Wert ist optional. Der Standardwert ist app.
--event-type, -e

Die Ereignistypen, die überwacht werden sollen. Gültige Werte sind delete, write und all. Dieser Wert ist optional. Der Standardwert ist all.

--extension, --ext

CloudEvents-Erweiterungen festlegen, die an das Ziel gesendet werden sollen. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue CloudEvents-Erweiterung hinzugefügt oder ein vorhandenes CloudEvent-Attribut überschrieben. Geben Sie eine Erweiterung pro --extension-Option an. Beispiel: --ext extA=A --ext extB=B. Dieser Wert ist optional.

--force, -f

Erzwingt die Erstellung eines IBM Cloud Object Storage-Ereignisabonnements. Mit dieser Option wird die Validierung des angegebenen Ziels übersprungen. Dieser Wert ist optional. Der Standardwert ist false.

--no-wait, --nw

Erstellt das IBM Cloud Object Storage-Ereignisabonnement und wartet nicht, bis das Abonnement bereit ist. Wenn Sie die Option --no-wait angeben, wird die Abonnementerstellung ohne Wartevorgang gestartet. Mit dem Befehl subscription cos get können Sie den Status des Abonnements ü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.

--path

Der Pfad in der mit destination angegebenen Anwendung, an den Ereignisse weitergeleitet werden. Beispiel: /events. Standardpfad ist die Stamm-URL der mit destination angegebenen Anwendung. Diese Option kann nur dann angegeben werden, wenn destination-type den Wert app aufweist. Dieser Wert ist optional.

--prefix, -p

Das Präfix des IBM Cloud Object Storage-Objekts. 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.

--suffix, -s

Das Suffix des IBM Cloud Object Storage-Objekts. Berücksichtigen Sie den Dateityp der Datei, wenn Sie das Suffix angeben. Dieser Wert ist optional.

--wait, -w

Erstellt das IBM Cloud Object Storage-Ereignisabonnement und wartet, bis das Abonnement bereit ist. Wenn Sie die Option --wait angeben, wird mit der Erstellung des Abonnements eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis das Abonnement den Status 'Bereit' ausweist. Falls das Abonnement innerhalb des durch --wait-timeout angegebenen Zeitraums nicht bereit ist, schlägt die Erstellung des IBM Cloud Object Storage-Ereignisabonnements fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Der Zeitraum in Sekunden, in dem gewartet werden soll, bis das Abonnement für IBM Cloud Object Storage-Ereignisse eingerichtet 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 15.

Beispiel

Von einem IBM Cloud Object Storage-Abonnement werden Änderungen an einem Object Storage-Bucket überwacht. Im folgenden Beispiel wird das COS-Abonnement mycosevent für den Bucket mybucket erstellt, der an die App myapp angehängt ist. Die Option --destination-type gibt den Typ des Ziels (destination) an. Bei diesem Typ kann es sich um app oder job handelt. In diesem Beispiel hat --destination-type den Wert app. Dies ist der Standardwert für diese Option. Das Ereignis wird mit der Option --path an den Pfad /events gesendet, sodass das Ereignis an https://<base application URL>/events gesendet wird.

ibmcloud ce subscription cos create --name mycosevent --destination myapp --bucket mybucket --destination-type app --path /events

Beispielausgabe

Creating COS source 'mycosevent'...
Run 'ibmcloud ce subscription cos get -n mycosevent' to check the COS source status.
OK

ibmcloud ce subscription cos delete

Löscht ein IBM Cloud Object Storage-Ereignisabonnement.

ibmcloud ce subscription cos delete --name COS_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--name, -n
Der Name des IBM Cloud Object Storage-Ereignisabonnements. 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öscht das IBM Cloud Object Storage-Ereignisabonnement und wartet nicht, bis das Abonnement gelöscht worden ist. Wenn Sie die Option --no-wait angeben, wird die Löschung des Abonnements ohne Wartevorgang gestartet. Mit dem Befehl subscription cos get können Sie den Status des Abonnements ü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
Löscht das IBM Cloud Object Storage-Ereignisabonnement und wartet, bis das Abonnement gelöscht worden ist. Wenn Sie die Option --wait angeben, wird mit der Löschung des Abonnements eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis die Anwendung den Status 'Bereit' aufweist. Dieser Befehl wird beendet, wenn das Abonnement gelöscht oder der Wert für --wait-timeout erreicht wird (das frühere der beiden Ereignisse beendet den Befehl). Dieser Wert ist optional. Der Standardwert ist true.
--wait-timeout, --wto
Der Zeitraum, der abgewartet werden soll, bis das IBM Cloud Object Storage-Ereignisabonnement gelöscht worden 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 15.

Beispiel

ibmcloud ce subscription cos delete --name mycosevent -f

Beispielausgabe

Deleting COS source 'mycosevent'...
OK

ibmcloud ce subscription cos get

Die Details eines IBM Cloud Object Storage-Ereignisabonnements anzeigen. Zu den angezeigten Attributen gehören Name, Destination, Bucket, Event Type, Prefix, Suffix, Ready und Age. Um bestimmte Details anzuzeigen, hängen Sie | grep <attribute> an.

ibmcloud ce subscription cos get --name COS_SOURCE_NAME [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des IBM Cloud Object Storage-Ereignisabonnements. 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 subscription cos get --name mycosevent

Beispielausgabe

Getting COS source 'mycosevent'...
OK
Name:          mycosevent
ID:            abcdefgh-abcd-abcd-abcd-fb6be2347a14  
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           12s  
Created:       2021-03-14T13:28:45-05:00  
Destination:  App:myapp
Bucket:       mybucket
EventType:    all
Ready:        true  
Conditions:    
    Type            OK    Age  Reason  
    CosConfigured   true  10s    
    Ready           true  10s    
    ReadyForEvents  true  10s    
    SinkProvided    true  10s    
Events:        
    Type    Reason          Age  Source                Messages  
    Normal  CosSourceReady  11s  cossource-controller  CosSource is ready

Wenn für Ready der Wert true festgelegt ist, ist das COS-Abonnement bereit, Ereignisse für Änderungen an einem COS-Bucket auszulösen.

ibmcloud ce subscription cos list

Listet alle IBM Cloud Object Storage-Ereignisabonnements in einem Projekt auf.

ibmcloud ce subscription cos list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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 subscription cos list

Beispielausgabe

Listing COS sources...
OK
Name        Age  Ready  Bucket        EventType  Prefix  Suffix  Destination
mycosevent  20m  true   mycosbucket  all                         http://myapp.2706b22d-676b.svc.cluster.local

ibmcloud ce subscription cos update

Aktualisiert ein IBM Cloud Object Storage-Ereignisabonnement.

ibmcloud ce subscription cos update --name COS_SOURCE_NAME [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--event-type EVENT_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--path PATH] [--prefix PREFIX] [--quiet] [--suffix SUFFIX]

Befehlsoptionen

--name, -n
Der Name des IBM Cloud Object Storage-Ereignisabonnements. Dieser Wert ist erforderlich.
--destination, -d
Der Name der Anwendung oder Jobressource, die Ereignisse empfangen soll, z. B. myapp. Bei Bedarf können Sie ein Anwendungsziel mit der Option --path weiter qualifizieren. Dieser Wert ist optional.
--destination-type, --dt
Der Typ des Ziels (Wert für destination). Gültige Werte sind app und job. Dieser Wert ist optional.
--event-type, -e
Die Ereignistypen, die überwacht werden sollen. Gültige Werte sind delete, write und all. Dieser Wert ist optional.
--extension, --ext
CloudEvents-Erweiterungen festlegen, die an das Ziel gesendet werden sollen. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue CloudEvents-Erweiterung hinzugefügt oder ein vorhandenes CloudEvent-Attribut überschrieben. Geben Sie eine Erweiterung pro --extension-Option an. Beispiel: --ext extA=A --ext extB=B. Dieser Wert ist optional.
--extension-rm, --ext-rm
Entfernt CloudEvents-Erweiterungen, die an das Ziel gesendet werden sollen, durch Angeben des Schlüsselnamens. Geben Sie eine Erweiterung pro --ext-rm-Option an. Beispiel: --ext-rm extA --ext-rm extB. 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.
--path
Der Pfad in der mit destination angegebenen Anwendung, an den Ereignisse weitergeleitet werden. Beispiel: /events. Standardpfad ist die Stamm-URL der mit destination angegebenen Anwendung. Diese Option kann nur dann angegeben werden, wenn destination-type den Wert app aufweist. Dieser Wert ist optional.
--prefix, -p
Das Präfix des IBM Cloud Object Storage-Objekts. 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.
--suffix, -s
Das Suffix des IBM Cloud Object Storage-Objekts. Berücksichtigen Sie den Dateityp der Datei (die Erweiterung), wenn Sie das Suffix angeben. Dieser Wert ist optional.

Beispiel

Im folgenden Beispiel wird das COS-Abonnement mycosevent aktualisiert, damit von ihm nur Schreibvorgänge überwacht werden.

ibmcloud ce subscription cos update --name mycosevent --event-type write

Beispielausgabe

Updating COS source 'mycosevent'...
Run 'ibmcloud ce subscription cos get -n mycosevent' to check the COS source status.
OK

Cron-Befehle für Subskriptionen

In verteilten Umgebungen ist es oftmals erwünscht, dass Anwendungen oder Jobs auf Nachrichten (Ereignisse) reagieren, die von anderen, zumeist als Ereignisproduzenten bezeichneten Komponenten generiert werden. Mit Code Engine können Ihre Anwendungen und Jobs relevante Ereignisse empfangen, indem Ereignisproduzenten abonniert werden. Ereignisinformationen werden für Anwendungen als POST-HTTP-Anforderungen und für Jobs als Umgebungsvariablen empfangen.

Der Cron-Ereignisproduzent basiert auf Cron und generiert in regelmäßigen Intervallen ein Ereignis. Verwenden Sie einen Cron-Ereignisproduzenten, wenn eine Aktion in genau definierten Intervallen oder zu bestimmten Zeitpunkten ausgeführt werden muss.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie subscription cron-Befehle verwenden können.

Weitere Informationen zur Arbeit mit den IBM Cloud Object Storage-Subskriptionen finden Sie unter Mit dem Ereignisproduzent für periodische Zeitgeber (Cron) arbeiten. Weitere Informationen zur Arbeit mit Subskriptionen in Code Engine finden Sie unter Erste Schritte mit Subskriptionen.

Sie können subscription oder sub in Ihren subscription cron-Befehlen verwenden. Führen Sie ibmcloud ce sub cron -h aus, um die CLI-Hilfe für den Befehl subscription cron anzuzeigen.

ibmcloud ce subscription cron create

Erstellt ein Cron-Ereignisabonnement.

ibmcloud ce subscription cron create --name CRON_SOURCE_NAME  --destination DESTINATION_REF [--content-type CONTENT_TYPE] [--data DATA] [--data-base64 DATA_BASE64] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--path PATH] [--quiet] [--schedule SCHEDULE] [--time-zone TIME_ZONE] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--destination, -d

Der Name der Anwendung oder Jobressource, die Ereignisse empfangen soll, z. B. myapp. Bei Bedarf können Sie ein Anwendungsziel mit der Option --path weiter qualifizieren. Dieser Wert ist erforderlich.

-n, --name

Der Name des Cron-Ereignisabonnements. 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.

--content-type, --ct
Der Medientyp der Option --data oder --data-base64. Beispiele sind application/json, application/x-www-form-urlencoded, text/html und text/plain. Dieser Wert ist optional.
--da, --data

Die Daten, die an das Ziel gesendet werden sollen, z. B. '{ "message": "Hello world!" }'. Wenn Sie die Option --data angeben, verwenden Sie nicht die Option --data-base64.

Dieser Wert ist optional.

--data-base64, --db
Die mit Base64 codierten Daten, die an das Ziel gesendet werden sollen (z. B. Q29kZSBFbmdpbmU=). Wenn Sie die Option --data-base64 angeben, verwenden Sie nicht die Option --data. Dieser Wert ist optional.
--destination-type, --dt

Der Typ des Ziels (Wert für destination). Gültige Werte sind app, function und job. Dieser Wert ist optional. Der Standardwert ist app.

--extension, --ext

CloudEvents-Erweiterungen festlegen, die an das Ziel gesendet werden sollen. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue CloudEvents-Erweiterung hinzugefügt oder ein vorhandenes CloudEvent-Attribut überschrieben. Geben Sie eine Erweiterung pro --extension-Option an. Beispiel: --ext extA=A --ext extB=B. Dieser Wert ist optional.

--force, -f

Erzwingt die Erstellung eines Cron-Ereignisabonnements. Mit dieser Option wird die Validierung des angegebenen Ziels übersprungen. Dieser Wert ist optional. Der Standardwert ist false.

--no-wait, --nw

Erstellt das Cron-Ereignisabonnement und wartet nicht, bis das Abonnement bereit ist. Wenn Sie die Option --no-wait angeben, wird die Abonnementerstellung ohne Wartevorgang gestartet. Mit dem Befehl subscription cron get können Sie den Status des Abonnements ü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.

--path

Der Pfad in der mit destination angegebenen Anwendung, an den Ereignisse weitergeleitet werden. Beispiel: /events. Standardpfad ist die Stamm-URL der mit destination angegebenen Anwendung. Diese Option kann nur dann angegeben werden, wenn destination-type den Wert app aufweist. 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.

--schedule, -s

Die Planung für die Häufigkeit der Ereignisauslösungen im Crontab-Format. Geben Sie zum Beispiel für ein Intervall von zwei Minuten '*/2 * * * *' (im Zeichenfolgeformat) an. Standardmäßig wird das Cron-Ereignis jede Minute ausgelöst und ist auf die Zeitzone UTC gesetzt. Wenn Sie die Zeitzone ändern möchten, verwenden Sie die Option --time-zone. Dieser Wert ist optional.

--time-zone, --tz

Legt die Zeitzone für Ihr Cron-Ereignis fest, z. B. Asia/Tokyo. Wenn Sie die Option --schedule angeben, verwenden Sie diese Option, um die Zeitzone anzugeben. Gültige Zeitzonenwerte finden Sie in der Zeitzonendatenbank. Dieser Wert ist optional. Der Standardwert ist UTC.

--wait, -w

Erstellt das Cron-Ereignisabonnement und wartet, bis das Abonnement bereit ist. Wenn Sie die Option --wait angeben, wird mit der Erstellung des Abonnements eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis das Abonnement den Status 'Bereit' ausweist. Wenn das Abonnement innerhalb des mit --wait-timeout angegebenen Zeitraums nicht bereit ist, schlägt die Erstellung des Cron-Ereignisabonnements fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Gibt an, wie viele Sekunden darauf gewartet werden soll, dass das Cron-Ereignisabonnement 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 15.

Beispiel

Im folgenden Beispiel wird ein Cron-Abonnement namens mycronevent erstellt, mit dem ein Cron-Ereignis alle 2 Minuten an einen Job namens myjob weitergeleitet wird.

ibmcloud ce subscription cron create --name mycronevent --destination myjob --schedule '*/2 * * * *' --destination-type job

Beispielausgabe

Creating cron source 'mycronevent'...
Run 'ibmcloud ce subscription cron get -n mycronevent' to check the cron source status.
OK

ibmcloud ce subscription cron delete

Löscht ein Cron-Ereignisabonnement.

ibmcloud ce subscription cron delete --name CRON_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--name, -n
Der Name des Cron-Ereignisabonnements. 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öscht das Cron-Ereignisabonnement und wartet nicht, bis das Abonnement gelöscht worden ist. Wenn Sie die Option --no-wait angeben, wird die Löschung des Abonnements ohne Wartevorgang gestartet. Mit dem Befehl subscription cron get können Sie den Status des Abonnements ü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
Löscht das Cron-Ereignisabonnement und wartet, bis das Abonnement gelöscht worden ist. Wenn Sie die Option --wait angeben, wird mit der Löschung des Abonnements eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis die Anwendung den Status 'Bereit' aufweist. Dieser Befehl wird beendet, wenn das Abonnement gelöscht oder der Wert für --wait-timeout erreicht wird (das frühere der beiden Ereignisse beendet den Befehl). Dieser Wert ist optional. Der Standardwert ist true.
--wait-timeout, --wto
Gibt an, wie viele Sekunden darauf gewartet werden soll, dass das Cron-Ereignisabonnement gelöscht worden 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 15.

Beispiel

ibmcloud ce subscription cron delete --name mycronevent -f

Beispielausgabe

Deleting cron source 'mycronevent'...
OK

ibmcloud ce subscription cron get

Zeigt Details zu einem Cron-Ereignisabonnement an.

ibmcloud ce subscription cron get --name CRON_SOURCE_NAME [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des Cron-Ereignisabonnements. 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 subscription cron get --name mycronevent

Beispielausgabe

Getting cron source 'mycronevent'...
OK
Name:          mycronevent  
ID:            abcdefgh-abcd-abcd-abcd-fb6be2347a14  
Project Name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           18s  
Created:       2021-03-14T13:33:53-05:00  
Destination:  App:kapp  
Schedule:     */2 * * * *  
Time Zone:    UTC  
Ready:        true
Events:    
    Type     Reason           Age                Source                 Messages  
    Normal   FinalizerUpdate  19s                pingsource-controller  Updated "mycronevent" finalizers

Wenn für Ready der Wert true angezeigt wird, ist das Cron-Abonnement zum Auslösen von Ereignissen nach dem angegebenem Zeitplan bereit.

ibmcloud ce subscription cron list

Listet alle Cron-Ereignisabonnements in einem Projekt auf.

ibmcloud ce subscription cron list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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 subscription cron list

Beispielausgabe

Listing cron sources...
OK
Name         Age  Ready  Destination                                   Schedule     Data
mycronevent  96m  true   http://myapp.cd4200a7-5037.svc.cluster.local  */2 * * * *

ibmcloud ce subscription cron update

Aktualisiert ein Cron-Ereignisabonnement.

ibmcloud ce subscription cron update --name CRON_SOURCE_NAME [--content-type CONTENT_TYPE] [--data DATA] [--data-base64 DATA_BASE64] [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--path PATH] [--quiet] [--schedule SCHEDULE] [--time-zone TIME_ZONE]

Befehlsoptionen

--name, -n

Der Name des Cron-Ereignisabonnements. Dieser Wert ist erforderlich.

--content-type, --ct

Der Medientyp der Option --data oder --data-base64. Beispiele sind application/json, application/x-www-form-urlencoded, text/html und text/plain. Dieser Wert ist optional.

--da, --data

Die Daten, die an das Ziel gesendet werden sollen, z. B. '{ "message": "Hello world!" }'. Wenn Sie die Option --data angeben, verwenden Sie nicht die Option --data-base64.

Dieser Wert ist optional.

--data-base64, --db
Die mit Base64 codierten Daten, die an das Ziel gesendet werden sollen (z. B. Q29kZSBFbmdpbmU=). Wenn Sie die Option --data-base64 angeben, verwenden Sie nicht die Option --data. Dieser Wert ist optional.
--destination, -d

Der Name der Anwendung oder Jobressource, die Ereignisse empfangen soll, z. B. myapp. Bei Bedarf können Sie ein Anwendungsziel mit der Option --path weiter qualifizieren. Dieser Wert ist optional.

--destination-type, --dt

Der Typ des Ziels (Wert für destination). Gültige Werte sind app, function und job. Dieser Wert ist optional.

--extension, --ext

CloudEvents-Erweiterungen festlegen, die an das Ziel gesendet werden sollen. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue CloudEvents-Erweiterung hinzugefügt oder ein vorhandenes CloudEvent-Attribut überschrieben. Geben Sie eine Erweiterung pro --extension-Option an. Beispiel: --ext extA=A --ext extB=B. Dieser Wert ist optional.

--extension-rm, --ext-rm

Entfernt CloudEvents-Erweiterungen, die an das Ziel gesendet werden sollen, durch Angeben des Schlüsselnamens. Geben Sie eine Erweiterung pro --ext-rm-Option an. Beispiel: --ext-rm extA --ext-rm extB. 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.

--path

Der Pfad in der mit destination angegebenen Anwendung, an den Ereignisse weitergeleitet werden. Beispiel: /events. Standardpfad ist die Stamm-URL der mit destination angegebenen Anwendung. Diese Option kann nur dann angegeben werden, wenn destination-type den Wert app aufweist. 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.

--schedule, -s

Die Planung für die Häufigkeit der Ereignisauslösungen im Crontab-Format. Geben Sie zum Beispiel für ein Intervall von zwei Minuten '*/2 * * * *' (im Zeichenfolgeformat) an. Standardmäßig wird das Cron-Ereignis jede Minute ausgelöst und ist auf die Zeitzone UTC gesetzt. Wenn Sie die Zeitzone ändern möchten, verwenden Sie die Option --time-zone. Dieser Wert ist optional.

--time-zone, --tz

Legt die Zeitzone für Ihr Cron-Ereignis fest, z. B. Asia/Tokyo. Wenn Sie die Option --schedule angeben, verwenden Sie diese Option, um die Zeitzone anzugeben. Gültige Zeitzonenwerte finden Sie in der Zeitzonendatenbank. Dieser Wert ist optional.

Beispiel

Im folgenden Beispiel wird ein Cron-Quellenabonnement namens mycronevent erstellt, mit dem ein Cron-Ereignis einmal pro Stunde an einen Job namens myjob weitergeleitet wird.

ibmcloud ce subscription cron update --name mycronevent --destination myjob --schedule '0 * * * *' --destination-type job

Beispielausgabe

Updating cron source 'mycronevent'...
Run 'ibmcloud ce subscription cron get -n mycronevent' to check the cron source status.
OK

Abonnement kafka Befehle

In verteilten Umgebungen ist es oftmals erwünscht, dass Anwendungen oder Jobs auf Nachrichten (Ereignisse) reagieren, die von anderen, zumeist als Ereignisproduzenten bezeichneten Komponenten generiert werden. Mit Code Engine können Ihre Anwendungen und Jobs relevante Ereignisse empfangen, indem Ereignisproduzenten abonniert werden. Ereignisinformationen werden für Anwendungen als POST-HTTP-Anforderungen und für Jobs als Umgebungsvariablen empfangen.

Der Kafka Event Producer überwacht das Erscheinen neuer Nachrichten in einer Kafka Instanz. Wenn Sie ein Code Engine Kafka Abonnement für eine Gruppe von Themen erstellen, erhält Ihre Anwendung oder Ihr Auftrag ein separates Ereignis für jede neue Nachricht, die in einem der Themen erscheint.

Sie müssen sich im Kontext eines Projekts befinden, damit Sie subscription kafka-Befehle verwenden können.

Weitere Informationen zur Arbeit mit Kafka Ereignisabonnements finden Sie unter Arbeiten mit dem Kafka event producer. Weitere Informationen zur Arbeit mit Subskriptionen in Code Engine finden Sie unter Erste Schritte mit Subskriptionen.

Sie können subscription oder sub in Ihren subscription kafka-Befehlen verwenden. Um die CLI-Hilfe zu den Befehlen „ subscription “ anzuzeigen, führen Sie „ ibmcloud ce sub kafka -h “ aus.

ibmcloud ce subscription kafka create

Erstellen Sie ein Abonnement für das Ereignis „ Kafka “.

ibmcloud ce subscription kafka create --name KAFKA_SOURCE_NAME --destination DESTINATION_REF --topic TOPIC --broker BROKER [--consumer-group CONSUMER_GROUP] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--password PASSWORD] [--path PATH] [--quiet] [--secret SECRET] [--username USERNAME] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--broker, -b

Stellen Sie einen Makler in der Quelle Kafka ein. Ein Broker ist ein Kafka Server, mit dem sich der Verbraucher verbindet. Diese Option kann mehrmals angegeben werden. Dieser Wert ist erforderlich.

--destination, -d

Der Name der Anwendung oder Jobressource, die Ereignisse empfangen soll, z. B. myapp. Bei Bedarf können Sie ein Anwendungsziel mit der Option --path weiter qualifizieren. Dieser Wert ist erforderlich.

-n, --name

Der Name des Abonnements für das Ereignis „ Kafka “. 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.

--topic, -t
Legen Sie ein Thema in der Quelle Kafka fest. Themen werden verwendet, um die zu konsumierenden Nachrichten zu filtern. Diese Option kann mehrmals angegeben werden. Dieser Wert ist erforderlich.
--consumer-group, --cg

Der Name der Konsumentengruppe für Ereignisse. Dieser Wert ist optional.

--destination-type, --dt

Der Typ des Ziels (Wert für destination). Gültige Werte sind app und job. Dieser Wert ist optional. Der Standardwert ist app.

--extension, --ext

CloudEvents-Erweiterungen festlegen, die an das Ziel gesendet werden sollen. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue CloudEvents-Erweiterung hinzugefügt oder ein vorhandenes CloudEvent-Attribut überschrieben. Geben Sie eine Erweiterung pro --extension-Option an. Beispiel: --ext extA=A --ext extB=B. Dieser Wert ist optional.

--force, -f

Erzwingen Sie die Erstellung eines Abonnements für das Ereignis „ Kafka “. Mit dieser Option wird die Überprüfung des angegebenen Ziels und des Geheimnisses übersprungen. Dieser Wert ist optional. Der Standardwert ist false.

--no-wait, --nw

Erstellen Sie das Ereignisabonnement „ Kafka “ und warten Sie nicht, bis das Abonnement bereit ist. Wenn Sie die Option --no-wait angeben, wird die Abonnementerstellung ohne Wartevorgang gestartet. Mit dem Befehl subscription kafka get können Sie den Status des Abonnements ü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.

--password, -p

Das Kennwort, das für die Authentifizierung bei der Kafka -Instanz verwendet wird. Wenn Sie die Option „ --password “ angeben, dürfen Sie die Option „ --secret “ nicht angeben. Dieser Wert ist optional.

--path

Der Pfad in der mit destination angegebenen Anwendung, an den Ereignisse weitergeleitet werden. Beispiel: /events. Standardpfad ist die Stamm-URL der mit destination angegebenen Anwendung. Diese Option kann nur dann angegeben werden, wenn destination-type den Wert app aufweist. 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.

--secret, -s

Der Name des Geheimnisses, das zur Authentifizierung bei der „ Kafka “-Instanz verwendet wird und sowohl den Schlüssel „ username “ als auch den Schlüssel „ password “ enthält. Wenn Sie die Option „ --secret “ angeben, dürfen Sie die Optionen „ --username “ oder „ --password “ nicht angeben. Dieser Wert ist optional.

--username, -u

Der Benutzername, der für die Authentifizierung bei der Kafka-Instanz verwendet wird. Wenn Sie die Option „ --username “ angeben, müssen Sie die Option „ --password “ angeben und dürfen die Option „ --secret “ nicht angeben. Dieser Wert ist optional. Der Standardwert ist token.

--wait, -w

Erstellen Sie das Ereignisabonnement „ Kafka “ und warten Sie, bis das Abonnement bereit ist. Wenn Sie die Option --wait angeben, wird mit der Erstellung des Abonnements eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis das Abonnement den Status 'Bereit' ausweist. Wenn das Abonnement nicht innerhalb des angegebenen Zeitraums --wait-timeout bereitsteht, schlägt die Erstellung des Ereignisabonnements Kafka fehl. Dieser Wert ist optional. Der Standardwert ist true.

--wait-timeout, --wto

Die Wartezeit in Sekunden, bis das Abonnement für das Ereignis „ Kafka “ 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 120.

Beispiel

Das folgende Beispiel erstellt ein Kafka Ereignisabonnement mit dem Namen mykafkaevent, das ein Kafka Ereignis an eine empfangende App mit dem Namen kafka-receiver-app weiterleitet. Geben Sie eine --broker Option für jeden Makler für Ihr Thema an. Die Option --destination gibt die Ressource Code Engine an, die die Ereignisse empfängt. Die kafka-subscription-secret stellt Anmeldeinformationen für den Zugriff auf den Message Broker bereit.

ibmcloud ce subscription kafka create --name mykafkasubscription --destination kafka-receiver-app --secret kafka-subscription-secret --topic kafka-topic1 --broker broker-3-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-5-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker  broker-0-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-1-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-4-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-2-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093

Beispielausgabe

Creating Kafka event subscription 'mykafkasubscription'...
Run 'ibmcloud ce subscription kafka get -n mykafkasubscription' to check the Kafka event subscription status.
OK

ibmcloud ce subscription kafka delete

Ein Abonnement für ein „ Kafka “-Ereignis löschen.

ibmcloud ce subscription kafka delete --name KAFKA_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Befehlsoptionen

--name, -n
Der Name des Abonnements für das Ereignis „ Kafka “. 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 das Ereignisabonnement „ Kafka “ und warten Sie nicht, bis das Abonnement gelöscht ist. Wenn Sie die Option --no-wait angeben, wird die Löschung des Abonnements ohne Wartevorgang gestartet. Mit dem Befehl subscription kafka get können Sie den Status des Abonnements ü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
Löschen Sie das Ereignisabonnement „ Kafka “ und warten Sie, bis das Abonnement gelöscht wurde. Wenn Sie die Option --wait angeben, wird mit der Löschung des Abonnements eine maximale Zeit in Sekunden gewartet, die durch die Option --wait-timeout festgelegt wurde, bis die Anwendung den Status 'Bereit' aufweist. Dieser Befehl wird beendet, wenn das Abonnement gelöscht oder der Wert für --wait-timeout erreicht wird (das frühere der beiden Ereignisse beendet den Befehl). Dieser Wert ist optional. Der Standardwert ist true.
--wait-timeout, --wto
Die Wartezeit in Sekunden, bis das Abonnement für das Ereignis „ Kafka “ 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 15.

Beispiel

ibmcloud ce subscription kafka delete --name mykafkasubscription -f

Beispielausgabe

Deleting Kafka event subscription 'mykafkasubscription'...
OK

ibmcloud ce subscription kafka get

Details zu einem „ Kafka “-Ereignisabonnement anzeigen.

ibmcloud ce subscription kafka get --name KAFKA_SOURCE_NAME [--output OUTPUT] [--quiet]

Befehlsoptionen

--name, -n
Der Name des Abonnements für das Ereignis „ Kafka “. 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 subscription kafka get --name mykafkasubscription

Beispielausgabe

Getting Kafka event subscription 'mykafkasubscription'...
OK
Name:          mykafkasubscription  
[...]
Destination Type:                 app
Destination:                      kafka-receiver-app2
Brokers:
broker-3-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-5-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-0-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-1-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-4-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-2-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
Consumer Group:                   knative-kafka-source-a4072fe1-1dfa-4470-9d07-bf7a0ff8e340
Topics:
kafka-topic1
Secret key reference (user):      kafka-subscription-secret.username
Secret key reference (password):  kafka-subscription-secret.password
Ready:                            true
Conditions:
Type                     OK    Age  Reason
ConnectionEstablished    true  24s
InitialOffsetsCommitted  true  24s
Ready                    true  24s
Scheduled                true  24s
SinkProvided             true  24s
Events:
Type     Reason           Age  Source                  Messages
Normal   FinalizerUpdate  26s  kafkasource-controller  Updated "mykafkasubscription" finalizers

Wenn Ready auf true verweist, ist das Abonnement „ Kafka “ bereit, Ereignisse gemäß dem festgelegten Zeitplan auszulösen.

ibmcloud ce subscription kafka list

Alle „ Kafka “-Ereignisabonnements in einem Projekt auflisten.

ibmcloud ce subscription kafka list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

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 subscription kafka list

Beispielausgabe

Listing Kafka event subscriptions...
OK
Name                 Age  Ready  Destination Type  Destination          Path  Consumer Group                                             Reason  
mykafkasubscription  94s  true   app               kafka-receiver-app        knative-kafka-source-dc367965-15e4-44f3-bedf-25d453524a68

ibmcloud ce subscription kafka update

Ein Abonnement für ein „ Kafka “-Ereignis aktualisieren.

ibmcloud ce subscription kafka update --name KAFKA_SOURCE_NAME [--broker BROKER] [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--password PASSWORD] [--path PATH] [--quiet] [--secret SECRET] [--topic TOPIC] [--username USERNAME]

Befehlsoptionen

--name, -n
Der Name des Abonnements für das Ereignis „ Kafka “. Dieser Wert ist erforderlich.
--broker, -b
Stellen Sie einen Makler in der Quelle Kafka ein. Ein Broker ist ein Kafka Server, mit dem sich der Verbraucher verbindet. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.
--destination, -d
Der Name der Anwendung oder Jobressource, die Ereignisse empfangen soll, z. B. myapp. Bei Bedarf können Sie ein Anwendungsziel mit der Option --path weiter qualifizieren. Dieser Wert ist optional.
--destination-type, --dt
Der Typ des Ziels (Wert für destination). Gültige Werte sind app und job. Dieser Wert ist optional.
--extension, --ext
CloudEvents-Erweiterungen festlegen, die an das Ziel gesendet werden sollen. Der Wert muss im Format NAME=VALUE angegeben werden. Durch diese Aktion wird eine neue CloudEvents-Erweiterung hinzugefügt oder ein vorhandenes CloudEvent-Attribut überschrieben. Geben Sie eine Erweiterung pro --extension-Option an. Beispiel: --ext extA=A --ext extB=B. Dieser Wert ist optional.
--extension-rm, --ext-rm
Entfernt CloudEvents-Erweiterungen, die an das Ziel gesendet werden sollen, durch Angeben des Schlüsselnamens. Geben Sie eine Erweiterung pro --ext-rm-Option an. Beispiel: --ext-rm extA --ext-rm extB. 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, das für die Authentifizierung bei der Kafka -Instanz verwendet wird. Wenn Sie die Option „ --password “ angeben, dürfen Sie die Option „ --secret “ nicht angeben. Dieser Wert ist optional.
--path
Der Pfad in der mit destination angegebenen Anwendung, an den Ereignisse weitergeleitet werden. Beispiel: /events. Standardpfad ist die Stamm-URL der mit destination angegebenen Anwendung. Diese Option kann nur dann angegeben werden, wenn destination-type den Wert app aufweist. 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.
--secret, -s
Der Name des Geheimnisses, das zur Authentifizierung bei der „ Kafka “-Instanz verwendet wird und sowohl den Schlüssel „ username “ als auch den Schlüssel „ password “ enthält. Wenn Sie die Option „ --secret “ angeben, dürfen Sie die Optionen „ --username “ oder „ --password “ nicht angeben. Dieser Wert ist optional.
--topic, -t
Legen Sie ein Thema in der Quelle Kafka fest. Themen werden verwendet, um die zu konsumierenden Nachrichten zu filtern. Diese Option kann mehrmals angegeben werden. Dieser Wert ist optional.
--username, -u
Der Benutzername, der für die Authentifizierung bei der Kafka-Instanz verwendet wird. Wenn Sie die Option „ --username “ angeben, müssen Sie die Option „ --password “ angeben und dürfen die Option „ --secret “ nicht angeben. Dieser Wert ist optional. Der Standardwert ist token.

Beispiel

Das folgende Beispiel aktualisiert ein Kafka-Ereignisabonnement, um kafka-topic2 anstelle von kafka-topic1 zu verwenden.

ibmcloud ce subscription kafka update --name mykafkasubscription --topic kafka-topic2

Beispielausgabe

Updating Kafka event subscription 'mykafkasubscription'...
Run 'ibmcloud ce subscription kafka get -n mykafkasubscription' to check the Kafka event subscription status.
OK

Befehl für die Version

Version der Befehlszeilenschnittstelle von code-engine anzeigen.

ibmcloud ce version

Version der Befehlszeilenschnittstelle von code-engine anzeigen.

ibmcloud ce version [--quiet]

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 version

Beispielausgabe

version:  v1.17.0
commit:   3ab130b746f4784c9ff8d3da7bb05b6e7acda6d5