debian jenkins如何升级

debian

小樊

2026-09-02 01:59:46

栏目: 智能运维

在 Debian 系统上升级 Jenkins 通常有两种常见场景：

通过 apt 仓库升级（推荐，最规范）
手动下载 war 包升级（适合特殊版本或离线环境）

下面分别说明。

一、通过 apt 仓库升级（推荐）

1. 备份（非常重要）

# 备份 Jenkins 主目录（默认 /var/lib/jenkins）
sudo systemctl stop jenkins
sudo tar czf jenkins-backup-$(date +%F).tar.gz /var/lib/jenkins

# 可选：备份配置文件
sudo cp /etc/default/jenkins /etc/default/jenkins.bak

2. 更新 apt 源

Jenkins 官方仓库：

sudo apt update

如果未配置官方源，先添加：

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

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

sudo apt update

3. 升级 Jenkins

sudo apt install jenkins

或：

sudo apt upgrade jenkins

4. 重启并验证

sudo systemctl restart jenkins
sudo systemctl status jenkins

访问页面 → Manage Jenkins → About 查看版本。

二、手动升级 war 包（适合离线/特殊需求）

1. 停止服务

sudo systemctl stop jenkins

2. 下载新版本 war

wget https://updates.jenkins.io/download/war/2.xxx/jenkins.war

3. 替换 war 文件

Debian 默认路径：

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

4. 启动

sudo systemctl start jenkins

三、升级后建议检查

Jenkins 插件是否需要升级
Java 版本是否满足新 Jenkins 要求（如 Jenkins 2.4xx 需要 Java 17+）
查看日志：

sudo journalctl -u jenkins -f

四、常见问题

Q1：升级后无法启动？

一般是 Java 版本不匹配：

java -version

Jenkins 2.4xx 通常需要 Java 17 或 21。

Q2：插件不兼容？

进入：

Manage Jenkins → Manage Plugins → Available

批量升级插件。

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

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

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