Debian上Jenkins的更新与升级

Debian 上 Jenkins 的更新与升级指南

一 升级前准备

• 备份关键数据与配置：建议完整备份 /var/lib/jenkins（JENKINS_HOME）以及当前 WAR 包，以便回滚。示例：sudo cp -a /var/lib/jenkins /var/lib/jenkins_backup；如为 WAR 部署，先备份如 /usr/share/jenkins/jenkins.war。
• 检查 Java 版本：确认已安装 Java 11 或更高版本（Jenkins 2.346.3+ 要求 Java 11+）。示例：java -version。
• 选择版本线：优先选择 Debian stable 仓库以获得稳定与安全修复；如需尝鲜再考虑测试/不稳定通道。
• 维护窗口与回滚预案：选择低峰时段，准备好回滚包与备份，确保升级失败可快速恢复。

二 通过 APT 的标准升级（推荐）

• 更新软件源索引：sudo apt update。
• 执行升级：
  • 常规：sudo apt install jenkins（已安装会自动升级到仓库最新版本）。
  • 仅升级：sudo apt install --only-upgrade jenkins。
• 重启服务：sudo systemctl restart jenkins。
• 验证结果：
  • 服务状态：sudo systemctl status jenkins。
  • Web 界面：访问 http://<服务器IP>:8080，在“系统信息”中确认 Jenkins 版本 与运行状态。

三 使用官方 APT 源的正确方式

• 导入 GPG 密钥（推荐放入密钥环）：
  • sudo wget -O /usr/share/keyrings/jenkins-keyring.asc https://pkg.jenkins.io/debian/jenkins.io-2023.key
• 写入源列表（使用已签名的源）：
  • echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /devref
• 更新并升级：sudo apt update && sudo apt install jenkins。

四 故障排查与回滚

• 查看日志定位问题：sudo journalctl -u jenkins 或查看 /var/log/jenkins/jenkins.log。
• 快速回滚（WAR 部署场景）：
  • 停止服务：sudo systemctl stop jenkins
  • 恢复 WAR：sudo cp /usr/share/jenkins/jenkins.war.bak /usr/share/jenkins/jenkins.war
  • 启动服务：sudo systemctl start jenkins
• 回滚（APT 场景）：
  • 降级到上一个版本：sudo apt install jenkins=<上一版本号>
  • 或从备份恢复 /var/lib/jenkins 目录后重启。

五 升级后的维护建议

• 升级插件：进入 Manage Jenkins → Plugins 执行批量更新，确保与 新版本 Jenkins 兼容。
• 持续验证：检查关键任务、代理连通性与安全设置；如异常，优先回滚对应插件或版本。
• 关于“自动升级”：Jenkins 的 WAR 包自动升级 仅适用于 WAR 部署；若通过 APT 包 安装，应使用 APT 完成升级，不建议混用两种升级方式。