Agent Skills
返回列表
🔒

Tekton 流水线校验器

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/tekton-pipeline-validator。

技能介绍

它解决什么问题

Tekton 的流水线配置通常以 YAML 编写,字段层级深、命名严格,taskRef、resources、param 这类结构一旦写错,往往要等到 CI 实际运行时才会暴露:要么表现为一个难以定位的失败任务,要么被集群的准入机制拒绝之后才被发现,排查成本远高于修复成本。

它如何工作

该技能围绕三层校验展开:

  • Schema 校验:将 YAML 清单与 Tekton Pipelines 的 API schema 比对,识别字段拼写错误、类型不匹配、必填项缺失等结构性问题。
  • CLI 校验:借助 tkn 命令行工具检查清单,tkn 是 Tekton 的官方客户端,校验路径贴近真实运行环境。
  • 准入 Webhook 校验:利用 Kubernetes admission webhook,在资源真正写入集群之前拦截不合法的配置。

支持的资源类型包括 PipelineRun、TaskRun 和 Trigger。组成 Pipeline 的各个 Task 也可以独立运行,便于单独验证某一步是否配置正确,而不必触发整条流水线。

适用边界与注意点

Schema 校验能覆盖结构层面的错误,但无法判断业务语义是否正确,例如某个 param 的取值是否符合预期。技能文档提取自 Tekton 上游仓库的 README,若 Tekton 升级导致 schema 发生变化,校验逻辑需要同步更新。它不能替代 CI 中的实际执行测试,也不负责修复已经部署到集群的错误配置。

使用场景

  • 编写 Tekton PipelineRun 清单后,提交到集群前需要拦截格式和字段错误
  • 调整 TaskRun 的资源配置时,希望独立运行某个任务验证变更是否合法
  • 为 Trigger 配置添加参数前,需要确认字段类型是否符合 Tekton API 规范
  • 流水线反复在准入阶段被拒,需要定位是清单结构问题还是类型不匹配

适合人员

  • 维护 Tekton 流水线的 CI/CD 工程师,需要避免配置错误流入集群
  • 负责 Kubernetes 准入控制的平台工程师,需要统一 Tekton 资源的校验标准
  • 向集群交付 Tekton 清单的内部团队,希望在提交阶段就发现结构问题