Jenkins怎么迁到Debian

把 Jenkins 从现有环境迁移到 Debian 系统，通常分为几种情况。下面给你一个通用、稳妥的迁移方案，适用于大多数场景（war / apt 安装 / 旧 Linux → Debian）。

一、迁移前确认信息

在原 Jenkins 服务器上确认：

Jenkins 版本

jenkins --version
# 或
cat /usr/share/jenkins/jenkins.war | grep -a "Jenkins ver"

安装方式

apt / yum
war 包
Docker

echo $JENKINS_HOME
# 默认一般是
/var/lib/jenkins

插件列表

ls $JENKINS_HOME/plugins

二、Debian 上安装 Jenkins

1. 安装 Java（推荐 JDK 17）

sudo apt update
sudo apt install -y openjdk-17-jdk

2. 添加 Jenkins 源

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

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、迁移 Jenkins 数据（核心）

1. 停止 Jenkins

原机器 & Debian 都停

sudo systemctl stop jenkins

2. 打包原数据

tar czf jenkins-home.tar.gz -C /var/lib/jenkins .

3. 拷贝到 Debian

scp jenkins-home.tar.gz debian:/tmp/

4. 恢复数据

sudo rm -rf /var/lib/jenkins/*
sudo tar xzf /tmp/jenkins-home.tar.gz -C /var/lib/jenkins
sudo chown -R jenkins:jenkins /var/lib/jenkins

四、启动并验证

sudo systemctl start jenkins
sudo systemctl enable jenkins

查看日志：

journalctl -u jenkins -f

浏览器访问：

http://<debian-ip>:8080

五、常见问题处理

1. 插件不兼容

升级 Debian 上的 Jenkins 到与原版本一致或更高
登录后去：

Manage Jenkins → Manage Plugins → Updated

2. 凭据丢失

确保 credentials.xml
和 secrets/ 目录完整

3. 节点（Agent）连不上

检查 known_hosts
重新生成 agent secret

六、可选：Docker 方式迁移（更干净）

如果你愿意用 Docker：

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

直接挂载原 JENKINS_HOME 即可。

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

原系统（CentOS / Ubuntu / Docker？）
Jenkins 版本
是否用 Pipeline / Agent

我可以给你精确迁移步骤。