怎么升级Debian的Jenkins

升级 Debian 上的 Jenkins，通常分为 升级 Jenkins 本身（war/包） 和 升级运行环境（Java） 两部分。下面给你一套最常见、最稳妥的做法，适用于 Debian / Ubuntu。

一、升级前的准备

1️⃣ 备份（非常重要）

# Jenkins 主目录（默认）
sudo cp -a /var/lib/jenkins /var/lib/jenkins.bak.$(date +%F)

# 配置文件
sudo tar czf jenkins-config-$(date +%F).tar.gz /etc/default/jenkins /etc/jenkins

2️⃣ 查看当前版本

jenkins --version
# 或
dpkg -l jenkins

二、升级 Jenkins（推荐方式：官方仓库）

✅ 使用 Jenkins 官方 APT 仓库（最规范）

1️⃣ 导入 Jenkins GPG 密钥

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

2️⃣ 添加官方仓库

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 > /dev/null

3️⃣ 更新并升级

sudo apt update
sudo apt upgrade jenkins

如果你之前用的是 老仓库（pkg.jenkins.io/debian/），建议换成 debian-stable

三、升级 Java（Jenkins 2.4xx+ 必须）

✅ Jenkins 新版本要求

Jenkins 版本	Java 要求
2.361+	Java 11
2.401+	Java 11 / 17
2.440+	推荐 Java 17

1️⃣ 查看当前 Java

java -version

2️⃣ 安装 Java 17（推荐）

sudo apt install openjdk-17-jdk

3️⃣ 切换 Java 版本

sudo update-alternatives --config java

4️⃣ 确认 Jenkins 使用的 Java

编辑：

sudo nano /etc/default/jenkins

确认或添加：

JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

四、重启 Jenkins

sudo systemctl restart jenkins
sudo systemctl status jenkins

访问：

http://<服务器IP>:8080

五、升级后检查

✅ 检查插件兼容性

进入 Manage Jenkins
点击 Manage Plugins
升级 过期插件

⚠️ 如果插件不兼容，Jenkins 可能启动失败

六、如果 Jenkins 启动失败

查看日志

journalctl -u jenkins -xe
# 或
cat /var/log/jenkins/jenkins.log

常见原因

Java 版本不对
插件太旧
权限问题

七、手动升级（仅当你用的是 war 包）

sudo systemctl stop jenkins
wget https://get.jenkins.io/war/latest/jenkins.war -O /usr/share/jenkins/jenkins.war
sudo systemctl start jenkins

八、总结（推荐流程）

✅ 最佳实践

备份 → 升级 Java → 升级 Jenkins → 重启 → 升级插件

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

Debian 版本（cat /etc/debian_version）
Jenkins 当前版本
是否生产环境

我可以给你 更精确的升级方案，甚至帮你排查升级失败问题。