如何升级Debian版Jenkins

debian

小樊

2026-09-23 07:55:18

栏目: 智能运维

在 Debian / Ubuntu 系统上升级 Jenkins，通常有两种常见方式：使用官方 apt 仓库升级（推荐） 和 手动替换 WAR 包升级。下面分别说明。

一、使用官方 apt 仓库升级（推荐）

1. 备份（非常重要）

sudo systemctl stop jenkins
sudo cp -r /var/lib/jenkins /var/lib/jenkins.backup
sudo cp /etc/default/jenkins /etc/default/jenkins.backup

2. 导入 Jenkins GPG Key（如未添加）

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

3. 添加 Jenkins apt 源（如未添加）

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

4. 更新并升级

sudo apt update
sudo apt upgrade jenkins

5. 启动 Jenkins

sudo systemctl start jenkins
sudo systemctl status jenkins

访问：

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

在 Manage Jenkins → About 中确认版本。

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

1. 下载新版本 WAR

wget https://updates.jenkins.io/download/war/latest/jenkins.war

2. 替换原 WAR 文件

Debian 默认路径通常为：

sudo cp /usr/share/jenkins/jenkins.war /usr/share/jenkins/jenkins.war.bak
sudo cp jenkins.war /usr/share/jenkins/jenkins.war

3. 重启 Jenkins

sudo systemctl restart jenkins

三、升级注意事项

Java 版本要求：
- Jenkins 2.4xx 通常需要 Java 11 或 17
- 检查：
```
java -version
```
插件兼容性：
- 升级后建议进入：
```
Manage Jenkins → Manage Plugins → Available
```
  更新插件
LTS 版本建议：
- 生产环境优先使用 LTS（长期支持）版本

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

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

我可以给出更精确的升级方案。