Linux Jenkins如何更新版本

Linux 上更新 Jenkins 的完整步骤

一 升级前准备

• 备份关键数据与目录：至少备份 $JENKINS_HOME（默认 /var/lib/jenkins） 与当前 jenkins.war，并确认磁盘空间充足（如 df -h /var/lib/jenkins）。示例：tar -czf /opt/jenkins_backup_$(date +%F).tar.gz /var/lib/jenkins。
• 检查当前版本与运行状态：java -version；sudo java -jar /usr/share/java/jenkins.war --version；systemctl status jenkins。
• 核对 Java 兼容性：Jenkins 2.405+ 需 Java 11+；Jenkins 2.463+ 需 Java 17 或 Java 21。若不满足，先升级 JDK 并正确设置 JAVA_HOME。
• 选择维护窗口与回滚方案：避开业务高峰，保留可回滚的 WAR 包与 $JENKINS_HOME 备份，便于快速恢复。

二 按安装方式的升级方法

• APT 系列（Debian/Ubuntu，官方仓库）
  1. 更新索引：sudo apt update
  2. 查看可用版本：apt list -a jenkins
  3. 执行升级：sudo apt install jenkins（或指定版本：sudo apt install jenkins=2.528.2）
  4. 重启与验证：sudo systemctl restart jenkins && sudo systemctl status jenkins
  5. 如未配置官方源，先导入密钥与源后升级。
• YUM/DNF 系列（CentOS/RHEL/Fedora，官方仓库）
  1. 执行升级：sudo yum upgrade jenkins（或 dnf upgrade jenkins）
  2. 重启与验证：sudo systemctl restart jenkins && sudo systemctl status jenkins
• 通用手动替换 WAR 包（适用于 WAR 部署、Tomcat、容器外运行）
  1. 停止服务：sudo systemctl stop jenkins
  2. 备份旧包：cp /usr/share/java/jenkins.war /usr/share/java/jenkins.war.bak
  3. 下载新包（稳定版镜像示例）：wget https://mirrors.tuna.tsinghua.edu.cn/jenkins/war-stable/latest/jenkins.war -P /tmp
  4. 替换并授权：cp /tmp/jenkins.war /usr/share/java/ && chown jenkins:jenkins /usr/share/java/jenkins.war
  5. 启动与验证：sudo systemctl start jenkins && systemctl status jenkins
• Tomcat 部署
  1. 停止 Tomcat：/path/to/tomcat/bin/shutdown.sh
  2. 备份 webapps 下的 jenkins 目录与 jenkins.war
  3. 将新 jenkins.war 放入 webapps，启动 Tomcat：/path/to/tomcat/bin/startup.sh
• 容器场景（Docker）
  • 推荐直接拉取新镜像重启（保持数据卷挂载不变）：docker pull jenkins/jenkins:lts-jdk17 或 jenkins/jenkins:2.528.2-jdk17；docker stop jenkins && docker rm jenkins；docker run …（原 -v $JENKINS_HOME:/var/lib/jenkins 保持不变）。

三 升级后验证与常见问题

• 版本验证：访问 http://服务器:8080，进入 系统管理 → 关于 Jenkins 查看版本号；或执行 java -jar /usr/share/java/jenkins.war --version。
• Java 不兼容处理：若启动失败或提示版本不足，安装 OpenJDK 17/21 并配置 JAVA_HOME，再重启；注意某些平台需在服务配置文件（如 /etc/default/jenkins）中显式设置 JAVA_HOME。
• 插件与兼容性：升级后优先升级关键插件；如遇插件不兼容，先回退插件或临时禁用，再逐步恢复。
• 回滚步骤：快速将 jenkins.war 恢复为备份，或将 $JENKINS_HOME 回滚到升级前快照，然后重启服务。

四 常用目录与命令速查

• 常见 WAR 位置：/usr/share/java/jenkins.war；RPM 包安装时也可能在 /usr/lib/jenkins/jenkins.war。
• 服务管理：sudo systemctl {start|stop|restart|status} jenkins。
• 版本查看：java -version；sudo java -jar /usr/share/java/jenkins.war --version。
• 备份命令示例：tar -czf /opt/jenkins_backup_$(date +%F).tar.gz /var/lib/jenkins。