debian jenkins如何升版本

debian

小樊

2026-09-26 06:33:15

栏目: 智能运维

在 Debian 上升级 Jenkins 主要有两种方式：通过官方 APT 仓库升级（推荐） 和 手动替换 WAR 包升级。下面给你一份清晰、可操作的步骤。

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

1. 备份（非常重要）

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

2. 导入 Jenkins 官方 GPG Key（如果还没做）

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

3. 确认 APT 源

cat /etc/apt/sources.list.d/jenkins.list

正常应为：

deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian binary/

4. 更新并升级

apt update
apt upgrade jenkins

或指定版本：

apt install jenkins=2.xxx.x

5. 启动 Jenkins

systemctl start jenkins
systemctl status jenkins

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

1. 下载新版本 WAR

从官网下载：

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

2. 替换原 WAR 包

Debian 默认路径：

/usr/share/jenkins/jenkins.war

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

三、升级后检查

访问：http://<ip>:8080
查看版本：Dashboard → Manage Jenkins
检查插件兼容性（可能需升级插件）
查看日志：

journalctl -u jenkins -f

四、常见问题

1. Java 版本不兼容

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

java -version

如版本过低：

apt install openjdk-17-jdk

并在 /etc/default/jenkins 中指定：

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

2. 升级后无法启动

回滚备份
查看 /var/log/jenkins/jenkins.log

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

当前 Debian 版本
当前 Jenkins 版本
是否使用 Docker

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