×

基本语法

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

删除管道。

示例:从命名空间删除管道
$ tkn pipeline delete <pipeline_name> -n <namespace_name>

pipeline describe

描述管道。

示例:描述管道
$ tkn pipeline describe <pipeline_name>

pipeline list

显示管道列表。

示例:显示管道列表
$ tkn pipeline list

pipeline logs

显示特定管道的日志。

示例:流式传输管道的实时日志
$ tkn pipeline logs -f <pipeline_name>

pipeline start

启动管道。

示例:启动管道
$ tkn pipeline start <pipeline_name>

管道运行命令

pipelinerun

管理管道运行。

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

pipelinerun cancel

取消管道运行。

示例:从命名空间取消管道运行
$ tkn pipelinerun cancel <pipeline_run_name> -n <namespace_name>

pipelinerun delete

删除管道运行。

示例:从命名空间删除管道运行
$ tkn pipelinerun delete <pipeline_run_name_1> <pipeline_run_name_2> -n <namespace_name>
示例:从命名空间删除所有管道运行,除了最近执行的五个管道运行
$ tkn pipelinerun delete -n <namespace_name> --keep 5 (1)
1 5替换为您要保留的最近执行的流水线运行次数。
示例:删除所有流水线
$ tkn pipelinerun delete --all

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

pipelinerun describe

描述流水线运行。

示例:描述命名空间中的流水线运行
$ tkn pipelinerun describe <pipeline_run_name> -n <namespace_name>

pipelinerun list

列出流水线运行。

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

pipelinerun logs

显示流水线运行的日志。

示例:显示命名空间中包含所有任务和步骤的流水线运行日志
$ tkn pipelinerun logs <pipeline_run_name> -a -n <namespace_name>

任务管理命令

task

管理任务。

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

task delete

删除任务。

示例:从命名空间删除任务
$ tkn task delete <task_name_1> <task_name_2> -n <namespace_name>

task describe

描述任务。

示例:描述命名空间中的任务
$ tkn task describe <task_name> -n <namespace_name>

task list

列出任务。

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

task start

启动任务。

示例:在命名空间中启动任务
$ tkn task start <task_name> -s <service_account_name> -n <namespace_name>

任务运行命令

taskrun

管理任务运行。

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

taskrun cancel

取消任务运行。

示例:从命名空间取消任务运行
$ tkn taskrun cancel <task_run_name> -n <namespace_name>

taskrun delete

删除 TaskRun。

示例:从命名空间删除任务运行
$ tkn taskrun delete <task_run_name_1> <task_run_name_2> -n <namespace_name>
示例:从命名空间删除除最近执行的五个任务运行之外的所有任务运行
$ tkn taskrun delete -n <namespace_name> --keep 5 (1)
1 5替换为您要保留的最近执行的任务运行次数。

taskrun describe

描述任务运行。

示例:描述命名空间中的任务运行
$ tkn taskrun describe <task_run_name> -n <namespace_name>

taskrun list

列出任务运行。

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

taskrun logs

显示任务运行日志。

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

流水线资源管理命令

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

触发器管理命令

eventlistener

管理事件监听器。

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

eventlistener delete

删除事件监听器。

示例:从命名空间删除mylistener1mylistener2事件监听器
$ tkn eventlistener delete mylistener1 mylistener2 -n myspace

eventlistener describe

描述事件监听器。

示例:描述命名空间中的mylistener事件监听器
$ tkn eventlistener describe mylistener -n myspace

eventlistener list

列出事件监听器。

示例:列出命名空间中的所有事件监听器
$ tkn eventlistener list -n myspace

eventlistener logs

显示事件监听器的日志。

示例:显示命名空间中mylistener事件监听器的日志
$ tkn eventlistener logs mylistener -n myspace

triggerbinding

管理触发器绑定。

示例:显示触发器绑定帮助
$ tkn triggerbinding -h

triggerbinding delete

删除触发器绑定。

示例:从命名空间删除mybinding1mybinding2触发器绑定
$ tkn triggerbinding delete mybinding1 mybinding2 -n myspace

triggerbinding describe

描述触发器绑定。

示例:描述命名空间中的mybinding触发器绑定
$ tkn triggerbinding describe mybinding -n myspace

triggerbinding list

列出触发器绑定。

示例:列出命名空间中的所有触发器绑定
$ tkn triggerbinding list -n myspace

triggertemplate

管理触发器模板。

示例:显示触发器模板帮助
$ tkn triggertemplate -h

triggertemplate delete

删除触发器模板。

示例:从命名空间删除mytemplate1mytemplate2触发器模板
$ tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`

triggertemplate describe

描述触发器模板。

示例:描述命名空间中的mytemplate触发器模板
$ tkn triggertemplate describe mytemplate -n `myspace`

triggertemplate list

列出触发器模板。

示例:列出命名空间中的所有触发器模板
$ tkn triggertemplate list -n myspace

clustertriggerbinding

管理集群触发器绑定。

示例:显示集群触发器绑定帮助
$ tkn clustertriggerbinding -h

clustertriggerbinding delete

删除集群触发器绑定。

示例:删除myclusterbinding1myclusterbinding2集群触发器绑定
$ tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding2

clustertriggerbinding describe

描述集群触发器绑定。

示例:描述myclusterbinding集群触发器绑定
$ tkn clustertriggerbinding describe myclusterbinding

clustertriggerbinding list

列出集群触发器绑定。

示例:列出所有集群触发器绑定
$ 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