1. 共享库概述

什么是 Jenkins 共享库

Jenkins 共享库（Shared Library）是一套可复用的 Pipeline 代码集合，它将 Groovy 函数、步骤、变量和逻辑封装为独立的模块，存储在 SCM（如 Git）仓库中，供多个 Jenkins Pipeline 按需加载和调用。共享库的核心思想是“一次编写，多处运行”，避免在每个 Jenkinsfile 中重复编写相同的构建、测试、部署逻辑。

共享库遵循固定的目录结构：

(root)
├── vars/               # 全局变量（可被 Pipeline 直接调用）
│   ├── buildApp.groovy
│   └── deployService.groovy
├── src/                # 辅助类（类似 Java 包结构）
│   └── org/company/
│       └── Utils.groovy
└── resources/          # 外部资源文件（如 JSON 模板）
    └── config.json

共享库的价值

共享库为团队和大型组织带来的核心收益体现在以下四个维度：

共享库与普通流水线的区别

普通流水线（Scripted/Declarative Pipeline）将全部逻辑写在单个 Jenkinsfile 中；共享库则将逻辑分层、解耦，形成“薄 Jenkinsfile + 厚共享库”的架构模式。两者的关键差异如下：

下图直观展示了普通流水线与共享库流水线在代码组织上的本质区别：

共享库的加载机制

Jenkins 通过 Global Pipeline Libraries 系统配置或 @Library 注解在 Jenkinsfile 中加载共享库。加载时支持指定版本（分支、标签或 commit ID），这是实现版本准入的基础：

// 方式一：在 Jenkins 系统配置中定义全局库，Jenkinsfile 中直接使用
@Library('my-shared-library@v2.1.0') _

// 方式二：在 Jenkinsfile 中动态加载指定版本
library identifier: 'my-shared-library@v2.1.0', retriever: modernSCM(
  [$class: 'GitSCMSource',
   remote: 'https://git.company.com/devops/shared-library.git',
   credentialsId: 'git-credentials'])

// 方式三：隐式加载（需在系统配置中设置“隐式加载”）
// 无需 @Library 注解，所有全局变量自动可用
buildApp()  // 直接调用 vars/buildApp.groovy