debian如何升级jenkins

debian

小樊

2026-10-07 23:32:20

栏目: 智能运维

在 Debian 系统上升级 Jenkins 通常有以下几种方式，取决于你最初是如何安装的（通过官方仓库、deb 包，还是 Docker）。下面以**最常见的“通过 Jenkins 官方 APT 仓库安装”**为例说明。

一、通过 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. 更新 APT 源

sudo apt update

如果你之前添加过 Jenkins 官方源，APT 会自动检测到新版本。

3. 升级 Jenkins

sudo apt install jenkins

或

sudo apt upgrade jenkins

4. 重启 Jenkins

sudo systemctl restart jenkins

5. 验证版本

jenkins --version

或访问：http://<ip>:8080/about

二、手动下载 deb 包升级

适用于不能直接使用 APT 的情况。

wget https://pkg.jenkins.io/debian-stable/binary/jenkins_<版本号>_all.deb
sudo dpkg -i jenkins_<版本号>_all.deb
sudo systemctl restart jenkins

三、Docker 方式升级

如果你是用 Docker 运行的：

docker pull jenkins/jenkins:lts
docker stop jenkins
docker rm jenkins
docker run -d \
  --name jenkins \
  -p 8080:8080 -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

⚠️ 确保 jenkins_home 是持久化卷。

四、升级后注意事项

插件兼容性
- 登录 Jenkins
- 进入：Manage Jenkins → Manage Plugins
- 升级不兼容插件
Java 版本
- Jenkins 2.4xx 需要 Java 11 或 17
- 检查：
```
java -version
```
回滚方案 若升级失败：
```
sudo apt install jenkins=<旧版本>
```

五、常见错误

端口被占用：检查 8080
权限问题：/var/lib/jenkins 属主应为 jenkins
插件崩溃：先禁用插件再启动

如果你能告诉我：

当前 Jenkins 版本
安装方式（apt / docker / war）
Debian 版本

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