Jenkins 流水线校验 Agent

它解决的问题

维护 Jenkinsfile 时，语法错误常常到构建那一刻才被发现：PR 合并时、或代码推送触发 CI 之后，修复成本已经从「改一行文本」扩大为「为一次失败的流水线运行买单」。声明式（Declarative Pipeline）与脚本式（Scripted Pipeline）语法差异不小，执行引擎对声明式特有的结构问题（如 stages 缺失、environment 块误用）报错并不友好。这个技能要解决的，就是把这类问题提前到提交之前。

它的工作方式

核心能力是把 Jenkinsfile 提交给 Jenkins Pipeline Linter REST API 做服务端校验，而不是纯粹的本地静态解析：

• 借助 jenkins-client npm SDK 完成认证与请求提交，对接目标 Jenkins 服务；
• 同时支持声明式与脚本式流水线，按文件内容原样提交校验；
• 校验逻辑运行在服务端，语法与结构问题由与生产一致的实例解析，避免本地检查与服务端行为不一致的坑。

典型流程：

• 提交前读取工作区中的 Jenkinsfile；
• 由 Agent 通过 SDK 调用 Linter 接口；
• 根据返回结果决定是否继续提交。

适用边界与注意点

• 前提是存在可访问的 Jenkins 服务，且 jenkins-client 的认证配置正确，否则无法完成服务端校验；
• 上游 Jenkins 官方分发提供 WAR、Docker 镜像、原生包与 Windows 安装包等形式，部署方式需与自身环境对齐；
• 上游资料未说明规则集细节，建议先确认所用 Jenkins 版本对应的 API 实际覆盖哪些报错类型；
• 它只处理语法与结构校验，不替代真实执行测试，job 资源访问、agent 调度等语义问题仍需 CI 运行才能暴露。