红帽全球峰会This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.5.3. OpenShift Pipelines tkn 参考
本节列出了基本的 tkn CLI 命令。
5.3.1. 基本语法
tkn [command or options] [arguments…]
5.3.2. 全局选项
--help, -h
5.3.3. 工具命令
5.3.3.1. tkn
tkn CLI 的主命令。
示例： 显示所有选项
tkn
$ tkn5.3.3.2. completion [shell]
输出 shell 完成代码，必须经过评估方可提供互动完成。支持的 shell 是 bash 和 zsh。
示例：bash shell 完成代码
tkn completion bash
$ tkn completion bash5.3.3.3. version
输出 tkn CLI 的版本信息。
示例： 检查 tkn 版本
tkn version
$ tkn version5.3.4. Pipelines 管理命令
5.3.4.1. pipeline
管理管道。
示例： 显示帮助信息
tkn pipeline --help
$ tkn pipeline --help5.3.4.2. pipeline create
创建一个 Pipeline
示例： 在命名空间中创建一个由 mypipeline.yaml 文件定义的 Pipeline
tkn pipeline create -f mypipeline.yaml -n myspace
$ tkn pipeline create -f mypipeline.yaml -n myspace5.3.4.3. pipeline delete
删除 Pipeline
示例： 从命名空间中删除 mypipeline Pipeline
tkn pipeline delete mypipeline -n myspace
$ tkn pipeline delete mypipeline -n myspace5.3.4.4. pipeline describe
描述管道。
示例： 描述 mypipeline Pipeline
tkn pipeline describe mypipeline
$ tkn pipeline describe mypipeline5.3.4.5. pipeline list
列出管道。
示例： 显示 Pipelines 列表
tkn pipeline list
$ tkn pipeline list5.3.4.6. pipeline logs
显示特定 Pipeline 的 Pipeline 日志。
示例：mypipeline Pipeline 的 Stream live 日志
tkn pipeline logs -f mypipeline
$ tkn pipeline logs -f mypipeline5.3.4.7. pipeline start
运行 Pipeline。
示例： 启动 mypipeline Pipeline
tkn pipeline start mypipeline
$ tkn pipeline start mypipeline5.3.5. PipelineRun 命令
5.3.5.1. pipelinerun
管理 PipelineRuns。
示例： 显示帮助信息
tkn pipelinerun -h
$ tkn pipelinerun -h5.3.5.2. pipelinerun cancel
取消 PipelineRun。
示例：从命名空间中取消 mypipelinerun PipelineRun
tkn pipelinerun cancel mypipelinerun -n myspace
$ tkn pipelinerun cancel mypipelinerun -n myspace5.3.5.3. pipelinerun delete
删除 PipelineRun。
示例： 从命名空间中删除 PipelineRuns
tkn pipelinerun delete mypipelinerun1 mypipelinerun2 -n myspace
$ tkn pipelinerun delete mypipelinerun1 mypipelinerun2 -n myspace5.3.5.4. pipelinerun describe
描述 PipelineRun。
示例：描述命名空间中的 mypipelinerun PipelineRun
tkn pipelinerun describe mypipelinerun -n myspace
tkn pipelinerun describe mypipelinerun -n myspace5.3.5.5. pipelinerun list
列出 PipelineRuns。
示例： 显示命名空间中的 PipelineRuns 列表
tkn pipelinerun list -n myspace
$ tkn pipelinerun list -n myspace5.3.5.6. pipelinerun logs
显示一个 PipelineRun 的日志。
示例：显示 mypipelinerun PipelineRun 的日志，包括命名空间中的所有任务和步骤
tkn pipelinerun logs mypipelinerun -a -n myspace
$ tkn pipelinerun logs mypipelinerun -a -n myspace5.3.6. 任务管理命令
5.3.6.1. task
管理任务。
示例： 显示帮助信息
tkn task -h
$ tkn task -h5.3.6.2. task create
创建任务。
示例： 在命名空间中创建 mytask.yaml 文件定义的任务
tkn task create -f mytask.yaml -n myspace
$ tkn task create -f mytask.yaml -n myspace5.3.6.3. task delete
删除一个任务。
示例：从命令空间中删除 mytask1 和 mytask2 任务
tkn task delete mytask1 mytask2 -n myspace
$ tkn task delete mytask1 mytask2 -n myspace5.3.6.4. task describe
描述一个任务。
示例：描述一个命名空间中的 mytask 任务
tkn task describe mytask -n myspace
$ tkn task describe mytask -n myspace5.3.6.5. task list
列出任务。
示例： 列出命名空间中的所有任务
tkn task list -n myspace
$ tkn task list -n myspace5.3.6.6. task logs
显示任务日志。
示例：显示 mytask 任务的 mytaskrun TaskRun 的日志
tkn task logs mytask mytaskrun -n myspace
$ tkn task logs mytask mytaskrun -n myspace5.3.6.7. task start
启动一个任务。
示例： 在命名空间中启动 mytask 任务
tkn task start mytask -s <ServiceAccountName> -n myspace
$ tkn task start mytask -s <ServiceAccountName> -n myspace5.3.7. TaskRun 命令
5.3.7.1. taskrun
管理 TaskRuns。
示例： 显示帮助信息
tkn taskrun -h
$ tkn taskrun -h5.3.7.2. taskrun cancel
取消 TaskRun。
示例：从一个命名空间中取消 mytaskrun TaskRun
tkn taskrun cancel mytaskrun -n myspace
$ tkn taskrun cancel mytaskrun -n myspace5.3.7.3. taskrun delete
删除一个 TaskRun。
示例：从一个命名空间中删除 mytaskrun1 和 mytaskrun2 TaskRuns
tkn taskrun delete mytaskrun1 mytaskrun2 -n myspace
$ tkn taskrun delete mytaskrun1 mytaskrun2 -n myspace5.3.7.4. taskrun describe
描述 TaskRun。
示例：描述命名空间中的 mytaskrun TaskRun
tkn taskrun describe mytaskrun -n myspace
$ tkn taskrun describe mytaskrun -n myspace5.3.7.5. taskrun list
列出 TaskRuns。
示例： 列出命名空间中的所有 TaskRuns
tkn taskrun list -n myspace
$ tkn taskrun list -n myspace5.3.7.6. taskrun logs
显示 TaskRun 日志。
示例： 显示命名空间中 mytaskrun TaskRun 的实时日志
tkn taskrun logs -f mytaskrun -n myspace
$ tkn taskrun logs -f mytaskrun -n myspace5.3.8. 条件管理命令
5.3.8.1. 条件
管理条件（Condition）。
示例： 显示帮助信息
tkn condition --help
$ tkn condition --help5.3.8.2. 删除条件
删除一个条件。
示例：从命名空间中删除 mycondition1 Condition
tkn condition delete mycondition1 -n myspace
$ tkn condition delete mycondition1 -n myspace5.3.8.3. condition describe
描述条件。
示例：在命名空间中描述 mycondition1 Condition
tkn condition describe mycondition1 -n myspace
$ tkn condition describe mycondition1 -n myspace5.3.8.4. condition list
列出条件。
示例： 列出命名空间中的条件
tkn condition list -n myspace
$ tkn condition list -n myspace5.3.9. Pipeline 资源管理命令
5.3.9.1. resource
管理管道资源。
示例： 显示帮助信息
tkn resource -h
$ tkn resource -h5.3.9.2. resource create
创建一个 Pipeline 资源。
示例：在一个命名空间中创建由 myresource.yaml 文件定义的 Pipeline 资源
tkn resource create -f myresource.yaml -n myspace
$ tkn resource create -f myresource.yaml -n myspace5.3.9.3. resource delete
删除 Pipeline 资源。
示例：从命名空间中删除 myresource Pipeline 资源
tkn resource delete myresource -n myspace
$ tkn resource delete myresource -n myspace5.3.9.4. resource describe
描述管道资源。
示例：描述 myresource Pipeline 资源
tkn resource describe myresource -n myspace
$ tkn resource describe myresource -n myspace5.3.9.5. resource list
列出管道资源。
示例： 列出命名空间中的所有管道资源
tkn resource list -n myspace
$ tkn resource list -n myspace5.3.10. ClusterTask 管理命令
5.3.10.1. clustertask
管理 ClusterTasks。
示例： 显示帮助信息
tkn clustertask --help
$ tkn clustertask --help5.3.10.2. clustertask delete
删除集群中的 ClusterTask 资源。
示例： 删除 mytask1 和 mytask2 ClusterTasks
tkn clustertask delete mytask1 mytask2
$ tkn clustertask delete mytask1 mytask25.3.10.3. clustertask describe
描述 ClusterTask。
示例： 描述 mytask ClusterTask
tkn clustertask describe mytask1
$ tkn clustertask describe mytask15.3.10.4. clustertask list
列出 ClusterTasks。
示例： 列出 ClusterTasks
tkn clustertask list
$ tkn clustertask list5.3.10.5. clustertask start
启动 ClusterTasks。
示例： 启动 mytask ClusterTask
tkn clustertask start mytask
$ tkn clustertask start mytask5.3.11. 触发器管理命令
5.3.11.1. eventlistener
管理 EventListeners。
示例： 显示帮助信息
tkn eventlistener -h
$ tkn eventlistener -h5.3.11.2. eventlistener delete
删除一个 EventListener。
示例：删除命令空间中的 mylistener1 和 mylistener2 EventListeners
tkn eventlistener delete mylistener1 mylistener2 -n myspace
$ tkn eventlistener delete mylistener1 mylistener2 -n myspace5.3.11.3. eventlistener describe
描述 EventListener。
示例：描述命名空间中的 mylistener EventListener
tkn eventlistener describe mylistener -n myspace
$ tkn eventlistener describe mylistener -n myspace5.3.11.4. eventlistener list
列出 EventListeners。
示例： 列出命名空间中的所有 EventListeners
tkn eventlistener list -n myspace
$ tkn eventlistener list -n myspace5.3.11.5. triggerbinding
管理 TriggerBindings。
示例： 显示 TriggerBindings 帮助信息
tkn triggerbinding -h
$ tkn triggerbinding -h5.3.11.6. triggerbinding delete
删除 TriggerBinding。
示例：删除一个命名空间中的 mybinding1 和 mybinding2 TriggerBindings
tkn triggerbinding delete mybinding1 mybinding2 -n myspace
$ tkn triggerbinding delete mybinding1 mybinding2 -n myspace5.3.11.7. triggerbinding describe
描述 TriggerBinding。
示例：描述命名空间中的 mybinding TriggerBinding
tkn triggerbinding describe mybinding -n myspace
$ tkn triggerbinding describe mybinding -n myspace5.3.11.8. triggerbinding list
列出 TriggerBindings。
示例： 列出命名空间中的所有 TriggerBindings
tkn triggerbinding list -n myspace
$ tkn triggerbinding list -n myspace5.3.11.9. triggertemplate
管理 TriggerTemplates。
示例： 显示 TriggerTemplate 帮助
tkn triggertemplate -h
$ tkn triggertemplate -h5.3.11.10. triggertemplate delete
删除 TriggerTemplate。
示例：删除命名空间中的 mytemplate1 和 mytemplate2 TriggerTemplates
tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`
$ tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`5.3.11.11. triggertemplate describe
描述 TriggerTemplate。
示例： 描述命名空间中的 mytemplate TriggerTemplate
tkn triggertemplate describe mytemplate -n `myspace`
$ tkn triggertemplate describe mytemplate -n `myspace`5.3.11.12. triggertemplate list
列出 TriggerTemplates。
示例： 列出命名空间中的所有 TriggerTemplates
tkn triggertemplate list -n myspace
$ tkn triggertemplate list -n myspace5.3.11.13. clustertriggerbinding
管理 ClusterTriggerBindings。
示例： 显示 ClusterTriggerBindings 帮助信息
tkn clustertriggerbinding -h
$ tkn clustertriggerbinding -h5.3.11.14. clustertriggerbinding delete
删除 ClusterTriggerBinding。
示例： 删除 myclusterbinding1 和 myclusterbinding2 ClusterTriggerBindings
tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding2
$ tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding25.3.11.15. clustertriggerbinding describe
描述 ClusterTriggerBinding。
示例： 描述 myclusterbinding ClusterTriggerBinding
tkn clustertriggerbinding describe myclusterbinding
$ tkn clustertriggerbinding describe myclusterbinding5.3.11.16. clustertriggerbinding list
列出 ClusterTriggerBindings。
示例： 列出所有 ClusterTriggerBindings
tkn clustertriggerbinding list
$ tkn clustertriggerbinding list
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}