tkn

Tekton 命令行客户端

补充说明

tkn 是 Tekton 的 CLI，用来管理 Pipeline、Task、PipelineRun、TaskRun 和 Trigger。Tekton 本身以 Kubernetes CRD 运行，所以 tkn 背后操作的都是集群对象。

常用示例

tkn version
tkn pipeline list
tkn pipeline start build-and-test --showlog
tkn pipeline start build-and-test -p repo-url=https://github.com/example/app.git -w name=source,claimName=workspace
tkn task list
tkn taskrun list
tkn pipelinerun logs -f
tkn hub install task git-clone
tkn trigger list
tkn eventlistener list

易错点与排错

• tkn 依赖 kubeconfig 和命名空间；先确认 kubectl config current-context。
• Pipeline 需要 ServiceAccount、Workspace 和镜像拉取权限；缺一个就会一直 Pending。
• Workspace 可以是 PVC、emptyDir 或 ConfigMap；类型和参数写错会挂载失败。
• tkn pipeline start 默认生成新 PipelineRun；要复用参数用 --last 或 --use-param-defaults。
• tkn hub install 需要网络；内网环境要提前同步或手写 YAML。
• Tekton 版本和 tkn 版本不匹配时，部分子命令可能不可用。
• 旧的 PipelineResource 已废弃；新配置用 Task 和 Workspace。
• 日志跟随中断不代表任务失败；用 tkn pipelinerun describe 看最终状态。

相关命令

• kubectl — 查看 Tekton CRD
• tekton — Kubernetes 分支的 Tekton 页面
• argocd — GitOps 交付