Comandi IBM Cloud CLI Developer Tools (ibmcloud dev)

L'interfaccia a riga di comando IBM Cloud® include i comandi Developer Tools (ibmcloud dev) per gestire pipeline classiche, pipeline Tekton e toolchain.

guida

Per impostazione predefinita, se non viene trasmesso alcun argomento o azione o se viene fornita l'azione 'help', questo comando mostra un testo di "Aiuto" generale. La guida generale visualizzata include una descrizione degli argomenti di base e un elenco delle azioni disponibili.

Esegui il seguente comando per visualizzare le informazioni della guida generale:

ibmcloud dev help

pipeline-get

Visualizza i dettagli di una pipeline Classic.

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

Parametri del comando pipeline-get

json

  • Parametro utilizzato per generare in output i dettagli della pipeline nel formato JSON.
  • Utilizzo: ibmcloud dev pipeline-get [PIPELINE_ID] --output JSON

Il seguente parametro può essere utilizzato con il comando pipeline-get o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev pipeline-get [PIPELINE_ID] --trace

pipeline-run

Esegui una pipeline Classic.

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

Parametri del comando pipeline-run

I seguenti parametri possono essere utilizzati con il comando pipeline-run o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

stage-id

  • Parametro utilizzato facoltativamente per selezionare la fase di una pipeline da eseguire
  • Utilizzo: ibmcloud dev pipeline-run [PIPELINE_ID] --stage-id [stageID]

json

  • Parametro utilizzato per generare in output i dettagli di richiamo della pipeline nel formato JSON.
  • Utilizzo: ibmcloud dev pipeline-run [PIPELINE_ID] --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev pipeline-run [PIPELINE_ID] --trace

pipeline-log

Visualizza i log della pipeline Classic recenti utilizzando il comando pipeline-log.

  • Se l'ID pipeline viene specificato come un argomento, tutti i log di tutti i lavori in tutte le fasi vengono stampati per tale pipeline.
  • Se l'indicatore ID fase viene popolato, i log vengono filtrati per tale fase nella pipeline.
  • Se l'ID lavoro viene specificato con l'ID fase, i log vengono filtrati solo per il lavoro nella fase.
  • Se l'ID esecuzione lavoro viene specificato insieme all'ID fase e all'ID lavoro, viene eseguita una ricerca tra tutti i log disponibili che corrispondono all'ID esecuzione lavoro specificato.

Uso:

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

Parametri del comando pipeline-log

I seguenti parametri possono essere utilizzati con il comando pipeline-log o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

job-id

  • Parametro utilizzato per filtrare i log in base all'ID lavoro.
  • Richiede l'indicatore stage-id.
  • Utilizzo: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID]

job-exec-id

  • Parametro utilizzato per filtrare i log in base all'ID esecuzione lavoro.
  • Richiede l'indicatore stage-id.
  • Richiede l'indicatore job-id.
  • Utilizzo: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID] --job-exec-id [jobExecutionID]

stage-id

  • Parametro utilizzato per filtrare i log in base all'ID fase.
  • Utilizzo: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID]

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev pipeline-log [PIPELINE_ID] --trace

pipeline-open

Visualizza l'URL per la pipeline Classic tramite il comando pipeline-open. Anche il comando pipeline-open apre l'URL nel tuo browser predefinito.

ibmcloud dev pipeline-open [PIPELINE_ID]

Parametri del comando pipeline-open

Il seguente parametro può essere utilizzato con il comando pipeline-open o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev pipeline-open [PIPELINE_ID] --trace

tekton - info

Visualizza i dettagli di una conduttura Tekton.

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

Parametri del comando tekton - info

I seguenti parametri possono essere utilizzati con il comando tekton-info.

verbose

  • Utilizzare questo parametro per fornire tutti i dettagli di una pipeline in formato JSON.
  • Utilizzo: ibmcloud dev tekton-info [PIPELINE_ID] --verbose

json

  • Parametro utilizzato per generare in output i dettagli della pipeline nel formato JSON.
  • Utilizzo: ibmcloud dev tekton-info [PIPELINE_ID] --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev tekton-info [PIPELINE_ID] --trace

tekton - log

Visualizza i log di esecuzione della pipeline Tekton recenti utilizzando il comando tekton-logs.

  • L'ID di esecuzione della pipeline è un argomento obbligatorio.
  • Se il nome dell'attività viene specificato come argomento, vengono richiamati solo i log per questa attività.

Uso:

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

Parametri del comando tekton - logs

I seguenti parametri possono essere utilizzati con il comando tekton-logs.

run-id (Obbligatorio)

  • Un parametro che identifica la pipeline eseguita per il recupero del registro.
  • Utilizzo: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID]

task-name

  • Parametro utilizzato per filtrare i log in base al nome dell'attività di esecuzione della pipeline.
  • Utilizzo: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --task-name [taskName]

json

  • Parametro utilizzato per produrre i dettagli del registro in formato JSON.
  • Utilizzo: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton - pipeline - cancel

Annulla un'esecuzione di pipeline Tekton in corso.

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

Parametri del comando tekton - pipeline - cancel

I seguenti parametri possono essere utilizzati con il comando tekton-pipeline-cancel.

run-id (Obbligatorio)

  • Un parametro che identifica l'esecuzione della pipeline da annullare.
  • Utilizzo: ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID]

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelinerun

Visualizzare i dettagli di un'esecuzione della pipeline Tekton o utilizzare il parametro ls per elencare tutte le esecuzioni della pipeline per la pipeline.

Uso:

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

Parametri del comando tekton-pipelinerun

I seguenti parametri possono essere utilizzati con il comando tekton-pipelinerun.

run-id (Obbligatorio)

  • Parametro che identifica l'esecuzione della pipeline da recuperare.
  • Utilizzo: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID]

json

  • Parametro usato per produrre i dettagli dell'esecuzione della pipeline in formato JSON.
  • Utilizzo: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --trace

pistole tekton-pipeliner

Visualizza un elenco di esecuzioni di pipeline per una pipeline Tekton.

Uso:

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

Parametri del comando tekton-pipelineruns

I seguenti parametri possono essere utilizzati con il comando tekton-pipelineruns.

json

  • Parametro usato per produrre le corse della pipeline in formato JSON.
  • Utilizzo: ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --trace

trigger tekton

Eseguire una pipeline Tekton.

Uso:

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]

parametri del comando tekton - trigger

I seguenti parametri possono essere utilizzati con il comando tekton-trigger.

trigger-name (Obbligatorio)

  • Utilizzare questo parametro per indicare il trigger da eseguire.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName

description (facoltativo)

  • Facoltativo. Utilizzare questo parametro per specificare una descrizione per il Tekton creato pipelineRun.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --description "My description"

trigger-properties (facoltativo)

  • Facoltativo. Utilizzare questo parametro per sovrascrivere o aggiungere le proprietà trigger definite. Ad esempio,'{"pipeline-debug":"true"}'.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-properties propertiesJSON

secure-trigger-properties (facoltativo)

  • Facoltativo. Utilizzare questo parametro per sovrascrivere o aggiungere alle proprietà trigger definite i cui valori devono essere nascosti dietro punti o asterischi negli output successivi. Ad esempio, '{"deployer-api-key":"s0mEThING_v3Ry_s3CReT"}'
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON

trigger-headers (facoltativo)

  • Facoltativo. Utilizzare questo parametro per specificare le intestazioni utilizzate in triggerBinding di una pipelineRunTekton. Ad esempio,'{"source":"cli","flag":"enable"}'.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-headers headerJSON

trigger-body (facoltativo)

  • Facoltativo. Utilizzare questo parametro per specificare il corpo utilizzato in triggerBinding di Tekton pipelineRun. Ad esempio,'{"message":"hello world","flag":"enable"}'.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-body bodyJSON

json

  • Utilizzare questo parametro per eseguire l'output dei risultati del trigger in formato JSON.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trace

toolchain-delete

Elimina una toolchain. Se non viene fornito alcun nome di toolchain, puoi selezionarne uno dall'elenco. L'elenco di toolchain dipende dalla regione e dal gruppo di risorse selezionati al momento.

Il gruppo di risorse selezionato viene trovato in IBMCLOUD API Key. Per ulteriori informazioni, vedi Imposta o visualizza l'account, la regione, l'organizzazione o il gruppo di risorse di destinazione.

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

Parametri del comando toolchain-delete

I seguenti parametri possono essere utilizzati con il comando toolchain-delete o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

force

  • Il parametro utilizzato per ignorare la conferma del prompt per l'eliminazione di una toolchain.
  • Utilizzo: ibmcloud dev toolchain-delete [toolchainName] --force

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev toolchain-delete [toolchainName] --trace

toolchain-get

Visualizza i dettagli di una toolchain. Se non viene fornito alcun nome di toolchain, puoi selezionarne uno dall'elenco.

Utilizza il gruppo di risorse selezionato in IBMCLOUD API Key. Per ulteriori informazioni, vedi Imposta o visualizza l'account, la regione, l'organizzazione o il gruppo di risorse di destinazione.

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

Parametri del comando toolchain-get

I seguenti parametri possono essere utilizzati con il comando toolchain-get o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

json

  • Parametro utilizzato per generare in output i dettagli della toolchain nel formato JSON.
  • Utilizzo: ibmcloud dev toolchain-get [toolchainName] --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev toolchain-get [toolchainName] --trace

toolchain-open

Visualizza l'URL della toolchain tramite il comando toolchain-open. Anche il comando toolchain-open apre l'URL nel tuo browser predefinito. Se non viene fornito alcun nome di toolchain, viene fornito un elenco di toolchain per effettuare la selezione.

ibmcloud dev toolchain-open [toolchainName]

Parametri del comando toolchain-open

Il seguente parametro può essere utilizzato con il comando toolchain-open o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev toolchain-open [toolchainName] --trace

toolchain

Visualizza un elenco di toolchain nel gruppo di risorse corrente.

Utilizza il gruppo di risorse selezionato in IBMCLOUD API Key. Per ulteriori informazioni, vedi Imposta o visualizza l'account, la regione, l'organizzazione o il gruppo di risorse di destinazione.

ibmcloud dev toolchains [--output JSON]

Parametri del comando toolchains

I seguenti parametri possono essere utilizzati con il comando toolchains o aggiornando direttamente il file cli-config.yml dell'applicazione.

I parametri di comando immessi sulla riga di comando hanno la precedenza sulla configurazione cli-config.yml.

json

  • Parametro utilizzato per generare in output delle toolchain in formato JSON.
  • Utilizzo: ibmcloud dev toolchains --output JSON

trace

  • Utilizza questo parametro per fornire l'output dettagliato.
  • Utilizzo: ibmcloud dev toolchains --trace