Ubuntu上如何更新Jenkins版本

Ubuntu 上更新 Jenkins 的标准做法

一 准备与兼容性检查

• 备份关键数据：建议先备份 JENKINS_HOME（默认 /var/lib/jenkins） 与配置文件，以防回滚需要。示例：sudo cp -r /var/lib/jenkins /var/lib/jenkins_backup_$(date +%F)。
• 检查当前 Java 版本：java -version。自 Jenkins 2.346.3 起要求 JDK 11+；许多新版本（如 2.414+）建议使用 JDK 11/17。如需切换版本：sudo update-alternatives --config java，或安装新版本 sudo apt install openjdk-17-jdk 后再切换。
• 确认安装方式：本指南面向通过 **APT 仓库（deb 包）**安装的 Jenkins；如使用 WAR 包、Tomcat 或 Docker，请参考文末对应小节。

二 使用 APT 升级（推荐）

• 更新软件索引：sudo apt update。
• 仅升级 Jenkins：sudo apt-get --only-upgrade install jenkins。
• 或随系统一起升级：sudo apt upgrade（会同时升级其他可升级包）。
• 重启使新版本生效：sudo systemctl restart jenkins。
• 验证版本：访问 http://服务器IP:8080，在页面底部或“Manage Jenkins”中查看版本号。

三 指定版本升级或回滚

• 查询可用版本：apt-cache madison jenkins。
• 安装指定版本（示例为 2.249.2）：sudo apt-get install -y jenkins=2.249.2。
• 回滚同理：将版本号替换为要回滚的版本即可。

四 其他安装方式的升级要点

• WAR 包部署：备份并替换 /usr/lib/jenkins/jenkins.war，然后重启服务（如 sudo systemctl restart jenkins）。
• Tomcat 部署：替换 webapps/ROOT.war 或对应应用目录的 WAR，清理工作目录后重启 Tomcat。
• 容器化部署：更新 Jenkins 镜像标签 并重启容器（如 docker pull jenkins/jenkins:lts-jdk17 后重启 Pod/容器）。

五 常见问题与排查

• Java 版本不兼容：若日志或启动脚本提示 “Found an incorrect Java version”，说明 JDK 版本过低。请安装 JDK 11+ 并通过 update-alternatives 切换默认 Java，再重启 Jenkins。
• 重启失败：查看 /var/log/jenkins/jenkins.log 定位问题（端口占用、权限、JDK 路径等）。
• 升级后页面仍提示更新：多为未重启或浏览器缓存，执行 sudo systemctl restart jenkins 并强制刷新页面。