Tomcat 部署 Jenkins → Docker Jenkins 完整迁移方案-拓冰建站

核心原理

一、第一步：找到 Tomcat 上 Jenkins 的 JENKINS_HOME（最容易踩坑）

二、旧服务器：停止服务 + 完整备份

三、新服务器：准备 Docker Jenkins 挂载目录

1. 创建宿主机持久化目录

2. 传输备份包并解压

🔥重中之重：权限修复（Docker 迁移头号坑）

四、启动 Docker Jenkins（两种方式任选）

方式 1：docker run 命令

方式 2：docker-compose.yml（推荐长期使用）

五、启动后关键校验 & 常见问题修复

1. 访问地址注意上下文路径！

2. 凭证丢失 / 无法解密

3. Agent 节点无法连接

4. 构建脚本内绝对路径失效

六、可选迁移优化建议

七、回滚方案

核心原理

Jenkins 所有配置、任务、凭证、构建记录全部保存在JENKINS_HOME目录。

Tomcat 部署 war 包形式的 Jenkins 和 Docker Jenkins 本质是同一套程序，直接迁移完整JENKINS_HOME即可，不需要单独导出任务。 ⚠️ 关键前提：新旧 Jenkins 大版本尽量保持一致（例如旧是 2.401，新镜像也选用 2.401-lts；跨大版本极易插件报错）

一、第一步：找到 Tomcat 上 Jenkins 的 JENKINS_HOME（最容易踩坑）

Jenkins.war 丢进 Tomcat，JENKINS_HOME位置分 3 种情况：

未配置环境变量（默认）Tomcat 启动用户家目录：/usr/share/tomcat/.jenkins或/home/tomcat/.jenkins
tomcat context.xml 配置了 JENKINS_HOME（生产最常见）
```
<Environment name="JENKINS_HOME" value="/data/jenkins_home" type="java.lang.String"/>
```
去${CATALINA_HOME}/conf/Catalina/localhost/jenkins.xml查找 value 路径
启动脚本指定 export JENKINS_HOME=/xxx

快速验证：登录 Jenkins →系统管理 → 系统信息，找到JENKINS_HOME字段，复制路径！

二、旧服务器：停止服务 + 完整备份

进入 Jenkins 页面：http://ip:8080/jenkins/exit优雅关闭
停止 Tomcat

systemctl stop tomcat # 确认进程全部关闭

打包完整JENKINS_HOME（必须停止服务再打包，防止文件损坏）

# 替换为你查到真实JENKINS_HOME路径 JENKINS_OLD=/data/jenkins_home tar -zcvf jenkins_full_backup.tar.gz ${JENKINS_OLD}

不要只备份 jobs 目录！secrets/、credentials.xml、secret.key存放所有凭证，丢了凭证全部失效。

三、新服务器：准备 Docker Jenkins 挂载目录

1. 创建宿主机持久化目录

mkdir -p /opt/jenkins_home

2. 传输备份包并解压

# 旧机器推送 scp jenkins_full_backup.tar.gz root@新机器IP:/opt/ # 新机器解压 cd /opt tar -zxvf jenkins_full_backup.tar.gz -C /opt/jenkins_home --strip-components=1

--strip-components=1：去掉压缩包外层文件夹，保证文件直接落在/opt/jenkins_home/下

🔥重中之重：权限修复（Docker 迁移头号坑）

官方镜像jenkins/jenkins:lts容器内运行用户UID=1000，GID=1000宿主机解压出来的文件属主一般是 root/tomcat，容器会报 Permission denied！

chown -R 1000:1000 /opt/jenkins_home

CentOS/RHEL 开启 SELinux 环境，启动挂载增加:z标签解决权限拦截

四、启动 Docker Jenkins（两种方式任选）

方式 1：docker run 命令

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

/var/jenkins_home是容器内部固定 JENKINS_HOME 路径，不要修改！

方式 2：docker-compose.yml（推荐长期使用）

services: jenkins: image: jenkins/jenkins:lts container_name: jenkins ports: - "8080:8080" - "50000:50000" volumes: - /opt/jenkins_home:/var/jenkins_home:z restart: always

启动：docker compose up -d