×

基本语法

tkn [命令或选项] [参数…​]

全局选项

--help, -h

实用程序命令

tkn

tkn CLI 的父命令。

示例:显示所有选项
$ tkn

completion [shell]

打印必须评估才能提供交互式完成功能的 shell 完成功能代码。支持的 shell 为bashzsh

示例:bash shell 的完成功能代码
$ tkn completion bash

版本

打印tkn CLI 的版本信息。

示例:检查tkn 版本
$ tkn version

流水线管理命令

pipeline

管理流水线。

示例:显示帮助
$ tkn pipeline --help

pipeline delete

删除流水线。

示例:从命名空间中删除mypipeline 流水线
$ tkn pipeline delete mypipeline -n myspace

pipeline describe

描述流水线。

示例:描述mypipeline 流水线
$ tkn pipeline describe mypipeline

pipeline list

显示流水线列表。

示例:显示流水线列表
$ tkn pipeline list

pipeline logs

显示特定流水线的日志。

示例:流式传输mypipeline 流水线的实时日志
$ tkn pipeline logs -f mypipeline

pipeline start

启动流水线。

示例:启动mypipeline 流水线
$ tkn pipeline start mypipeline

流水线运行命令

pipelinerun

管理流水线运行。

示例:显示帮助
$ tkn pipelinerun -h

pipelinerun cancel

取消流水线运行。

示例:从命名空间中取消mypipelinerun 流水线运行
$ tkn pipelinerun cancel mypipelinerun -n myspace

pipelinerun delete

删除流水线运行。

示例:从命名空间删除流水线运行
$ tkn pipelinerun delete mypipelinerun1 mypipelinerun2 -n myspace
示例:从命名空间删除所有流水线运行,除了最近执行的五个流水线运行。
$ tkn pipelinerun delete -n myspace --keep 5 (1)
1 5替换为您想要保留的最近执行的流水线运行的数量。
示例:删除所有流水线
$ tkn pipelinerun delete --all

从 Red Hat OpenShift Pipelines 1.6 开始,tkn pipelinerun delete --all 命令不会删除任何处于运行状态的资源。

pipelinerun describe

描述流水线运行。

示例:在命名空间中描述mypipelinerun 流水线运行
$ tkn pipelinerun describe mypipelinerun -n myspace

pipelinerun list

列出流水线运行。

示例:显示命名空间中流水线运行的列表
$ tkn pipelinerun list -n myspace

pipelinerun logs

显示流水线运行的日志。

示例:显示mypipelinerun 流水线运行的所有任务和步骤的日志(在命名空间中)
$ tkn pipelinerun logs mypipelinerun -a -n myspace

任务管理命令

task

管理任务。

示例:显示帮助
$ tkn task -h

task delete

删除任务。

示例:从命名空间中删除mytask1mytask2 任务
$ tkn task delete mytask1 mytask2 -n myspace

task describe

描述任务。

示例:在命名空间中描述mytask 任务
$ tkn task describe mytask -n myspace

task list

列出任务。

示例:列出命名空间中的所有任务
$ tkn task list -n myspace

task logs

显示任务日志。

示例:显示mytask 任务的mytaskrun 任务运行的日志
$ tkn task logs mytask mytaskrun -n myspace

task start

启动任务。

示例:在命名空间中启动mytask 任务
$ tkn task start mytask -s <ServiceAccountName> -n myspace

任务运行命令

taskrun

管理任务运行。

示例:显示帮助
$ tkn taskrun -h

taskrun cancel

取消任务运行。

示例:从命名空间中取消mytaskrun 任务运行
$ tkn taskrun cancel mytaskrun -n myspace

taskrun delete

删除 TaskRun。

示例:从命名空间中删除mytaskrun1mytaskrun2 任务运行
$ tkn taskrun delete mytaskrun1 mytaskrun2 -n myspace
示例:从命名空间中删除除最近执行的五个任务运行之外的所有任务运行。
$ tkn taskrun delete -n myspace --keep 5 (1)
1 5替换为您想要保留的最近执行的任务运行的数量。

taskrun describe

描述任务运行。

示例:在命名空间中描述mytaskrun 任务运行
$ tkn taskrun describe mytaskrun -n myspace

taskrun list

列出任务运行。

示例:列出命名空间中的所有任务运行
$ tkn taskrun list -n myspace

taskrun logs

显示任务运行日志。

示例:显示命名空间中mytaskrun 任务运行的实时日志
$ tkn taskrun logs -f mytaskrun -n myspace

条件管理命令

condition

管理条件。

示例:显示帮助
$ tkn condition --help

condition delete

删除条件。

示例:从命名空间中删除mycondition1 条件
$ tkn condition delete mycondition1 -n myspace

condition describe

描述条件。

示例:在命名空间中描述mycondition1 条件
$ tkn condition describe mycondition1 -n myspace

condition list

列出条件。

示例:列出命名空间中的条件
$ tkn condition list -n myspace

流水线资源管理命令

resource

管理流水线资源。

示例:显示帮助
$ tkn resource -h

resource create

创建流水线资源。

示例:在命名空间中创建一个流水线资源
$ tkn resource create -n myspace

这是一个交互式命令,它会询问有关资源名称、资源类型以及基于资源类型的值的输入。

资源删除

删除 Pipeline 资源。

示例:从命名空间中删除myresource Pipeline 资源
$ tkn resource delete myresource -n myspace

资源描述

描述 Pipeline 资源。

示例:描述myresource Pipeline 资源
$ tkn resource describe myresource -n myspace

资源列表

列出 Pipeline 资源。

示例:列出命名空间中的所有 Pipeline 资源
$ tkn resource list -n myspace

ClusterTask 管理命令

在 Red Hat OpenShift Pipelines 1.10 中,tkn 命令行工具的 ClusterTask 功能已弃用,并计划在将来的版本中删除。

clustertask

管理 ClusterTasks。

示例:显示帮助
$ tkn clustertask --help

clustertask 删除

删除集群中的 ClusterTask 资源。

示例:删除mytask1mytask2 ClusterTasks
$ tkn clustertask delete mytask1 mytask2

clustertask 描述

描述 ClusterTask。

示例:描述mytask ClusterTask
$ tkn clustertask describe mytask1

clustertask 列表

列出 ClusterTasks。

示例:列出 ClusterTasks
$ tkn clustertask list

clustertask 启动

启动 ClusterTasks。

示例:启动mytask ClusterTask
$ tkn clustertask start mytask

触发器管理命令

eventlistener

管理 EventListeners。

示例:显示帮助
$ tkn eventlistener -h

eventlistener 删除

删除 EventListener。

示例:从命名空间中删除mylistener1mylistener2 EventListeners
$ tkn eventlistener delete mylistener1 mylistener2 -n myspace

eventlistener 描述

描述 EventListener。

示例:描述命名空间中的mylistener EventListener
$ tkn eventlistener describe mylistener -n myspace

eventlistener 列表

列出 EventListeners。

示例:列出命名空间中的所有 EventListeners
$ tkn eventlistener list -n myspace

eventlistener 日志

显示 EventListener 的日志。

示例:显示命名空间中mylistener EventListener 的日志
$ tkn eventlistener logs mylistener -n myspace

triggerbinding

管理 TriggerBindings。

示例:显示 TriggerBindings 帮助信息
$ tkn triggerbinding -h

triggerbinding 删除

删除 TriggerBinding。

示例:从命名空间中删除mybinding1mybinding2 TriggerBindings
$ tkn triggerbinding delete mybinding1 mybinding2 -n myspace

triggerbinding 描述

描述 TriggerBinding。

示例:描述命名空间中的mybinding TriggerBinding
$ tkn triggerbinding describe mybinding -n myspace

triggerbinding 列表

列出 TriggerBindings。

示例:列出命名空间中的所有 TriggerBindings
$ tkn triggerbinding list -n myspace

triggertemplate

管理 TriggerTemplates。

示例:显示 TriggerTemplate 帮助信息
$ tkn triggertemplate -h

triggertemplate 删除

删除 TriggerTemplate。

示例:从命名空间中删除mytemplate1mytemplate2 TriggerTemplates
$ tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`

triggertemplate 描述

描述 TriggerTemplate。

示例:描述命名空间中的mytemplate TriggerTemplate
$ tkn triggertemplate describe mytemplate -n `myspace`

triggertemplate 列表

列出 TriggerTemplates。

示例:列出命名空间中的所有 TriggerTemplates
$ tkn triggertemplate list -n myspace

clustertriggerbinding

管理 ClusterTriggerBindings。

示例:显示 ClusterTriggerBindings 帮助信息
$ tkn clustertriggerbinding -h

clustertriggerbinding 删除

删除 ClusterTriggerBinding。

示例:删除myclusterbinding1myclusterbinding2 ClusterTriggerBindings
$ tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding2

clustertriggerbinding 描述

描述 ClusterTriggerBinding。

示例:描述myclusterbinding ClusterTriggerBinding
$ tkn clustertriggerbinding describe myclusterbinding

clustertriggerbinding 列表

列出 ClusterTriggerBindings。

示例:列出所有 ClusterTriggerBindings
$ tkn clustertriggerbinding list

Hub 交互命令

与 Tekton Hub 交互,例如任务和流水线资源。

hub

与 hub 交互。

示例:显示帮助
$ tkn hub -h
示例:与 hub API 服务器交互
$ tkn hub --api-server https://api.hub.tekton.dev

对于每个示例,要获取相应的子命令和标志,请运行tkn hub <command> --help

hub 降级

降级已安装的资源。

示例:将mynamespace 命名空间中的mytask 任务降级到旧版本
$ tkn hub downgrade task mytask --to version -n mynamespace

hub 获取

通过其名称、类型、目录和版本获取资源清单。

示例:从tekton 目录获取特定版本的myresource 管道或任务的清单
$ tkn hub get [pipeline | task] myresource --from tekton --version version

hub 信息

通过其名称、类型、目录和版本显示有关资源的信息。

示例:显示tekton 目录中特定版本的mytask 任务的信息
$ tkn hub info task mytask --from tekton --version version

hub 安装

通过其类型、名称和版本从目录安装资源。

示例:将tekton 目录中特定版本的mytask 任务安装到mynamespace 命名空间
$ tkn hub install task mytask --from tekton --version version -n mynamespace

hub 重新安装

通过其类型和名称重新安装资源。

示例:将tekton 目录中特定版本的mytask 任务重新安装到mynamespace 命名空间
$ tkn hub reinstall task mytask --from tekton --version version -n mynamespace

通过名称、类型和标签的组合搜索资源。

示例:搜索带有标签cli 的资源
$ tkn hub search --tags cli

hub 升级

升级已安装的资源。

示例:将mynamespace 命名空间中已安装的mytask 任务升级到新版本
$ tkn hub upgrade task mytask --to version -n mynamespace