Debian下Jenkins如何升级

在 Debian 系统下升级 Jenkins 通常有 两种常用方式：通过官方 APT 源升级（推荐），或手动下载 WAR 包升级。下面按安全性和规范程度给你说明。

一、通过 APT 源升级（推荐）

1. 备份（非常重要）

sudo systemctl stop jenkins
sudo cp -r /var/lib/jenkins /var/lib/jenkins-backup-$(date +%F)
sudo cp /etc/default/jenkins /etc/default/jenkins-backup

2. 确认 Jenkins APT 源已配置

查看源文件：

cat /etc/apt/sources.list.d/jenkins.list

通常内容类似：

deb https://pkg.jenkins.io/debian-stable binary/

如果没有，可重新添加：

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

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

3. 更新并升级

sudo apt update
sudo apt upgrade jenkins

4. 重启 Jenkins

sudo systemctl restart jenkins
sudo systemctl status jenkins

二、手动升级 WAR 包（适合离线环境）

1. 下载新版本 WAR

从官网下载：

wget https://get.jenkins.io/war-stable/latest/jenkins.war -O /tmp/jenkins.war

2. 替换原 WAR 文件

Debian 默认路径：

/usr/share/jenkins/jenkins.war

替换：

sudo systemctl stop jenkins
sudo cp /usr/share/jenkins/jenkins.war /usr/share/jenkins/jenkins.war.bak
sudo cp /tmp/jenkins.war /usr/share/jenkins/jenkins.war
sudo systemctl start jenkins

三、升级后注意事项

1. Java 版本

   • Jenkins 2.4xx 通常需要 Java 11 或 Java 17
   • 检查：

     java -version
     

2. 插件兼容性

   • 登录 Jenkins → Manage Jenkins → Manage Plugins
   • 升级不兼容插件

3. 查看日志

   sudo journalctl -u jenkins -f
   

四、常见错误

• ❌ apt upgrade 没反应
  → 确认源是否为 debian-stable
• ❌ 启动失败
  → 多半是 Java 版本不对

如果你愿意，可以告诉我：

• Debian 版本（如 11 / 12）
• 当前 Jenkins 版本
• 是否使用 Docker

我可以给你更精确的升级命令。