Jenkins如何备份Debian配置

在 Debian 上备份 Jenkins 配置，核心就是备份 Jenkins 的 主目录（JENKINS_HOME） 以及相关系统配置。下面按「推荐做法 → 手动备份 → 自动备份 → 恢复」来说明。

一、Jenkins 在 Debian 上的关键路径

1. Jenkins 主目录（最重要）

默认路径：

/var/lib/jenkins

包含内容：

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

✅ 只要备份这个目录，就能恢复绝大多数配置

2. Jenkins 系统级配置

/etc/default/jenkins
/etc/jenkins/

3. Web 服务器（如使用 Nginx/Apache）

/etc/nginx/
/etc/apache2/

二、手动备份（最常用）

1. 停止 Jenkins（推荐）

sudo systemctl stop jenkins

2. 打包 JENKINS_HOME

sudo tar -czvf jenkins-backup-$(date +%F).tar.gz /var/lib/jenkins

3. 备份系统配置

sudo tar -czvf jenkins-etc-backup-$(date +%F).tar.gz /etc/default/jenkins /etc/jenkins

4. 启动 Jenkins

sudo systemctl start jenkins

三、不停止 Jenkins 的备份（热备）

如果不能完全停机：

sudo tar --exclude='/var/lib/jenkins/workspace' \
         --exclude='/var/lib/jenkins/builds' \
         -czvf jenkins-config-backup.tar.gz /var/lib/jenkins

⚠️ 热备可能有极小概率配置不一致

四、使用 Jenkins 插件备份（推荐）

1. 安装插件

• ThinBackup
• 或 Backup Plugin

2. ThinBackup 示例

• 系统管理 → ThinBackup
• 设置：
  • Backup directory: /opt/jenkins-backup
  • Backup only configuration: ✅
• 设置定时任务（cron）

✅ 优点：自动、可控、无需停机

五、自动化备份（cron 示例）

sudo crontab -e

每天凌晨 2 点：

0 2 * * * systemctl stop jenkins && tar -czf /backup/jenkins-$(date +\%F).tar.gz /var/lib/jenkins && systemctl start jenkins

六、恢复 Jenkins 配置

1. 停止 Jenkins

sudo systemctl stop jenkins

2. 恢复主目录

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

3. 修复权限

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

4. 启动 Jenkins

sudo systemctl start jenkins

七、最小备份清单（只保配置）

如果只关心配置：

/var/lib/jenkins/config.xml
/var/lib/jenkins/jobs/
/var/lib/jenkins/users/
/var/lib/jenkins/credentials.xml
/var/lib/jenkins/secrets/

如果你愿意，我可以：

• 给你一个 一键备份脚本
• 或针对 Docker / Kubernetes Jenkins 的备份方案
• 或说明 如何只备份插件列表

你现在是 裸机 Debian 安装 还是 Docker 部署？