考察点:流水线复用、版本管理、约定优于配置。规模化 CI 的核心手段。
要点:
(root)
├── vars/ # 全局变量/步骤:vars/standardPipeline.groovy → 可直接像函数调用
├── src/ # 标准 Groovy 源码(包结构),需 import
├── resources/ # 非 Groovy 资源(模板、脚本、配置片段)
└── (可选) test/ # 单元测试(用 JenkinsPipelineUnit 等)
- 全局共享库:Jenkins 系统配置里绑定(所有流水线可用);文件夹级共享库:只在某个 Folder 下的流水线可用——多团队隔离时优先用文件夹级(避免不同团队互相干扰);
- 加载:@Library('[email protected]') _(注意 _ 是必须的,用于导入 vars/ 里的全局变量);或动态加载 library 'my-lib@main'(可运行时决定版本)。
1. vars/ 放「业务意图级」的步骤,src/ 放可测试的纯逻辑:如 vars/buildJavaApp.groovy(一个完整的构建步骤)+ src/com/x/Version.groovy(版本号计算逻辑,可单元测试);
2. 参数化与默认值:公共步骤要有合理默认值(buildJavaApp(jdk: '17', skipTests: false)),让 90% 的项目无需传参;
3. 不要过度抽象:只有被两条以上流水线使用、且逻辑稳定的部分才抽;为「将来可能」抽象出来的参数会成为没人敢改的历史包袱;
4. 版本必须固定:用 tag 或 commit sha 引用(@v1.2.0 / @abc1234),绝不要用 @main——否则共享库改动会同时影响所有项目,等于绕过所有测试直接上线(这是最大风险);
5. 兼容性策略:Breaking change 必须新增大版本(@v2),让项目自己排期迁移;Jenkinsfile 里显式声明版本使影响面可枚举;
6. 幂等与可观测:公共步骤内部要打清晰日志、设置超时、失败时给出可行动的错误信息(「镜像推送失败,请检查 credentialsId=xxx 是否有权限」远胜于「script returned exit code 1」)。
- 值得:多个仓库/服务共享同一套构建部署流程(微服务的标准流水线)、有明确的组织级规范(必须跑哪些安全检查、必须打哪些标签)、需要强制的质量门禁(把门禁做成共享步骤,项目无法绕过);
- 不值得:只有 1–2 个项目、流程差异大且不稳定、或团队还没形成规范(抽早了 = 抽错,后续要花更大力气改)。
JenkinsPipelineUnit 能在本地跑流水线逻辑,不必真起 Jenkins);给共享库指定 owner,否则会变成没人维护的公共资产。vars/ 步骤无需 import,但需要 @Library(...) _;共享库改动后 Jenkins 会缓存,@Library 的版本切换需要重新拉取(可在「Global Pipeline Libraries」里配置 Allow default version to be overridden);把「Pipeline 模板 + 共享库」做成脚手架(新项目一条命令生成 Jenkinsfile)是大型组织的标准做法。题目与答案就在本页;收藏、批注和错题重练在应用内