×

基本语法

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

全局选项

--help, -h

实用程序命令

tkn

tkn CLI 的父命令。

示例:显示所有选项
$ tkn

completion [shell]

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

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

version

打印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

流水线启动

启动流水线。

示例:启动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

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

resource delete

删除流水线资源。

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

resource describe

描述流水线资源。

示例:描述myresource流水线资源
$ tkn resource describe myresource -n myspace

resource list

列出流水线资源。

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

ClusterTask管理命令

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

clustertask

管理ClusterTasks。

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

clustertask delete

删除集群中的ClusterTask资源。

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

clustertask describe

描述ClusterTask。

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

clustertask list

列出ClusterTasks。

示例:列出ClusterTasks
$ tkn clustertask list

clustertask start

启动ClusterTasks。

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

触发器管理命令

eventlistener

管理EventListeners。

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

eventlistener delete

删除EventListener。

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

eventlistener describe

描述EventListener。

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

eventlistener list

列出EventListeners。

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

eventlistener logs

显示EventListener的日志。

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

triggerbinding

管理TriggerBindings。

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

triggerbinding delete

删除TriggerBinding。

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

triggerbinding describe

描述TriggerBinding。

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

triggerbinding list

列出TriggerBindings。

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

triggertemplate

管理TriggerTemplates。

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

triggertemplate delete

删除TriggerTemplate。

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

triggertemplate describe

描述TriggerTemplate。

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

triggertemplate list

列出TriggerTemplates。

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

clustertriggerbinding

管理ClusterTriggerBindings。

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

clustertriggerbinding delete

删除ClusterTriggerBinding。

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

clustertriggerbinding describe

描述ClusterTriggerBinding。

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

clustertriggerbinding list

列出 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 downgrade

降级已安装的资源。

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

hub get

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

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

hub info

显示资源的信息,包括其名称、类型、目录和版本。

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

hub install

从目录中根据其类型、名称和版本安装资源。

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

hub reinstall

根据其类型和名称重新安装资源。

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

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

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

hub upgrade

升级已安装的资源。

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