IBM Cloud CLI Developer Tools-Befehle (ibmcloud dev)

Die Befehlszeilenschnittstelle IBM Cloud® enthält die Befehle Developer Tools (ibmcloud dev) zur Verwaltung von klassischen Pipelines, Tekton-Pipelines und Toolchains.

Hilfe

Wenn keine Aktion oder keine Argumente übergeben werden oder wenn die Aktion 'help' angegeben wird, zeigt dieser Befehl standardmäßig einen allgemeinen Hilfetext an. Allgemeine Hilfetexte enthalten eine Beschreibung der Basisargumente sowie eine Liste der verfügbaren Aktionen.

Führen Sie den folgenden Befehl aus, um allgemeine Hilfeinformationen anzuzeigen:

ibmcloud dev help

pipeline-get

Details einer klassischen Pipeline anzeigen.

ibmcloud dev pipeline-get [PIPELINE_ID] [--output JSON]

Parameter des Befehls 'pipeline-get'

json

  • Parameter, der zum Ausgeben der Pipelinedetails im JSON-Format verwendet wird.
  • Verwendung: ibmcloud dev pipeline-get [PIPELINE_ID] --output JSON

Der folgende Parameter kann mit dem Befehl pipeline-get oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev pipeline-get [PIPELINE_ID] --trace

pipeline-run

Eine klassische Pipeline ausführen.

ibmcloud dev pipeline-run [PIPELINE_ID] [--stage-id stageID] [--output JSON]

Parameter des Befehls 'pipeline-run'

Die folgenden Parameter können mit dem Befehl pipeline-run oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

stage-id

  • Optionaler Parameter zum Auswählen der auszuführenden Pipeline-Stage.
  • Verwendung: ibmcloud dev pipeline-run [PIPELINE_ID] --stage-id [stageID]

json

  • Parameter, der zum Ausgaben der Aufrufdetails der Pipeline im JSON-Format verwendet wird.
  • Verwendung: ibmcloud dev pipeline-run [PIPELINE_ID] --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev pipeline-run [PIPELINE_ID] --trace

pipeline-log

Mithilfe des Befehls pipeline-log aktuelle Protokolle einer klassischen Pipeline anzeigen.

  • Wenn die Pipeline-ID als Argument angegeben wird, werden alle Protokolle für alle Jobs in allen Stages für diese Pipeline gedruckt.
  • Wenn das Flag für die Stage-ID gefüllt ist, werden die Protokolle anhand dieser Stage in der Pipeline gefiltert.
  • Wenn die Job-ID mit der Stage-ID angegeben wird, werden die Protokolle allein nach dem Job in der Stage gefiltert.
  • Wenn die Jobausführungs-ID zusammen mit der Stage-ID und der Job-ID angegeben wird, wird eine Suche unter allen verfügbaren Protokollen durchgeführt, die mit der angegebenen Jobausführungs-ID übereinstimmen.

Verwendung:

ibmcloud dev pipeline-log [PIPELINE_ID] [--stage-id stageID] [--job-id jobID] [--job-exec-id jobExecutionID]

Parameter des Befehls 'pipeline-log'

Die folgenden Parameter können mit dem Befehl pipeline-log oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

job-id

  • Parameter, mit dem die Protokolle anhand der Job-ID gefiltert werden.
  • Erfordert das Flag stage-id.
  • Verwendung: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID]

job-exec-id

  • Parameter, mit dem die Protokolle anhand der Jobausführungs-ID gefiltert werden.
  • Erfordert das Flag stage-id.
  • Erfordert das Flag job-id.
  • Verwendung: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID] --job-exec-id [jobExecutionID]

stage-id

  • Parameter, mit dem die Protokolle anhand der Stage-ID gefiltert werden.
  • Verwendung: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID]

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev pipeline-log [PIPELINE_ID] --trace

pipeline-open

Mit dem Befehl pipeline-open die URL für die klassische Pipeline anzeigen. Mit dem Befehl pipeline-open wird die URL auch in Ihrem Standardbrowser geöffnet.

ibmcloud dev pipeline-open [PIPELINE_ID]

Parameter des Befehls 'pipeline-open'

Der folgende Parameter kann mit dem Befehl pipeline-open oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev pipeline-open [PIPELINE_ID] --trace

tekton-info

Zeigt die Details einer Tekton-Pipeline an.

ibmcloud dev tekton-info [PIPELINE_ID] [--verbose][--output JSON]

Parameter für den Befehl 'tekton-info'

Die folgenden Parameter können mit dem Befehl tekton-info verwendet werden.

verbose

  • Verwenden Sie diesen Parameter, um alle Details einer Pipeline im JSON-Format anzugeben.
  • Verwendung: ibmcloud dev tekton-info [PIPELINE_ID] --verbose

json

  • Parameter, der zum Ausgeben der Pipelinedetails im JSON-Format verwendet wird.
  • Verwendung: ibmcloud dev tekton-info [PIPELINE_ID] --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev tekton-info [PIPELINE_ID] --trace

tekton-logs

Mit dem Befehl tekton-logs können Sie Protokolle für die letzten Ausführungen der Tekton-Pipeline anzeigen.

  • Die ID für die Pipelineausführung ist ein erforderliches Argument.
  • Wenn der Taskname als Argument angegeben wird, werden nur die Protokolle für diese Task abgerufen.

Verwendung:

ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] [--task-name taskName] [--output JSON]

Parameter für den Befehl 'tekton-logs'

Die folgenden Parameter können mit dem Befehl tekton-logs verwendet werden.

run-id (erforderlich)

  • Ein Parameter, der den Pipelinelauf für den Protokollabruf identifiziert.
  • Verwendung: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID]

task-name

  • Mit diesem Parameter werden die Protokolle anhand des Tasknamens für die Pipelineausführung gefiltert.
  • Verwendung: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --task-name [taskName]

json

  • Mit diesem Parameter werden die Protokolldetails im JSON-Format ausgegeben.
  • Verwendung: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipeline-abbrechen

Bricht eine laufende Tekton-Pipelineausführung ab

ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] [--trace]`

tekton-pipeline-cancel, Befehlsparameter

Die folgenden Parameter können mit dem Befehl tekton-pipeline-cancel verwendet werden.

run-id (erforderlich)

  • Ein Parameter, der den abzubrechenden Pipelinelauf identifiziert.
  • Verwendung: ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID]

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelinerun

Zeigen Sie die Details einer Tekton-Pipeline an oder verwenden Sie den Parameter ls, um alle Pipelineausführungen für die Pipeline aufzulisten.

Verwendung:

ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] [--output JSON]
ibmcloud dev tekton-pipelinerun ls [PIPELINE_ID]

Parameter für den Befehl 'tekton-pipelinerun'

Die folgenden Parameter können mit dem Befehl tekton-pipelinerun verwendet werden.

run-id (erforderlich)

  • Dieser Parameter gibt die abzurufende Pipelineausführung an.
  • Verwendung: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID]

json

  • Mit diesem Parameter werden die Details für die Pipelineausführung im JSON-Format ausgegeben.
  • Verwendung: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelineruns

Zeigt eine Liste der Pipelineausführungen für eine Tekton-Pipeline an.

Verwendung:

ibmcloud dev tekton-pipelineruns [PIPELINE_ID] [--output JSON]

Parameter für den Befehl 'tekton-pipelineruns'

Die folgenden Parameter können mit dem Befehl tekton-pipelineruns verwendet werden.

json

  • Mit diesem Parameter werden die Pipelineausführungen im JSON-Format ausgegeben.
  • Verwendung: ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --trace

tekton-trigger

Führt eine Tekton-Pipeline aus.

Verwendung:

ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName [--description "a description"] [--trigger-properties propertiesJSON] [--secure-trigger-properties securePropertiesJSON] [--trigger-headers headerJSON] [--trigger-body bodyJSON] [--output JSON]

Parameter für den Befehl 'tekton-trigger'

Die folgenden Parameter können mit dem Befehl tekton-trigger verwendet werden.

trigger-name (erforderlich)

  • Mit diesem Parameter geben Sie den auszuführenden Auslöser an.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName

description (fakultativ)

  • Optional. Verwenden Sie diesen Parameter, um eine Beschreibung für den erstellten Tekton pipelineRun anzugeben.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --description "My description"

trigger-properties (fakultativ)

  • Optional. Verwenden Sie diesen Parameter, um definierte Auslösereigenschaften zu überschreiben oder anzuhängen. Beispiel:'{"pipeline-debug":"true"}'.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-properties propertiesJSON

secure-trigger-properties (fakultativ)

  • Optional. Verwenden Sie diesen Parameter, um definierte Auslösereigenschaften zu überschreiben oder anzuhängen, deren Werte in späteren Ausgaben hinter Punkten oder Sternen verborgen sein sollten. Beispiel: '{"deployer-api-key":"s0mEThING_v3Ry_s3CReT"}'
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON

trigger-headers (fakultativ)

  • Optional. Verwenden Sie diesen Parameter, um die Kopfzeilen anzugeben, die in triggerBinding eines Tekton pipelineRun verwendet werden. Beispiel:'{"source":"cli","flag":"enable"}'.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-headers headerJSON

trigger-body (fakultativ)

  • Optional. Verwenden Sie diesen Parameter, um den Hauptteil anzugeben, der in triggerBinding einer Tekton-PipelineRun verwendet wird. Beispiel:'{"message":"hello world","flag":"enable"}'.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-body bodyJSON

json

  • Verwenden Sie diesen Parameter, um die Auslöserergebnisse im JSON-Format auszugeben.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trace

toolchain-delete

Löschen Sie eine Toolchain. Wenn kein Toolchain-Name angegeben ist, können Sie eine Toolchain aus einer Liste auswählen. Die Liste der Toolchains hängt von der aktuell ausgewählten Ressourcengruppe und Region ab.

Die Ressourcengruppe, die als Ziel angegeben ist, befinden sich im API-Schlüssel (IBMCLOUD API Key). Weitere Informationen finden Sie unter Zielkonto, Region, Organisation oder Bereich festlegen oder anzeigen.

ibmcloud dev toolchain-delete [toolchainName] [--force,-f]

Parameter des Befehls 'toolchain-delete'

Die folgenden Parameter können mit dem Befehl toolchain-delete oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

force

  • Parameter zum Überspringen der Eingabeaufforderungsbestätigung zum Löschen einer Toolchain.
  • Verwendung: ibmcloud dev toolchain-delete [toolchainName] --force

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev toolchain-delete [toolchainName] --trace

toolchain-get

Zeigen Sie die Details einer Toolchain an. Wenn kein Toolchain-Name angegeben ist, können Sie eine Toolchain aus einer Liste auswählen.

Verwendet die Zielressourcengruppe im API-Schlüssel (IBMCLOUD API Key). Weitere Informationen finden Sie unter Zielkonto, Region, Organisation oder Bereich festlegen oder anzeigen.

ibmcloud dev toolchain-get [toolchainName] [--output JSON]

Parameter des Befehls 'toolchain-get'

Die folgenden Parameter können mit dem Befehl toolchain-get oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

json

  • Parameter, der zum Ausgeben der Toolchain-Details im JSON-Format verwendet wird.
  • Verwendung: ibmcloud dev toolchain-get [toolchainName] --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev toolchain-get [toolchainName] --trace

toolchain-open

Zeigen Sie die URL für die Toolchain mithilfe des Befehls toolchain-open an. Mit dem Befehl toolchain-open wird die URL auch in Ihrem Standardbrowser geöffnet. Wenn kein Toolchain-Name angegeben ist, können Sie eine Toolchain aus einer Liste auswählen.

ibmcloud dev toolchain-open [toolchainName]

Parameter des Befehls 'toolchain-open'

Der folgende Parameter kann mit dem Befehl toolchain-open oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev toolchain-open [toolchainName] --trace

Toolchains

Zeigen Sie eine Liste der Toolchains in der aktuellen Ressourcengruppe an.

Verwendet die Zielressourcengruppe im API-Schlüssel (IBMCLOUD API Key). Weitere Informationen finden Sie unter Zielkonto, Region, Organisation oder Bereich festlegen oder anzeigen.

ibmcloud dev toolchains [--output JSON]

Parameter des Befehls 'toolchains'

Die folgenden Parameter können mit dem Befehl toolchains oder unmittelbar durch die Aktualisierung der Datei cli-config.yml der App angegeben werden.

Befehlsparameter, die in der Befehlszeile eingegeben werden, haben Vorrang vor der cli-config.yml-Konfiguration.

json

  • Parameter, der zum Ausgeben der Toolchains im JSON-Format verwendet wird.
  • Verwendung: ibmcloud dev toolchains --output JSON

trace

  • Verwenden Sie diesen Parameter, um eine ausführliche Ausgabe bereitzustellen.
  • Verwendung: ibmcloud dev toolchains --trace