如何更新Ubuntu Jenkins

更新 Ubuntu 上的 Jenkins 可以分为 更新 Jenkins 本身 和 更新插件/系统环境 两部分。下面按最常见、最安全的方式一步一步说明。

一、更新 Jenkins（APT 方式，官方推荐）

如果你的 Jenkins 是通过 官方 APT 仓库 安装的（大多数情况都是），按下面步骤操作。

1️⃣ 备份（强烈建议）

sudo systemctl stop jenkins
sudo cp -r /var/lib/jenkins /var/lib/jenkins.bak
sudo systemctl start jenkins

如果是生产环境，一定要先备份。

2️⃣ 更新系统软件包索引

sudo apt update

3️⃣ 升级 Jenkins

sudo apt upgrade jenkins

如果有提示，选择 保留当前配置文件（keep current version）。

4️⃣ 重启 Jenkins

sudo systemctl restart jenkins

5️⃣ 检查 Jenkins 状态

systemctl status jenkins

在浏览器访问：

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

进入 Manage Jenkins，确认版本已更新。

二、如果 Jenkins 版本没有变化（常见）

说明你还用的是 Ubuntu 默认仓库里的旧版本。

✅ 切换到 Jenkins 官方仓库（推荐）

1️⃣ 导入 Jenkins GPG 密钥

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

2️⃣ 添加 Jenkins 官方仓库

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

3️⃣ 更新并升级

sudo apt update
sudo apt upgrade jenkins

三、更新 Jenkins 插件（重要）

Jenkins 升级后，插件也必须升级，否则可能报错。

方法 1：Web 界面更新（推荐）

登录 Jenkins
Manage Jenkins → Manage Plugins
Available 或 Installed
点击 Update

方法 2：强制升级所有插件（CLI）

java -jar jenkins-cli.jar -s http://localhost:8080/ install-plugin <插件名>

或使用：

Manage Jenkins → Manage Plugins → Advanced → Check now

四、更新 Java（Jenkins 依赖）

Jenkins 新版本要求 Java 11 或 Java 17。

查看当前 Java 版本

java -version

安装 Java 17（推荐）

sudo apt install openjdk-17-jdk

修改 Jenkins Java 路径

sudo systemctl edit jenkins

添加：

[Service]
Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64"

然后重启：

sudo systemctl restart jenkins

五、升级后常见问题

❌ Jenkins 无法启动

journalctl -u jenkins -xe

❌ 插件报红

升级插件
或删除旧插件：

rm -rf /var/lib/jenkins/plugins/<插件名>*

六、快速总结（常用命令）

sudo apt update
sudo apt upgrade jenkins
sudo systemctl restart jenkins

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

Ubuntu 版本（lsb_release -a）
Jenkins 当前版本
是否生产环境

我可以给你一份 完全针对你环境的更新方案 ✅