Jenkins在Debian如何升级

在 Debian / Debian 系（Ubuntu） 上升级 Jenkins，常见有三种方式，推荐 APT 方式。下面按常见场景说明。

一、使用 APT 升级（✅ 最推荐）

1. 检查当前 Jenkins 版本

jenkins --version

或

dpkg -l jenkins

2. 更新 APT 源为官方 Jenkins 源（如未配置）

Jenkins 官方仓库包含最新 LTS 版本。

# 安装密钥
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.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 > /dev/null

如果是 Ubuntu，仓库地址一致，无需单独区分。

3. 更新并升级 Jenkins

sudo apt update
sudo apt upgrade jenkins

或完整升级：

sudo apt full-upgrade jenkins

4. 重启 Jenkins

sudo systemctl restart jenkins

检查状态：

sudo systemctl status jenkins

二、查看可升级版本

apt-cache policy jenkins

示例输出：

Installed: 2.401.1
Candidate: 2.426.3

三、升级后常见检查项（⚠ 重要）

1. Java 版本是否兼容

Jenkins 新版本对 Java 有要求（如 Jenkins 2.4xx 通常要求 Java 11 或 17）。

查看 Java 版本：

java -version

如需要升级 Java：

sudo apt install openjdk-17-jdk

2. 插件升级（强烈建议）

Jenkins 升级后：

进入 Manage Jenkins → System Information
进入 Manage Jenkins → Manage Plugins
升级所有 已安装插件

⚠ 插件不升级常导致页面报错或功能异常。

四、APT 升级失败 / 锁定问题

若提示：

E: Unable to lock the administration directory

解决方法：

sudo rm /var/lib/dpkg/lock-frontend
sudo rm /var/lib/dpkg/lock
sudo dpkg --configure -a

五、手动升级（不推荐，仅特殊情况）

1. 下载 war 包

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

2. 替换旧 war

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

六、升级建议总结

✅ 推荐方式：APT + 官方仓库
✅ 升级顺序：Jenkins → Java → 插件
✅ 生产环境：先备份 /var/lib/jenkins

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

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

我可以给你一套 完全适配你环境的升级方案。