18.6.1 插件管理与更新策略

在 Jenkins 中，插件是功能扩展核心，管理与更新策略直接影响稳定性与安全性。本节以“插件管理与更新策略”为中心，覆盖原理草图、安装与更新示例、离线管理、排错方法与练习。

插件管理入口位于“管理 Jenkins → 插件管理”，包含“已安装”“可选插件”“可更新”“高级”视图。建议制定插件基线与更新窗口，避免随意安装导致依赖冲突。关键原则：固定 Jenkins LTS 版本、插件版本锁定、变更记录可追溯。

安装与更新示例（Web 界面 + CLI）

1) Web 界面安装插件（以 Git 插件为例）
步骤：插件管理 → 可选插件 → 搜索 Git → 勾选 → 安装并重启。
预期：重启后“已安装”列表出现 Git 插件，流水线可用 git 步骤。

2) CLI 安装/更新插件（适合批量化）
前提：已配置 Jenkins CLI。

# 1) 获取 CLI
JENKINS_URL=http://jenkins.example.com
curl -o jenkins-cli.jar $JENKINS_URL/jnlpJars/jenkins-cli.jar

# 2) 列出已安装插件
java -jar jenkins-cli.jar -s $JENKINS_URL -auth admin:token list-plugins

# 3) 安装插件并自动安装依赖
java -jar jenkins-cli.jar -s $JENKINS_URL -auth admin:token install-plugin git -deploy -restart

# 4) 批量更新所有可更新插件
java -jar jenkins-cli.jar -s $JENKINS_URL -auth admin:token install-plugin \
  $(java -jar jenkins-cli.jar -s $JENKINS_URL -auth admin:token list-plugins | awk '/\) {print $1}') \
  -deploy -restart

离线环境插件安装示例

离线环境需下载 .hpi/.jpi 包与依赖插件，确保 Jenkins 版本兼容。

# 1) 下载插件及依赖（在有网机器）
# 访问 https://updates.jenkins.io/download/plugins/git/
# 例如：git.hpi, credentials.hpi, git-client.hpi ...

# 2) 拷贝到 Jenkins 服务器
scp *.hpi jenkins@server:/var/lib/jenkins/plugins/

# 3) 权限修正并重启
sudo chown jenkins:jenkins /var/lib/jenkins/plugins/*.hpi
sudo systemctl restart jenkins

# 4) 验证加载
grep -i "Loaded plugin" /var/log/jenkins/jenkins.log | tail -n 20

更新策略示例：分层+灰度

开发/测试环境先更新验证
生产环境在统一窗口更新
更新顺序：核心版本 → 基础插件（Credentials/Pipeline/Git）→ 业务插件

建议维护“插件基线清单”，用于复现环境与快速回滚：

# 导出插件基线清单
java -jar jenkins-cli.jar -s $JENKINS_URL -auth admin:token list-plugins > plugins-baseline.txt

备份与回滚示例

更新前至少备份 $JENKINS_HOME 与插件目录：

# 停止 Jenkins
sudo systemctl stop jenkins

# 备份关键目录
tar -czf /backup/jenkins_home_$(date +%F).tar.gz /var/lib/jenkins

# 启动 Jenkins
sudo systemctl start jenkins

回滚插件示例（恢复特定版本）：

# 1) 替换插件文件
sudo cp /backup/plugins/git.hpi /var/lib/jenkins/plugins/git.hpi
sudo rm -f /var/lib/jenkins/plugins/git.jpi.pinned
sudo systemctl restart jenkins

# 2) 检查是否加载
grep -i "git" /var/log/jenkins/jenkins.log | tail -n 20

排错方法与常见问题

1) 插件加载失败
- 现象：界面提示“Failed to load”
- 排查：检查日志、依赖缺失、核心版本不兼容
- 命令：

# 查看加载失败原因
grep -i "Failed to load plugin" /var/log/jenkins/jenkins.log

# 查看依赖
unzip -p /var/lib/jenkins/plugins/git.hpi META-INF/MANIFEST.MF | grep -i "Plugin-Dependencies"

2) 更新后流水线失败
- 现象：某些 step 找不到或行为变化
- 处理：回滚插件或在测试环境验证后再升级
- 命令：

# 禁用插件（通过创建 .disabled 文件）
sudo touch /var/lib/jenkins/plugins/git.hpi.disabled
sudo systemctl restart jenkins

3) 依赖链冲突
- 现象：插件被标记为“需要更高版本核心”
- 处理：固定 Jenkins LTS，优先更新核心再更新插件
- 命令：

# 检查 Jenkins 核心版本
java -jar jenkins-cli.jar -s $JENKINS_URL -auth admin:token version

安全与更新站点设置示例

在“插件管理 → 高级”中设置更新站点，建议使用官方或内网镜像。
示例内网更新站点：

# /var/lib/jenkins/updates/default.json (示例)
{
  "id": "default",
  "url": "https://jenkins-mirror.example.com/updates/update-center.json"
}

练习

1) 在测试环境安装 Git 插件与依赖，导出插件基线清单。
2) 模拟离线安装：手动复制 .hpi 到 plugins 目录并验证加载日志。
3) 更新一个插件后执行一条 Pipeline，若失败则回滚并定位原因。
4) 禁用一个插件并观察 Jenkins 日志与作业行为变化。