Jenkins怎么升级

Jenkins 升级通常分为 Jenkins 主程序升级 和 插件升级 两部分。下面按常见场景给你一套稳妥、可回滚的升级流程。

一、升级前准备（非常重要）

1. 备份 Jenkins

一定要先备份！

# Jenkins 主目录（默认）
/var/lib/jenkins

建议备份：

• config.xml
• jobs/
• users/
• plugins/
• secrets/

示例：

cp -r /var/lib/jenkins /var/lib/jenkins_backup_$(date +%F)

2. 查看当前版本

Jenkins 页面：

Manage Jenkins → System Information → Jenkins Version

或服务器：

java -jar /usr/share/jenkins/jenkins.war --version

二、升级 Jenkins 主程序

✅ 方式一：Linux（最常见，war 包升级）

1. 下载新版本

官方地址：

https://www.jenkins.io/download/

或清华镜像（国内快）：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/war-stable/

示例：

cd /usr/share/jenkins
mv jenkins.war jenkins.war.bak
wget https://mirrors.tuna.tsinghua.edu.cn/jenkins/war-stable/2.401.3/jenkins.war

2. 重启 Jenkins

systemctl restart jenkins
# 或
service jenkins restart

3. 验证

访问 Jenkins 页面，确认版本号。

✅ 方式二：YUM / RPM 升级

yum clean all
yum makecache
yum update jenkins
systemctl restart jenkins

如果是稳定版：

yum install jenkins --enablerepo=jenkins-stable

✅ 方式三：Docker 升级

1. 拉取新镜像

docker pull jenkins/jenkins:lts

2. 停止并删除旧容器

docker stop jenkins
docker rm jenkins

3. 重新启动（挂载数据卷）

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

✅ 只要挂载了 jenkins_home，升级非常安全

三、升级 Jenkins 插件（强烈建议）

Jenkins 升级后，插件必须同步升级。

方法一：Web UI 升级（推荐）

Manage Jenkins → Manage Plugins → Available

• 勾选 “Select all”
• 点击 Download now and install after restart

方法二：离线升级（内网）

1. 在外网机器下载 .hpi
2. 上传到：

Manage Jenkins → Manage Plugins → Advanced → Upload Plugin

四、升级后检查清单 ✅

• Jenkins 能正常登录
• Pipeline 能正常跑
• Agent 能正常连接
• 插件无大面积报错
• 系统日志无严重异常

五、常见问题

❌ 插件不兼容

解决：

• 升级插件
• 或回退 Jenkins 版本

❌ 启动失败

查看日志：

journalctl -u jenkins -f
# 或
/var/log/jenkins/jenkins.log

六、升级建议（最佳实践）

✅ 小版本升级（如 2.3xx → 2.4xx）
✅ 生产环境 先在测试环境升级
✅ 使用 LTS 版本
✅ Docker 部署最省心

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

• 操作系统（CentOS / Ubuntu / Docker）
• 当前 Jenkins 版本
• 是否生产环境

我可以给你 精确到命令的升级方案 ✅