Agent Skills
返回列表
🔒

Jenkins 流水线共享库检查器

IT 运维与安全 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/jenkins-pipeline-shared-library-linter。

技能介绍

问题：流水线语法错误发现太晚

Jenkins Pipeline 共享库通常以 Jenkinsfile 形式存放在版本控制中，但 Declarative 和 Scripted 两种语法的校验都依赖 Jenkins 控制器环境。开发者在本地编写或修改共享库时，往往只能等到 Pipeline 真正运行时才暴露语法错误，调试成本高、修复周期长。共享库被多个项目引用时，一处语法问题可能波及整个 CI/CD 链路。

核心能力：调用 REST API 做语法检查

该技能通过 Jenkins REST API 和 CLI jar 调用控制器的 /pipeline-model-converter/validate 端点，对 Jenkinsfile 进行语法校验。关键步骤包括：

  • 连接 Jenkins 控制器：支持连接运行中的实例或沙箱环境
  • 提交校验请求：将 Jenkinsfile 发给 /pipeline-model-converter/validate 进行解析
  • 定位错误位置：校验失败时返回具体行号和错误描述
  • 提供修复建议：针对常见语法问题给出修复方向

适用边界与注意点

  • 校验结果取决于控制器版本，不同版本的 Pipeline 语法支持范围可能不同
  • 目标控制器需可访问，沙箱环境应与生产环境隔离
  • 该工具只检查语法层面，不评估逻辑正确性或编码最佳实践
  • CLI jar 和 REST API 调用需正确配置认证凭据

使用场景

  • 在本地修改 Jenkins Pipeline 共享库，提交前需通过 validate 端点确认 Jenkinsfile 语法正确。
  • 在 Docker 沙箱 Jenkins 控制器中，批量校验多个 Jenkinsfile 语法，确认无错误后再推到生产。
  • CI/CD 流水线中 Jenkinsfile 解析报错，用行号定位到具体语句并按建议修复。
  • 升级 Jenkins 控制器版本前，用语法校验检查现有流水线脚本的兼容性问题。

适合人员

  • Jenkins 共享库维护工程师，需要在 GitLab 合并前本地完成 Jenkinsfile 语法检查
  • CI/CD 平台工程师，需要在沙箱控制器批量校验 Jenkinsfile 语法后再上线
  • Jenkins 控制器升级负责人，需要提前发现流水线脚本的语法兼容性问题
  • 流水线脚本开发者，需要按行号快速定位 Jenkinsfile 解析失败的具体语句