Linux下Jenkins如何更新

Linux下Jenkins更新指南

一 升级前准备

• 备份关键数据：至少备份 $JENKINS_HOME（默认：/var/lib/jenkins） 与 JENKINS_HOME/plugins，必要时连同 /usr/lib/jenkins/jenkins.war 一并备份；升级后核对版本并记录变更。
• 检查与准备 Java：确认已安装 Java 11 或更高版本，执行 java -version；若不满足请先升级 Java。
• 选择版本策略：优先选择 LTS 稳定版，避免 Weekly 版本在生产环境使用。
• 确认安装方式：常见为系统包（如 RPM/DEB）和 WAR 包 两种，后续步骤按不同方式分别说明。

二 不同安装方式的升级步骤

• RPM/DEB 包管理（CentOS/RHEL、Debian/Ubuntu 等）
  1. 备份数据与配置；2) 更新 Java；3) 执行升级命令（如 yum/dnf upgrade jenkins 或 apt-get upgrade jenkins）；4) 重启服务（systemctl restart jenkins）；5) 登录 Web 界面确认版本。
• WAR 包部署（直接运行 jenkins.war）
  1. 查找并确认 jenkins.war 路径（常见为 /usr/lib/jenkins/jenkins.war）；2) 停止服务（systemctl stop jenkins）；3) 备份并替换 WAR（如 mv jenkins.war jenkins.war.bak && wget -O /usr/lib/jenkins/jenkins.war <镜像或官网URL>）；4) 启动服务（systemctl start jenkins）；5) 登录 Web 界面确认版本。
• Tomcat 部署
  1. 停止 Tomcat；2) 备份 webapps/jenkins 与 $JENKINS_HOME；3) 部署新版本 jenkins.war 到 webapps；4) 启动 Tomcat；5) 登录确认版本。

三 升级后的验证与回滚

• 验证：登录 Manage Jenkins → System Information 或页面底部查看 Jenkins 版本号，确认插件可正常加载、任务可构建。
• 回滚：若异常，立即停止服务，恢复 jenkins.war 与 $JENKINS_HOME（WAR 方式），或执行包管理回滚（如 yum/dnf downgrade jenkins / apt-get install jenkins=<旧版本>），再启动服务。

四 常见问题与注意事项

• Java 版本不兼容：升级后若启动失败或频繁报错，检查 Java 版本是否满足新版本要求，必要时升级至 Java 11+。
• 端口与权限：默认端口 8080；如需使用 80/443 等 1024 以下端口，需以 root 运行或完成相应权限/防火墙配置。
• 内存与 JVM 参数：可在 /etc/sysconfig/jenkins（RPM/DEB）中调整 JENKINS_JAVA_OPTIONS，例如 -Xms256m -Xmx512m，按机器资源合理设置。
• 日志排查：升级异常时优先查看 /var/log/jenkins/jenkins.log 定位问题。