Ubuntu上Jenkins如何更新

Ubuntu 上 Jenkins 的更新指南

一 更新前准备

• 备份关键数据与配置：建议完整备份 JENKINS_HOME（默认 /var/lib/jenkins） 与关键配置目录（如 /etc/default/jenkins），以便回滚。示例：sudo cp -r /var/lib/jenkins /var/lib/jenkins_backup_$(date +%F)。
• 检查并准备 Java：确认当前 Java 版本满足目标 Jenkins 的要求。自 Jenkins 2.346.3 起要求 JDK 11+；许多新版本（如 2.414+）建议使用 JDK 11/17。命令：java -version、sudo update-alternatives --config java。如需安装 OpenJDK 11：sudo apt update && sudo apt install openjdk-11-jdk。
• 确认安装方式：常见为 APT 包管理安装 与 WAR 包运行（含 Docker）。不同方式升级步骤不同，下文分别说明。

二 通过 APT 升级（推荐）

• 更新软件索引：sudo apt update。
• 执行升级：sudo apt upgrade jenkins（或 sudo apt-get upgrade jenkins）。
• 如需指定版本：apt-cache madison jenkins 查看可用版本，然后 sudo apt-get install jenkins=<version>。
• 重启服务：sudo systemctl restart jenkins。
• 验证：sudo systemctl status jenkins、java -version、jenkins --version（若命令存在）。

三 使用 WAR 包或 Docker 运行时的升级

• 定位 WAR 文件路径：在 Manage Jenkins → System Information 查看 executable-war 的实际路径；常见路径为 /usr/share/jenkins/jenkins.war。
• 备份与替换：
  • 备份：sudo cp /usr/share/jenkins/jenkins.war /usr/share/jenkins/jenkins.war.bak_$(date +%F)
  • 替换：sudo cp /path/to/new/jenkins.war /usr/share/jenkins/jenkins.war
• 重启：
  • 系统服务：sudo systemctl restart jenkins
  • Docker：docker restart <jenkins_container>
• 回滚：将备份 WAR 拷回原路径并重启。

四 升级后验证与常见问题

• 版本与运行状态：sudo systemctl status jenkins、java -version、jenkins --version。
• 日志排查：查看 /var/log/jenkins/jenkins.log 是否有启动报错或插件兼容性问题。
• Java 不兼容：若启动失败或频繁报错，检查 JAVA_HOME 与默认 Java 版本（sudo update-alternatives --config java），确保与目标 Jenkins 版本匹配。
• 插件与兼容性：升级后优先升级关键插件，个别插件可能需等待适配新版本。