Ubuntu Jenkins如何进行插件更新

Ubuntu 上 Jenkins 插件更新指南

一 通过 Web 界面更新

• 登录 Jenkins 管理界面（默认 http://<服务器IP>:8080）。
• 进入 Manage Jenkins → Manage Plugins，切换到 Updates 选项卡，勾选需要更新的插件，点击 Update。
• 按提示重启：可选择 Restart Now 或 Restart Later（部分插件支持“安装而不重启”）。

二 通过 Jenkins CLI 批量更新

• 准备 CLI：下载 jenkins-cli.jar，并确保与目标实例网络可达（URL 形如 http://your-jenkins-url/）。
• 单个插件更新：
  • 命令：java -jar jenkins-cli.jar -s http://your-jenkins-url/ update-plugin <plugin-name>
  • 如需安装后立刻重启，可加 -restart 参数（或在界面选择重启策略）。
• 批量更新（两步法，更稳妥）：
  • 列出可更新插件：java -jar jenkins-cli.jar -s http://your-jenkins-url/ list-plugins | grep -E '\([0-9]+(\.[0-9]+)+\)'
  • 逐条更新或编写脚本循环调用 update-plugin。
• 说明：CLI 方式适合自动化与批量场景；更新完成后按提示重启 Jenkins。

三 启用自动下载与安装更新

• 路径：Manage Jenkins → Manage Plugins → Advanced。
• 勾选 Automatically download and install updates when available，并设置重启策略（如 Restart if necessary）。
• 风险提示：自动更新可能在更新过程中触发 Jenkins 重启，存在中断正在运行构建的可能，建议在 非生产时段 或维护窗口开启。

四 离线环境与手动更新

• 离线下载：在 Jenkins 插件官网 下载插件的 .hpi/.jpi 文件。
• 上传安装：进入 Manage Plugins → Advanced → Upload Plugin，选择文件上传并安装，按提示重启。
• 手动替换（不推荐，除非必要）：将 .hpi/.jpi 文件复制到 /var/lib/jenkins/plugins/，然后执行 sudo systemctl restart jenkins 使插件生效。

五 更新最佳实践与网络优化

• 备份与回滚：更新前备份 Jenkins 配置（如 config.xml 或全量备份 JENKINS_HOME），更新失败可快速恢复。
• 兼容性与验证：优先更新影响核心能力的插件（如 Git、Maven、Docker 相关），并在测试环境验证；关注插件与当前 Jenkins 版本 的兼容性说明。
• 维护窗口与重启策略：选择 低峰时段 执行，必要时使用 Restart Later 分阶段完成，减少业务影响。
• 清理与瘦身：定期卸载 长期未使用 的插件，降低启动时间与内存占用。
• 国内网络加速：在 Manage Plugins → Advanced 将 Update Site 切换为国内镜像（如 清华大学镜像：http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json），提升下载速度与稳定性。