IBM Cloud Docs
IBM Cloud CLI Developer Tools (ibmcloud dev) 命令

IBM Cloud CLI Developer Tools (ibmcloud dev) 命令

IBM Cloud® 命令行界面包含 Developer Tools (ibmcloud dev) 或 (ic dev) 命令，用于管理经典管道，Tekton 管道和工具链。

帮助

缺省情况下，如果未传入操作或自变量，或者如果提供了“help”操作，那么此命令会显示一般“帮助”文本。 显示的一般帮助包括基本自变量的描述以及可用操作的列表。

运行以下命令来显示一般帮助信息：

ibmcloud dev help

pipeline-get

查看经典管道的详细信息。

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

pipeline-get 命令参数

json

  • 用于以 JSON 格式输出管道详细信息的参数。
  • 用法： ibmcloud dev pipeline-get [PIPELINE_ID] --output JSON

以下参数可以与 pipeline-get 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev pipeline-get [PIPELINE_ID] --trace

pipeline-run

运行经典管道。

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

pipeline-run 命令参数

以下参数可以与 pipeline-run 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

stage-id

  • 该可选参数用于选择要运行的管道阶段
  • 用法： ibmcloud dev pipeline-run [PIPELINE_ID] --stage-id [stageID]

json

  • 用于以 JSON 格式输出管道的调用详细信息的参数。
  • 用法： ibmcloud dev pipeline-run [PIPELINE_ID] --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev pipeline-run [PIPELINE_ID] --trace

pipeline-log

使用 pipeline-log 命令查看最新的经典管道日志。

  • 如果将管道标识指定为自变量，那么会显示该管道所有阶段中所有作业的所有日志。
  • 如果已填充阶段标识标志，那么会按管道中的该阶段来过滤日志。
  • 如果将作业标识与阶段标识一起指定，那么会过滤日志以仅显示该阶段中的该作业。
  • 如果将作业执行标识与阶段标识和作业标识一起指定，那么将在所有可用日志中搜索与指定作业执行标识匹配的日志。

用法：

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

pipeline-log 命令参数

以下参数可以与 pipeline-log 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

job-id

  • 用于按作业标识过滤日志的参数。
  • 需要 stage-id 标志。
  • 用法： ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID]

job-exec-id

  • 用于按作业执行标识过滤日志的参数。
  • 需要 stage-id 标志。
  • 需要 job-id 标志。
  • 用法： ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID] --job-exec-id [jobExecutionID]

stage-id

  • 用于按阶段标识过滤日志的参数。
  • 用法： ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID]

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev pipeline-log [PIPELINE_ID] --trace

pipeline-open

通过 pipeline-open 命令查看 Classic 管道的 URL。 pipeline-open 命令还会在缺省浏览器中打开相应 URL。

ibmcloud dev pipeline-open [PIPELINE_ID]

pipeline-open 命令参数

以下参数可以与 pipeline-open 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev pipeline-open [PIPELINE_ID] --trace

泰克顿信息公司

查看 Tekton 管道的详细信息。

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

tekton-info 命令参数

以下参数可与 tekton-info 命令配合使用。

verbose

  • 使用此参数以 JSON 格式提供管道的所有详细信息。
  • 用法： ibmcloud dev tekton-info [PIPELINE_ID] --verbose

json

  • 用于以 JSON 格式输出管道详细信息的参数。
  • 用法： ibmcloud dev tekton-info [PIPELINE_ID] --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev tekton-info [PIPELINE_ID] --trace

泰克顿-日志

使用 tekton-logs 命令查看最近的 Tekton 管道运行日志。

  • 管道运行标识是必需参数。
  • 如果将任务名称指定为自变量，那么将仅检索此任务的日志。

用法：

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

tekton-logs 命令参数

以下参数可与 tekton-logs 命令配合使用。

run-id （必需）

  • 用于标识为日志检索而运行的管道的参数。
  • 用法： ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID]

task-name

  • 用于按管道运行任务名称过滤日志的参数。
  • 用法： ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --task-name [taskName]

json

  • 用于以 JSON 格式输出日志详细信息的参数。
  • 用法： ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipeline-取消

取消正在进行的 Tekton 管道运行。

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

tekton-pipeline-cancel 命令参数

以下参数可与 tekton-pipeline-cancel 命令配合使用。

run-id （必需）

  • 用于标识要取消的管道运行的参数。
  • 用法： ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID]

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] --trace

泰克通管道公司

查看 Tekton 管道运行的详细信息，或者使用 ls 参数列出管道的所有管道运行。

用法：

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

tekton-pipelineun 命令参数

以下参数可与 tekton-pipelinerun 命令配合使用。

run-id （必需）

  • 用于标识要检索的管道运行的参数。
  • 用法： ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID]

json

  • 用于以 JSON 格式输出管道运行详细信息的参数。
  • 用法： ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --trace

泰克顿管道

查看 Tekton 管道的管道运行列表。

用法：

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

tekton-pipelineuns 命令参数

以下参数可与 tekton-pipelineruns 命令配合使用。

json

  • 用于输出管道的参数以 JSON 格式运行。
  • 用法： ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --trace

泰克顿触发器

运行 Tekton 管道。

用法：

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

tekton-trigger 命令参数

以下参数可与 tekton-trigger 命令配合使用。

trigger-name （必需）

  • 使用此参数来指示要运行的触发器。
  • 用法： ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName

trigger-properties（可选）

  • 可选。 使用此参数可覆盖或附加到定义的触发器属性。 例如，'{"pipeline-debug":"true"}'。
  • 用法： ibmcloud dev tekton-trigger pipePIPELINE_IDlineID --trigger-name triggerName --trigger-properties propertiesJSON

secure-trigger-properties（可选）

  • 可选。 使用此参数可覆盖或附加到定义的触发器属性，这些属性的值应隐藏在以后的输出中的点或星号后面。 例如， '{"deployer-api-key":"s0mEThING_v3Ry_s3CReT"}'
  • 用法： ibmcloud dev tekton-trigger pipePIPELINE_IDlineID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON

trigger-headers（可选）

  • 可选。 使用此参数可指定 Tekton pipelineRun的 triggerBinding 中使用的头。 例如，'{"source":"cli","flag":"enable"}'。
  • 用法： ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-headers headerJSON

trigger-body（可选）

  • 可选。 使用此参数来指定 Tekton pipelineRun的 triggerBinding 中使用的主体。 例如，'{"message":"hello world","flag":"enable"}'。
  • 用法： ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-body bodyJSON

json

  • 使用此参数以 JSON 格式输出触发器结果。
  • 用法： ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trace

toolchain-delete

删除工具链。 如果未提供工具链名称，那么可以从列表中选择工具链。 工具链的列表取决于当前目标资源组和区域。

在 IBMCLOUD API Key 中可找到目标资源组。 有关更多信息，请参阅设置或查看目标帐户、区域或资源组。

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

toolchain-delete 命令参数

以下参数可以与 toolchain-delete 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

force

  • 用于跳过提示确认以删除工具链的参数。
  • 用法： ibmcloud dev toolchain-delete [toolchainName] --force

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev toolchain-delete [toolchainName] --trace

toolchain-get

查看工具链的详细信息。 如果未提供工具链名称，那么可以从列表中选择工具链。

使用 IBMCLOUD API Key 中的目标资源组。 有关更多信息，请参阅设置或查看目标帐户、区域或资源组。

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

toolchain-get 命令参数

以下参数可以与 toolchain-get 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

json

  • 用于以 JSON 格式输出工具链详细信息的参数。
  • 用法： ibmcloud dev toolchain-get [toolchainName] --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev toolchain-get [toolchainName] --trace

toolchain-open

通过 toolchain-open 命令可查看工具链的 URL。 toolchain-open 命令还会在缺省浏览器中打开相应 URL。 如果未提供工具链名称，那么会提供工具链列表以供选择。

ibmcloud dev toolchain-open [toolchainName]

toolchain-open 命令参数

以下参数可以与 toolchain-open 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev toolchain-open [toolchainName] --trace

toolchains

查看当前资源组中工具链的列表。

使用 IBMCLOUD API Key 中的目标资源组。 有关更多信息，请参阅设置或查看目标帐户、区域或资源组。

ibmcloud dev toolchains [--output JSON]

toolchains 命令参数

以下参数可以与 toolchains 命令一起使用，也可以通过直接更新应用程序的 cli-config.yml 文件来使用。

在命令行上输入的命令参数优先于 cli-config.yml 配置。

json

  • 用于以 JSON 格式输出工具链的参数。
  • 用法： ibmcloud dev toolchains --output JSON

trace

  • 使用此参数可提供详细输出。
  • 用法： ibmcloud dev toolchains --trace