如何迁移jenkins至另一台服务器

前言

公司旧的服务器快到期了，需要将部署在其上的jenkins整体迁移到另一台服务器，两台都是aws ec2服务器。

文章主要提供给大家一种迁移思路，并不一定是最优解，仅供参考，大家根据实际情况自行选用和修改，举一反三。

部署文件

我的jenkins是采用docker compose方式部署的，docker-compose.yaml内容如下

networks:
jenkins:
name: jenkins
driver: bridge

services:
jenkins:
image: jenkins/jenkins:2.504.3
user: root
container_name: jenkins
privileged: true
restart: always
networks:
- jenkins
ports:
- "8080:8080"
- "50000:50000"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /usr/bin/docker:/usr/bin/docker
- /home/ec2-user/jenkins_compose/jenkins_configuration:/var/jenkins_home
environment:
- PATH=/opt/java/openjdk/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
- LANG=C.UTF-8
- JENKINS_HOME=/var/jenkins_home
- JENKINS_SLAVE_AGENT_PORT=50000
- REF=/usr/share/jenkins/ref
- JENKINS_UC=https://updates.jenkins.io
- JENKINS_UC_EXPERIMENTAL=https://updates.jenkins.io/experimental
- JENKINS_INCREMENTALS_REPO_MIRROR=https://repo.jenkins-ci.org/incrementals
- COPY_REFERENCE_FILE_LOG=/var/jenkins_home/copy_reference_file.log
- JAVA_HOME=/opt/java/openjdk
command: ["/usr/bin/tini", "--", "/usr/local/bin/jenkins.sh"]

迁移思想

1. 停止jenkin容器，以保证数据无更新
2. 将容器挂载的卷打包成tar包，传到oss，比如aws s3或者其他的云服务，根据自己采用的云服务厂商来选择
3. 在另一台服务器上拉取tar包，解压缩后
4. 使用docker compose启动新容器

具体命令

具体细节，比如文件目录，需更具自己实际情况做修改

# 在旧的服务器上# 在旧服务器上停止 GitLab 容器（防止数据变更）
docker-compose down# 打包Jenkins数据目录‌（保留权限和软链接）
tar -czvf jenkins_backup.tar.gz -C /home/ec2-user/jenkins_compose/jenkins_configuration .# 上传到S3‌（需提前配置AWS CLI权限）
aws s3 cp jenkins_backup.tar.gz s3://your-bucket-name/jenkins_backup.tar.gz#在新的服务器上#从S3下载备份
aws s3 cp s3://your-bucket-name/jenkins_backup.tar.gz .# 为了方便，目录结构可以和之前一样
mkdir -p /home/ec2-user/jenkins_compose/jenkins_configuration# 解压
tar -xzvf jenkins_backup.tar.gz -C /home/ec2-user/jenkins_compose/jenkins_configuration# 启动容器
docker compose up -d

安装完成之后的操作

更改jenkins url

安装好之后，通过浏览器进入新jenkins web ui，更改jenkins url为新的服务器地址

 

删除workspace下面的仓库

 因为在新的服务器上构建老仓库，可能会报git拉取问题，如图

进入容器的/var/jenkins_home/workspace目录，因为我的容器卷挂载的是 /home/ec2-user/jenkins_compose/jenkins_configuration:var/jenkins_home/workspace，所以我直接在宿主机上进入对应目录，删除下面的所有仓库（无需担心，因为数据是存在git仓库的，如gitlab或者github什么的，所以删去之后，再构建，jenkins会重新去远程仓库拉取新代码）

在workspace目录下执行下面的删除操作！！！ 

在workspace目录下执行下面的删除操作 ！！！

在workspace目录下执行下面的删除操作！！！ 

# 删除当前目录下所有内容（含隐藏文件/目录）
sudo find . -mindepth 1 -delete 2>/dev/null

再次执行构建操作，构建成功