怎样用Jenkins备份数据

在 Jenkins 里“备份数据”通常指备份 Jenkins 的主目录（JENKINS_HOME），因为里面包含了任务配置、构建历史、插件、用户权限等核心数据。下面从原理 → 常用方案 → 实操示例给你讲清楚。

一、Jenkins 需要备份什么？

核心目录是 JENKINS_HOME（常见路径）：

• Linux：/var/lib/jenkins
• Docker：/var/jenkins_home
• Windows：C:\ProgramData\Jenkins\.jenkins

必须备份的内容：

• jobs/（任务配置和历史）
• config.xml（全局配置）
• users/（用户和权限）
• plugins/（插件，可选但推荐）
• credentials.xml（凭据）
• secrets/（密钥）

可以不备份：

• workspace/（构建工作区，可重建）
• logs/（日志，非关键）

二、常见备份方案（从简单到专业）

方案 1：直接打包 JENKINS_HOME（最常用）

手动备份

systemctl stop jenkins   # 停止 Jenkins（推荐）
tar -czf jenkins-backup-$(date +%F).tar.gz /var/lib/jenkins
systemctl start jenkins

不停止 Jenkins 也能备份，但可能有文件不一致风险。

定时备份（cron）

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

方案 2：使用 Jenkins 备份插件（推荐）

1️⃣ 安装插件

• ThinBackup
• 或 Backup Plugin

2️⃣ ThinBackup 配置示例

1. 系统管理 → ThinBackup
2. 设置：
   • Backup directory：/backup/jenkins
   • Backup schedule：0 2 * * *
   • 勾选：
     • Backup build results
     • Backup plugins
3. 保存并手动执行一次

✅ 优点：

• 不需要停 Jenkins
• 可增量备份
• 可一键恢复

方案 3：Docker / K8s 环境备份

Docker 卷备份

docker run --rm \
  -v jenkins_home:/var/jenkins_home \
  -v /backup:/backup \
  alpine tar czf /backup/jenkins.tar.gz /var/jenkins_home

Kubernetes（PVC）

kubectl exec jenkins-pod -- tar czf /tmp/jenkins.tar.gz /var/jenkins_home
kubectl cp jenkins-pod:/tmp/jenkins.tar.gz ./jenkins.tar.gz

方案 4：远程 / 云备份（生产推荐）

备份后同步到远程：

rsync -avz /backup/ user@backup-server:/jenkins-backup/

或上传到：

• S3
• OSS
• MinIO

三、如何恢复 Jenkins 数据？

使用 ThinBackup 恢复

1. 停止 Jenkins
2. ThinBackup → Restore
3. 选择备份点
4. 启动 Jenkins

手动恢复

systemctl stop jenkins
rm -rf /var/lib/jenkins/*
tar -xzf jenkins-backup.tar.gz -C /
systemctl start jenkins

四、最佳实践建议

✅ 至少 每天备份一次
✅ 保留 7～30 天历史
✅ 备份文件 异地存储
✅ 定期做 恢复演练
✅ 敏感信息（凭据）单独加密

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

• Jenkins 是 裸机 / Docker / K8s
• 是否用 插件
• 是否需要 自动清理旧备份

我可以给你一套可直接用的脚本或 Jenkinsfile。