SuperAPI AI 工具集

jenkinsfile-validator

部署与运维

查看项目

更新于 10-15 16:46

技能介绍

用途:校验与审计 Jenkins 流水线及共享库文件。支持 Declarative 流水线(pipeline { ... })、Scripted 流水线(node { ... } 及 Groovy 风格)、共享库文件(vars/.groovy、src/**/.groovy),并检查硬编码凭据与可维护性信号。

主要能力:先检测流水线类型,再执行语法校验、安全扫描(check_credentials)、最佳实践检查,最后汇总各阶段结果与最终退出码。遇未知插件步骤时,依次查阅本地 references/common_plugins.md、Context7 文档或官方插件站。

用法:脚本位于 devops-skills-plugin/skills/jenkinsfile-validator/scripts/。先设 SKILL_DIR="devops-skills-plugin/skills/jenkinsfile-validator",全量校验:bash "$SKILL_DIR/scripts/validate_jenkinsfile.sh" "$TARGET_JENKINSFILE";常用选项含 --syntax-only、--security-only、--best-practices、--no-security、--no-best-practices、--strict、--assume-declarative、--assume-scripted。共享库:bash "$SKILL_DIR/scripts/validate_shared_library.sh" vars/(也可传 src/ 或目录路径)。回归检查:bash "$SKILL_DIR/tests/run_local_ci.sh"。需要直接执行脚本时可 chmod +x devops-skills-plugin/skills/jenkinsfile-validator/scripts/*.sh。

退出码:主脚本 0 通过、1 失败(strict 下警告也算失败)、2 用法或环境错误;共享库脚本 0 通过、1 有错误、2 输入无效。日志级别 ERROR 必须修、WARNING 应复查、INFO 为可选改进。

限制:依赖 bash、grep、sed、awk、head、wc、find,jq 为可选项;缺少子脚本时该阶段报失败;无法联网查插件文档时仅做本地校验并说明原因。