jenkins在centos上如何更新插件

在 CentOS 上更新 Jenkins 插件

一 通过 Web 界面更新

• 登录 Jenkins 管理界面（http://服务器IP:8080）。
• 进入 Manage Jenkins → Manage Plugins → Installed，切到 Updates 标签。
• 勾选需要更新的插件，点击 Download now and install without restart（或“Install without restart”）。
• 如界面提示需要重启，先执行“Go ahead and restart Jenkins”，或稍后在 Manage Jenkins 首页点击 Restart Jenkins。
• 验证：返回 Installed 查看插件版本是否已升级。

二 命令行批量更新与安全建议

• 进入 Manage Jenkins → Manage Plugins → Advanced，勾选 Enable auto-update（如有），保存；随后在 Updates 页执行更新。
• 使用 Jenkins CLI（需先在“全局安全配置”开启安全矩阵并生成 API Token）：
  • 登录获取 CLI：java -jar jenkins-cli.jar -s http://服务器IP:8080 -auth 用户名:API_Token login
  • 查看可更新：java -jar jenkins-cli.jar -s http://服务器IP:8080 -auth 用户名:API_Token list-plugins | grep -E ‘([0-9]+.[0-9]+)’
  • 批量更新：java -jar jenkins-cli.jar -s http://服务器IP:8080 -auth 用户名:API_Token safe-restart
• 建议：先备份 $JENKINS_HOME（如 /var/lib/jenkins），并在维护窗口操作；更新后检查系统与任务是否正常。

三 离线或内网环境的更新

• 在有网环境下载插件及其依赖的 .hpi/.jpi 文件（可从插件站点或可信镜像获取），然后在 Manage Plugins → Advanced → Upload Plugin 逐个上传并重启。
• 内网集中代理方案：在 Nexus 建立 raw 代理仓/本地仓/虚拟仓，修改 $JENKINS_HOME/hudson.model.UpdateCenter.xml 的更新站点为内网地址；如 Jenkins 启动时需检测外网连通性，可用 Nginx 将 updates.jenkins.io 等域名跳转至内网地址，并在 /etc/hosts 做必要解析，以避免首次检测失败。

四 提升下载速度并避免更新失败

• 切换国内插件源（任选其一）：
  • 在 Manage Plugins → Advanced 将 Update Site 改为：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 或编辑 $JENKINS_HOME/updates/default.json，将下载地址替换为：https://mirrors.tuna.tsinghua.edu.cn/jenkins，并把 connectionCheckUrl 从 http://www.google.com 改为 https://www.baidu.com
  • 如目录或文件不存在，检查 $JENKINS_HOME 路径（常见为 /var/lib/jenkins），或查看 hudson.model.UpdateCenter.xml 中的 url 配置。
• 修改后重启 Jenkins 生效：systemctl restart jenkins。

五 常见问题与排查

• 更新后页面报错或功能异常：回滚到旧版本（在 Installed 页卸载更新或安装指定版本），或暂时禁用问题插件；检查系统日志与插件文档的兼容性说明。
• 更新卡住或失败：检查 /var/log/jenkins/jenkins.log，确认磁盘空间、网络连通性、代理设置与权限（Jenkins 用户对 $JENKINS_HOME 可读写）。
• 某些插件需要重启才生效：按界面提示重启，或使用 CLI 的 safe-restart 完成滚动重启。