技能介绍

解决什么问题

团队用 Jenkins 做流水线复用时，共享库（Shared Library）经常长成一笔糊涂账：vars/ 和 src/ 的职责边界没人维护，Groovy 语法错误要等流水线跑到一半才在控制台里炸出来，自定义 step 的逻辑没有任何测试覆盖，全项目库（Global Pipeline Libraries）在 Jenkins 实例里靠手工在界面上点选，换台机器就忘了配。这个技能针对的就是从「能跑」到「可维护」之间的这一堆工程债。

技能如何工作

它基于 Jenkins Pipeline Shared Groovy Libraries 插件的约定来管理工作区，核心能力包括：

结构管理：按插件规范维护共享库的目录布局，明确 vars/（面向流水线脚本的可调用入口）与 src/（实现代码）的分工；
语法校验：在提交前对 Groovy 做静态检查，把语法问题挡在流水线触发之前；
单元测试：用 jenkins-pipeline-unit 为 step 编写并运行测试，在本地模拟流水线环境验证行为，而不是每次改动都真跑一条 CI；
全局注册：通过 Jenkins CLI 配置 Global Pipeline Libraries，把库的注册变成可版本化、可脚本化的操作。

典型流程是：检查现有库的目录结构是否符合约定 → 编写或修正 vars/、src/ 下的 Groovy 代码 → 运行语法校验 → 用 jenkins-pipeline-unit 跑 step 测试 → 通过 Jenkins CLI 把库注册为全局流水线库。

适用边界与注意点

技能处理的是共享库本身的工程化问题，不负责 Jenkins 的安装与升级。Jenkins 官方提供 WAR、Docker 镜像、原生包和安装程序（覆盖多个 Linux 发行版与 Windows），实例环境需要自行准备；
jenkins-pipeline-unit 的测试是对流水线环境的模拟，与真实执行之间仍可能存在差异，上线前建议在测试实例上完整跑一遍；
通过 Jenkins CLI 修改全局库配置属于实例级变更，建议先在测试 Jenkins 上验证，再推广到正式环境；
该技能内容提取自 Jenkins 上游文档，Jenkins 插件生态更新较快，使用前请对照官方最新文档确认插件版本兼容性。