Commandes IBM Cloud CLI Developer Tools (ibmcloud dev)

L'interface de ligne de commande IBM Cloud® comprend les commandes Developer Tools (ibmcloud dev) pour gérer les pipelines classiques, les pipelines Tekton et les chaînes d'outils.

help

Par défaut, si aucune action ou aucun argument n'est transmis, ou si l'action help est fournie, cette commande affiche un texte d'aide général. L'aide générale affichée inclut une description des arguments de base ainsi que la liste des actions disponibles.

Exécutez la commande suivante pour afficher des informations d'aide générales :

ibmcloud dev help

Commande pipeline-get

Affiche les détails d'un pipeline classique.

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

Paramètres de la commande pipeline-get

json

  • Paramètre utilisé pour générer les détails du pipeline au format JSON.
  • Syntaxe :ibmcloud dev pipeline-get [PIPELINE_ID] --output JSON

Le paramètre ci-dessous peut être utilisé avec la commande pipeline-get ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev pipeline-get [PIPELINE_ID] --trace

Commande pipeline-run

Exécute un pipeline classique.

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

Paramètres de la commande pipeline-run

Les paramètres ci-dessous peuvent être utilisés avec la commande pipeline-run ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

stage-id

  • Paramètre facultatif permettant de sélectionner l'étape d'un pipeline à exécuter
  • Syntaxe :ibmcloud dev pipeline-run [PIPELINE_ID] --stage-id [stageID]

json

  • Paramètre utilisé pour générer les détails de l'appel d'un pipeline au format JSON.
  • Syntaxe :ibmcloud dev pipeline-run [PIPELINE_ID] --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev pipeline-run [PIPELINE_ID] --trace

Commande pipeline-log

Affiche les journaux récents d'un pipeline classique en utilisant la commande pipeline-log.

  • Si l'ID de pipeline est spécifié en tant qu'argument, tous les journaux pour tous les travaux de toutes les étapes sont imprimés pour ce pipeline.
  • Si l'indicateur d'ID d'étape est renseigné, les journaux sont filtrés par cette étape dans le pipeline.
  • Si l'ID de travail est spécifié avec l'ID d'étape, les journaux sont filtrés uniquement dans le travail de cette étape.
  • Si l'ID d'exécution de travail est spécifié en même temps que l'ID d'étape et l'ID de travail, une recherche est effectuée parmi tous les journaux disponibles correspondant à l'ID d'exécution de travail spécifié.

Syntaxe :

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

Paramètres de la commande pipeline-log

Les paramètres ci-dessous peuvent être utilisés avec la commande pipeline-log ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

job-id

  • Paramètre utilisé pour filtrer les journaux par ID de travail.
  • Requiert l'indicateur stage-id.
  • Syntaxe :ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID]

job-exec-id

  • Paramètre utilisé pour filtrer les journaux par ID d'exécution de travail.
  • Requiert l'indicateur stage-id.
  • Requiert l'indicateur job-id.
  • Syntaxe :ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID] --job-exec-id [jobExecutionID]

stage-id

  • Paramètre utilisé pour filtrer les journaux par ID d'étape.
  • Syntaxe :ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID]

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev pipeline-log [PIPELINE_ID] --trace

Commande pipeline-open

Affiche l'URL du pipeline classique via la commande pipeline-open. La commande pipeline-open permet également d'ouvrir l'URL dans votre navigateur par défaut.

ibmcloud dev pipeline-open [PIPELINE_ID]

Paramètres de la commande pipeline-open

Le paramètre ci-dessous peut être utilisé avec la commande pipeline-open ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev pipeline-open [PIPELINE_ID] --trace

tekton-info

Affiche les détails d'un pipeline Tekton.

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

Paramètres de la commande tekton-info

Les paramètres ci-dessous peuvent être utilisés avec la commande tekton-info.

verbose

  • Utilisez ce paramètre pour fournir tous les détails d'un pipeline au format JSON.
  • Syntaxe :ibmcloud dev tekton-info [PIPELINE_ID] --verbose

json

  • Paramètre utilisé pour générer les détails du pipeline au format JSON.
  • Syntaxe :ibmcloud dev tekton-info [PIPELINE_ID] --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev tekton-info [PIPELINE_ID] --trace

tekton-logs

Affichez les journaux d'exécution récents du pipeline Tekton en utilisant la commande tekton-logs.

  • L'ID d'exécution du pipeline est un argument obligatoire.
  • Si le nom de la tâche est spécifié en tant qu'argument, seuls les journaux de cette tâche sont extraits.

Syntaxe :

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

Paramètres de la commande tekton-logs

Les paramètres ci-dessous peuvent être utilisés avec la commande tekton-logs.

run-id(obligatoire)

  • Un paramètre qui identifie l'exécution du pipeline pour la récupération du journal.
  • Syntaxe :ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID]

task-name

  • Paramètre utilisé pour filtrer les journaux par nom de tâche d'exécution de pipeline.
  • Syntaxe :ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --task-name [taskName]

json

  • Paramètre utilisé pour générer les détails du journal au format JSON.
  • Syntaxe :ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipeline-annuler

Annuler une exécution de pipeline Tekton en cours.

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

Paramètres de la commande tekton-pipeline-cancel

Les paramètres ci-dessous peuvent être utilisés avec la commande tekton-pipeline-cancel.

run-id(obligatoire)

  • Un paramètre qui identifie l'exécution du pipeline à annuler.
  • Syntaxe :ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID]

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelinerun

Affichez les détails d'un pipeline Tekton ou utilisez le paramètre ls pour répertorier toutes les exécutions de pipeline pour le pipeline.

Syntaxe :

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

Paramètres de la commande tekton-pipelinerun

Les paramètres ci-dessous peuvent être utilisés avec la commande tekton-pipelinerun.

run-id(obligatoire)

  • Paramètre qui identifie l'exécution du pipeline à extraire.
  • Syntaxe :ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID]

json

  • Paramètre utilisé pour générer les détails d'exécution du pipeline au format JSON.
  • Syntaxe :ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelineruns

Affichez la liste des exécutions de pipeline pour un pipeline Tekton.

Syntaxe :

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

Paramètres de la commande tekton-pipelineruns

Les paramètres ci-dessous peuvent être utilisés avec la commande tekton-pipelineruns.

json

  • Paramètre utilisé pour générer les exécutions du pipeline au format JSON.
  • Syntaxe :ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --trace

tekton-trigger

Exécutez un pipeline Tekton.

Syntaxe :

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]

Paramètres de la commande tekton-trigger

Les paramètres ci-dessous peuvent être utilisés avec la commande tekton-trigger.

trigger-name(obligatoire)

  • Utilisez ce paramètre pour indiquer le déclencheur à exécuter.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName

description (facultatif)

  • Optionnel. Ce paramètre permet de spécifier une description pour le site Tekton pipelineRun créé.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --description "My description"

trigger-properties (facultatif)

  • Optionnel. Ce paramètre permet de remplacer ou d'ajouter des propriétés de déclencheur définies. Par exemple,'{"pipeline-debug":"true"}'.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-properties propertiesJSON

secure-trigger-properties (facultatif)

  • Optionnel. Utilisez ce paramètre pour remplacer ou ajouter des propriétés de déclencheur définies dont les valeurs doivent être masquées derrière des points ou des astérisques dans les sorties ultérieures. Exemple: '{"deployer-api-key":"s0mEThING_v3Ry_s3CReT"}'
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON

trigger-headers (facultatif)

  • Optionnel. Ce paramètre permet de spécifier les en-têtes utilisés dans triggerBinding d'un Tekton pipelineRun. Par exemple,'{"source":"cli","flag":"enable"}'.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-headers headerJSON

trigger-body (facultatif)

  • Optionnel. Ce paramètre permet de spécifier le corps utilisé dans triggerBinding d'une pipelineRun Tekton. Par exemple,'{"message":"hello world","flag":"enable"}'.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-body bodyJSON

json

  • Utilisez ce paramètre pour générer les résultats du déclencheur au format JSON.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trace

toolchain-delete

Supprime une chaîne d'outils. Si aucun nom de chaîne d'outils n'est fourni, vous pouvez en sélectionner un dans la liste. La liste des chaînes d'outils dépend du groupe de ressources et de la région actuellement ciblés.

Le groupe de ressources ciblé se trouve dans la IBMCLOUD API Key. Pour plus d'informations, voir Définir ou afficher le compte, la région, l'organisation ou l'espace cible.

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

Paramètres de la commande toolchain-delete

Les paramètres ci-dessous peuvent être utilisés avec la commande toolchain-delete ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

force

  • Paramètre permettant d'ignorer l'invite de confirmation pour la suppression d'une chaîne d'outils.
  • Syntaxe :ibmcloud dev toolchain-delete [toolchainName] --force

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev toolchain-delete [toolchainName] --trace

Commande toolchain-get

Affiche les détails d'une chaîne d'outils. Si aucun nom de chaîne d'outils n'est fourni, vous pouvez en sélectionner un dans la liste.

Utilise le groupe de ressources ciblé dans la IBMCLOUD API Key. Pour plus d'informations, voir Définir ou afficher le compte, la région, l'organisation ou l'espace cible.

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

Paramètres de la commande toolchain-get

Les paramètres ci-dessous peuvent être utilisés avec la commande toolchain-get ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

json

  • Paramètre utilisé pour générer les détails de la chaîne d'outils au format JSON.
  • Syntaxe :ibmcloud dev toolchain-get [toolchainName] --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev toolchain-get [toolchainName] --trace

Commande toolchain-open

Affiche l'URL pour la chaîne d'outils via la commande toolchain-open. La commande toolchain-open permet également d'ouvrir l'URL dans votre navigateur par défaut. Si aucun nom de chaîne d'outils n'est indiqué, vous pouvez en sélectionner un dans la liste des chaînes d'outils fournie.

ibmcloud dev toolchain-open [toolchainName]

Paramètres de la commande toolchain-open

Le paramètre ci-dessous peut être utilisé avec la commande toolchain-open ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev toolchain-open [toolchainName] --trace

chaînes d'outils

Affiche une liste de chaînes d'outils dans le groupe de ressources actuel.

Utilise le groupe de ressources ciblé dans la IBMCLOUD API Key. Pour plus d'informations, voir Définir ou afficher le compte, la région, l'organisation ou l'espace cible.

ibmcloud dev toolchains [--output JSON]

Paramètres de la commande toolchains

Les paramètres ci-dessous peuvent être utilisés avec la commande toolchains ou en mettant directement à jour le fichier cli-config.yml de l'application.

Les paramètres de commande qui sont entrés sur la ligne de commande sont prioritaires par rapport à ceux du fichier de configuration cli-config.yml.

json

  • Paramètre utilisé pour générer les chaînes d'outils au format JSON.
  • Syntaxe :ibmcloud dev toolchains --output JSON

trace

  • Utilisez ce paramètre pour générer une sortie prolixe.
  • Syntaxe :ibmcloud dev toolchains --trace