ubuntu jenkins怎么迁移

下面给你一份Ubuntu 上 Jenkins 迁移的实用方案，适用于同版本或跨版本、同机或跨机迁移。

一、迁移前准备

1. 查看 Jenkins 安装方式

dpkg -l | grep jenkins
which jenkins

常见情况：

• 系统包安装（/var/lib/jenkins）
• Docker 安装（volume 或 bind mount）

2. 停止 Jenkins

sudo systemctl stop jenkins

二、核心迁移内容（最重要）

Jenkins 的“灵魂”都在 JENKINS_HOME 里。

默认路径

/var/lib/jenkins

包含：

• jobs/（任务配置）
• users/（用户）
• credentials.xml（凭据）
• config.xml（全局配置）
• plugins/（插件）
• secrets/（密钥）

三、标准迁移步骤（推荐）

方式一：整目录拷贝（最稳妥）

1. 打包 Jenkins Home

sudo tar -czvf jenkins-home.tar.gz /var/lib/jenkins

2. 拷贝到新服务器

scp jenkins-home.tar.gz user@new-server:/tmp/

3. 新服务器操作

sudo systemctl stop jenkins
sudo rm -rf /var/lib/jenkins
sudo tar -xzvf /tmp/jenkins-home.tar.gz -C /
sudo chown -R jenkins:jenkins /var/lib/jenkins
sudo systemctl start jenkins

四、插件迁移（关键）

方式 A：直接拷贝（推荐）

/var/lib/jenkins/plugins

✅ 包含 .jpi 和 .hpi

方式 B：离线安装（版本不兼容时）

1. 旧机：

ls /var/lib/jenkins/plugins

2. 新机 → Jenkins → Manage Plugins → Advanced → Upload

五、跨大版本迁移注意事项

⚠ 常见坑

• Jenkins 2.3xx → 2.4xx
• Java 8 → Java 11/17

建议顺序

1. 先升级旧 Jenkins
2. 再迁移
3. 新机使用 相同或更高 Java 版本

java -version

六、Docker 版 Jenkins 迁移

查看挂载

docker inspect jenkins | grep Mounts -A 20

迁移 volume

docker run --rm -v jenkins_home:/data -v $(pwd):/backup busybox \
tar czf /backup/jenkins.tar.gz /data

七、迁移后检查清单 ✅

• [ ] 能登录
• [ ] 插件无报错
• [ ] 凭据可用
• [ ] Job 能构建
• [ ] 系统配置正常

八、可选：只迁移 Job（轻量）

/var/lib/jenkins/jobs

导入方式：

• 管理界面 → New Item → Copy from
• 或直接拷贝目录

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

• ✅ Ubuntu 版本
• ✅ Jenkins 安装方式（apt / docker）
• ✅ 是否换服务器 / 换版本

我可以给你精确到命令的迁移方案。