# 添加 Pipeline 库

将通用的、可复用的流水线步骤封装成 Pipeline 共享库，并且在 Jenkins 中进行配置，可以帮助您更好地管理 Jenkins Pipeline 脚本，降低代码冗余的同时提高 Pipeline 脚本的可维护性。

# 操作步骤

1. 登录 Jenkins。

2. 在 Jenkins 主页面，单击系统管理 > 系统配置。

   

3. 在系统配置页面的 Global Pipeline Libraries 区域，单击新增。

   

4. 在 Library 区域，参考表 1 完成基本参数的配置，参考表 2 完成 Pipeline 库检索方法的配置。

   

   表 1 添加 Pipeline 库参数说明

   参数	描述	示例
   Name	标识 Pipeline 库的名称	share_pipeline
   Default version	默认使用的 Pipeline 库版本，通常是一个分支或标签。当 Pipeline 脚本引用 Pipeline 库时，如果没有指定具体的版本号，默认使用此版本	master
   Load implicitly	是否在 Pipeline 项目中隐式加载此 Pipeline 库	否
   Allow default version to be overridden	是否允许在 Pipeline 项目中覆盖默认的库版本	是
   Include @Library changes in job recent changes	是否在作业的最近更改中包含 @Library 更改	是
   Cache fetched versions on controller for quick retrieval	是否在控制器上缓存已获取的库版本，以便快速检索	否

   表 2 Pipeline 库检索方法参数说明

   参数类型	参数	描述
   Retrieval method	Modern SCM	使用现代的源代码管理工具（如 Git、Mercurial 等）作为 Pipeline 库的检索方法。选择此方法后，还需配置以下字段： Source Code Management：指定使用的现代源代码管理工具（如 Git、GitHub等），以 Git 为例，还需配置以下字段： 项目仓库：全局 Pipeline 库的实际 Git 仓库 URL 凭据：访问 Git 仓库的凭据，用于 Jenkins 在拉取或克隆 Git 仓库时进行身份验证，如何新建凭据，请参见 新建凭据 行为：Git 的高级选项，用于配置 Jenkins 与 Git 仓库交互的方式，例如轮询触发、子模块的递归初始化等 Fresh clone per build：是否在每次构建流水线时都进行全新的代码克隆操作 Library Path (optional)：（可选）全局 Pipeline 库所在的路径
   	Legacy SCM	使用传统的源代码管理工具（如 Subversion、CVS 等）作为 Pipeline 库的检索方法

5. 单击保存，完成参数配置。