在企业级的持续集成体系里Jenkins 已经成为不可或缺的“指挥中心”。只是 因为业务规模的扩大和技术栈的迭代，旧版 Jenkins 常常会出现插件兼容性差、界面卡顿、构建速度慢等尴尬局面。一次恰到好处的升级，不仅能解决这些痛点，还能为团队注入新的活力，让 CI 流水线跑得更稳、更快。下面 我把在 CentOS 环境下升级 Jenkins 的全过程娓娓道来既有技术细节，也不乏一些“人情味”的提醒，太水了。。

升级前的准备与评估

• 明确当前部署形态：是通过 RPM 包安装的 jenkins还是手动放置的 WAR 包？两者在目录结构、服务管理方式上都有所不同。
• 完整备份：至少备份 $JENKINS_HOME 最好再拷贝一份 /etc/sysconfig/jenkins 与二进制文件所在目录，以防万一。
• Java 版本检查：自 Jenkins 2.357 起最低要求 Java 11；而最新 LTS甚至推荐 Java 17。使用 java -version 确认当前 JDK 是否满足目标版本需求。
• 插件兼容性评估：跨大版本升级时一些老旧插件可能失去兼容性。建议先在测试环境跑一遍关键插件的升级路径，或在正式升级前把核心插件提前更新到最新兼容版。
• 变更窗口与回滚预案：挑选业务低谷期， 并记录下旧版 RPM 包名或 WAR 包哈希值，以便快速回滚。

备份示例脚本

# 创建时间戳
TS=$
# 备份 JENKINS_HOME
tar czf /backup/jenkins_home_$TS.tar.gz /var/lib/jenkins
# 备份配置文件
cp /etc/sysconfig/jenkins /backup/jenkins_sysconfig_$TS.bak
# 如为 RPM 安装， 可额外备份二进制
cp $ /backup/jenkins_bin_$TS.bak
echo "备份完成"

Java 与运行环境检查

• 确认运行时 Java：# java -version
• RPM 场景：检查 /etc/sysconfig/jenkins 中的 JENKINS_JAVA_CMD/JAVA_HOME 是否指向新 JDK；若使用 alternatives，请确保软链顺序正确。
• TOMCAT 场景：TOMCAT 启动脚本里要显式声明 $JAVA_HOME/$JRE_HOME否则仍会默用系统自带的 Java 8。
• 代理节点同步：CICD 的每一个构建节点都要保持相同或兼容的 Java 环境，否则会出现 “ClassNotFoundException” 或 “UnsupportedClassVersionError”。

选择合适的升级路径 & 关键步骤

① RPM 包方式

1. # 查看可用版本：

   # yum list jenkins --showduplicates | sort -r

2. # 施行升级：

   # sudo yum clean all
   # sudo yum upgrade jenkins   # 若想锁定特定版本， 可使用: sudo yum install jenkins-2.387.1-1.el7.noarch.rpm
   # sudo systemctl restart jenkins
   # sudo systemctl status jenkins   # 确认服务已正常启动
           

3. # 验证版本：

   在浏览器打开 http://:8080 ，登录后页面底部会显示新版本号。

② 手动替换 WAR 包

# systemctl stop jenkins   # 若是以 java -jar 方式启动， 则 kill 对应进程
# cp /usr/lib/jenkins/jenkins.war /usr/lib/jenkins/jenkins.war.bak_$

# wget -O /tmp/jenkins.war https://updates.jenkins.io/download/war/latest/jenkins.war
# sha256sum /tmp/jenkins.war   # 与官方提供的 SHA256 对比确保完整性

# mv /tmp/jenkins.war /usr/lib/jenkins/
# systemctl start jenkins   # 或者直接: java -jar /usr/lib/jenkins/jenkins.war &
        

③ 常见目录差异对照表

升级后的验证与细致调优

说到底。 A) 登录页面底部确认新版号是否已经刷出来；如果仍显示旧版，很可能是缓存未刷新或旧服务仍在运行。 B) 在「Manage Jenkins → System Information」中检查： - Java Runtime Version 是否为期望的 11 或 17； - OS、 CPU、内存等硬件信息是否被正确识别；. " C) 插件健康度：打开「Manage Plugins」，查看是否有红色警告或者「Needs Restart」标记。如果核心插件出现不兼容，请先降级对应插件或等待社区补丁发布。 D) 随机抽取几条关键流水线进行全链路构建：包括源码检出、 编译打包、单元测试以及部署到测试环境。确保所有节点都能成功连接并施行命令。 E) 系统监控：使用 journalctl -u jenkins -f 实时观察日志；若出现大量 GC 暂停或 OOM，请考虑调高 JVM 参数。 E) 性能基准对比：可以用简单脚本记录「构建排队时间」和「整体耗时」两项指标， 与升级前做横向比较，一眼看出提升幅度。

E) 平安加固：新版 Jenkins 通常会默认开启 CSRF 防护和平安审计日志。务必检查 「Configure Global Security」 中是否已开启「Prevent Cross Site Request Forgery exploits」。 
E) 文档同步：把新的系统信息写入团队 wiki， 让每位开发者都知道当前所依赖的平台版本，这样以后再遇到问题可以快速定位根源。
E) 回滚演练：即使已经成功上线， 也要在非生产环境演练一次回滚流程，以免真正遇到灾难时手忙脚乱。
E) 持续学习：关注 Jenkins 官方博客、 GitHub Release Notes，以及国内外社区论坛，及时捕获下一次重要更新的信息。