centos jenkins更新版本步骤

CentOS 上 Jenkins 升级步骤

一 升级前准备

• 备份关键数据与配置：至少备份 JENKINS_HOME（默认 /var/lib/jenkins） 与关键配置文件（如 /etc/sysconfig/jenkins、/etc/systemd/system/jenkins.service），并确保有可用的 管理员账户与凭据。示例：sudo cp -a /var/lib/jenkins /var/lib/jenkins_backup_$(date +%F)。
• 检查当前版本与插件：在 Manage Jenkins → About 查看版本；在 Manage Plugins 检查插件更新，必要时先升级核心插件，减少升级后不兼容风险。
• 确认 Java 版本满足目标 Jenkins 的要求（常见为 JDK 11 或 JDK 17）：java -version。若不满足，先安装合适版本（如 sudo yum install java-11-openjdk-devel -y 或 sudo yum install java-17-openjdk-devel -y）。
• 选择升级方式：
  • 使用 YUM 仓库包（推荐，便于后续升级与维护）。
  • 使用 WAR 包替换（适合容器化/非标准安装或需要快速替换的场景）。

二 方式一 YUM 仓库升级（推荐）

1. 检查可用更新：sudo yum check-update jenkins。
2. 执行升级：sudo yum upgrade jenkins -y。
3. 重启服务：sudo systemctl restart jenkins。
4. 验证版本：访问 http://服务器IP:8080，在 Manage Jenkins → About 确认新版本；或执行 sudo systemctl status jenkins 查看运行状态。

三 方式二 WAR 包替换升级（手动）

1. 停止服务：sudo systemctl stop jenkins。
2. 备份旧 WAR 与目录：
   • 备份 WAR（常见路径如 /usr/share/jenkins/jenkins.war 或 /usr/lib/jenkins/jenkins.war）：sudo cp /usr/share/jenkins/jenkins.war /usr/share/jenkins/jenkins.war.bak_$(date +%F)。
   • 备份数据目录：sudo cp -a /var/lib/jenkins /var/lib/jenkins_backup_$(date +%F)。
3. 下载新 WAR（示例为稳定版仓库，实际请替换为目标版本）：
   • 稳定版仓库：wget https://pkg.jenkins.io/redhat-stable/jenkins.war -O /usr/share/jenkins/jenkins.war
   • 或镜像源：wget https://mirrors.tuna.tsinghua.edu.cn/jenkins/war/2.463/jenkins.war -O /usr/share/jenkins/jenkins.war
4. 恢复目录权限（如 WAR 运行用户为 jenkins）：sudo chown -R jenkins:jenkins /usr/share/jenkins /var/lib/jenkins。
5. 启动服务：sudo systemctl start jenkins；如需随开机自启：sudo systemctl enable jenkins。
6. 验证版本：访问 http://服务器IP:8080 确认升级成功。

四 升级后验证与回滚

• 验证要点：
  • 访问 http://服务器IP:8080，在 Manage Jenkins → About 确认版本号。
  • 查看系统日志：sudo journalctl -u jenkins -b，确认无启动报错。
  • 抽查关键任务与 插件 是否正常工作。
• 快速回滚：
  • YUM 回滚：sudo yum downgrade jenkins -y && sudo systemctl restart jenkins。
  • WAR 回滚：停止服务，将 WAR 恢复为备份（如 sudo cp /usr/share/jenkins/jenkins.war.bak_YYYY-MM-DD /usr/share/jenkins/jenkins.war），必要时恢复 JENKINS_HOME 备份，再启动服务。

五 常见问题与注意事项

• Java 版本不匹配：升级前确认目标 Jenkins 所需的 JDK 版本（如 JDK 11/17），版本过低会导致启动失败或功能受限。
• 插件兼容性：跨大版本升级时，优先升级核心插件；如存在不兼容，先查阅插件页面说明或临时降级插件。
• 国内下载镜像与连通性：若直连官方站点缓慢或失败，可使用 清华镜像 等国内源；历史上部分 “latest” 链接可能存在同步或访问问题，建议使用明确的版本号或稳定仓库。
• 切勿删除 JENKINS_HOME：升级时只替换 WAR 或执行包升级，避免误删 /var/lib/jenkins，否则会丢失任务与配置。
• 服务与端口：确认 8080 端口未被占用；如使用反向代理或 HTTPS，检查 Nginx/Apache 与证书配置是否仍然有效。