Jenkins工程的备份与还原

在 Jenkins 中，Project（项目）/ Job（任务） 的备份和还原是非常常见的运维操作，尤其在迁移、灾备或恢复数据时。Jenkins 的 Job 是通过文件系统存储的，因此备份和恢复的过程主要是文件操作。

 一、Jenkins 项目备份方式

方法一：手动备份（适合小规模或单个 Job）

1. 找到 Jenkins 的根目录，通常是：/var/lib/jenkins/

2. 进入 jobs/ 目录：

   cd /var/lib/jenkins/jobs/

3. 每个项目对应一个文件夹，比如 my-project，直接打包：

   tar -czvf my-project.tar.gz my-project/

4. 如果要备份所有项目：

   tar -czvf all-jobs-backup.tar.gz /var/lib/jenkins/jobs/

方法二：插件备份（适合定期自动备份）

可以使用以下插件：

• ThinBackup：轻量级、简单易用

• SCM Sync Configuration Plugin（不再推荐，维护不活跃）

ThinBackup 使用步骤：

1. 安装 ThinBackup 插件

2. 系统管理 → ThinBackup

3. 配置备份路径、周期、是否包含构建历史等

4. 设置定期备份计划

二、Jenkins 项目还原方式

方法一：手动还原

1. 停止 Jenkins

   systemctl stop jenkins

2. 解压备份文件到 jobs/ 目录：

   tar -xzvf my-project.tar.gz -C /var/lib/jenkins/jobs/

   或者替换整个 jobs 目录：

   rm -rf /var/lib/jenkins/jobs/ tar -xzvf all-jobs-backup.tar.gz -C /var/lib/jenkins/

3. 修复权限（特别是在 Linux 下）：

   chown -R jenkins:jenkins /var/lib/jenkins/

4. 启动 Jenkins：

   systemctl start jenkins

方法二：通过插件还原（如果是用 ThinBackup）

1. 系统管理 → ThinBackup

2. 点击 “Restore” 选项，选择对应备份

3. 恢复后重启 Jenkins

---

 三、注意事项

在每个项目的目录下，有如下几个重要文件：

• config.xml 是每个 Job 的核心配置文件

• builds/ 目录中是构建历史，可选备份

• workspace/ 是工作空间，不建议备份（容易大、且能自动再生成）

• 可同时备份插件目录 plugins/ 和全局配置（如 credentials.xml）

---

四、可选：完全备份 Jenkins 实例

tar -czvf jenkins-full-backup.tar.gz /var/lib/jenkins/