CentOS 上 Jenkins 的备份与恢复策略
一 核心原则与范围
- 备份的核心是 $JENKINS_HOME（默认 /var/lib/jenkins），其中包含作业配置、构建历史、插件、用户与凭据等。常见关键文件与目录如下：
- 必须备份：$JENKINS_HOME/config.xml、$JENKINS_HOME/jobs/、$JENKINS_HOME/users/、$JENKINS_HOME/plugins/、$JENKINS_HOME/secrets/（注意：secrets 内包含被 master.key 加密的数据，恢复时需要 master.key 才能解密）。
- 建议排除：$JENKINS_HOME/jobs/*/workspace/（可从 SCM 重新拉取）、$JENKINS_HOME/jobs//builds//artifacts/（若已归档到外部存储）、$JENKINS_HOME/cache/、$JENKINS_HOME/tools/、$JENKINS_HOME/logs/（除非用于审计）。
- 安全要点：将 master.key 与常规备份分离、离线妥善保管；secrets/ 目录必须备份，但需确保恢复时有对应的 master.key 才能还原加密凭据。
- 系统级配置：建议同时备份 /etc/sysconfig/jenkins 或 /etc/default/jenkins（包含 JENKINS_HOME、端口、JVM 参数等），便于在新环境快速还原服务配置。
二 备份策略与工具
- 全量打包备份（停机一致性优先）
- 适用：对一致性要求高、可接受短时停机的场景。
- 步骤：停止 Jenkins → 使用 tar 打包 $JENKINS_HOME（可按需排除 workspace、artifacts、cache、tools、logs）→ 启动 Jenkins → 将归档文件传输到安全存储（本地/远程）。
- 示例：tar -czvf jenkins_backup_$(date +%F).tar.gz -C /var/lib jenkins --exclude=jobs//workspace --exclude=jobs//builds/*/artifacts --exclude=cache --exclude=tools --exclude=logs
- 增量/差异与插件化备份
- 插件方案：使用 ThinBackup 插件进行定时全备/差异备，支持保留策略与一键恢复，适合频繁备份与快速回滚。
- 文件级增量：在停机一致性前提下，可用 rsync 的 –link-dest 实现基于硬链的差异备份，节省空间并保留多版本。
- 远程与离线存储
- rsync + SSH 密钥免密：将备份归档推送到远程备份机，便于异地容灾。
- FTP/SFTP：在 CentOS 上使用 lftp 将备份同步至 Windows FTP 服务器，适合已有 FTP 基础设施的团队。
- 系统快照与一致性
- 在虚拟化/云环境使用快照（如 LVM、云盘快照）获取文件系统一致性点，再结合 tar/rsync 归档 $JENKINS_HOME 与关键配置，提高恢复速度与一致性保障。
三 恢复策略与步骤
- 全量恢复（停机）
- 停止 Jenkins → 备份当前 $JENKINS_HOME（便于回滚）→ 清空或移走现有目录 → 将备份归档解压到 $JENKINS_HOME → 如 JENKINS_HOME 变更，更新 /etc/sysconfig/jenkins 或 /etc/default/jenkins 中的 JENKINS_HOME → 启动 Jenkins 并验证。
- 插件化恢复（ThinBackup）
- 在 Manage Jenkins → ThinBackup → Restore 选择备份点执行恢复，适合快速回滚配置与作业定义。
- 版本与兼容性
- 尽量在相同大版本间恢复；跨版本恢复需先在测试环境验证 JENKINS_HOME 与新版本 Jenkins 的兼容性（插件、配置语法等）。
- 凭据与密钥
- 若恢复后凭据无法解密，检查 $JENKINS_HOME/secrets/ 是否完整，并确认已单独恢复 master.key；master.key 不应与常规备份混存，应单独离线保管。
四 自动化与保留策略
- 定时任务
- 使用 crontab 调度备份脚本，例如每日 02:00 执行：0 2 * * * /opt/backup/jenkins_backup.sh。
- 脚本内需妥善记录日志、处理退出码、在失败时告警（邮件/企业微信/钉钉等）。
- 保留与清理
- 依据容量与合规设置保留周期（如保留 7/30 天），使用 find … -mtime +N -delete 定期清理过期归档，避免磁盘被占满。
- 监控与验证
- 定期校验备份可用性（解压抽查、校验和）、监控备份成功率与容量趋势，并周期性演练恢复流程，确保真实可用。
五 实战脚本与最小示例
- 全量备份脚本（精简版，含远程 rsync）
- 说明：默认 $JENKINS_HOME=/var/lib/jenkins；备份时排除大体积与可重建目录；成功后 rsync 到远程备份机（需配置 SSH 免密）。
- 用法：chmod +x jenkins_backup.sh；crontab -e 添加 0 2 * * * /opt/backup/jenkins_backup.sh
- 脚本示例：
-
#!/bin/bash
set -e
JENKINS_HOME=“${JENKINS_HOME:-/var/lib/jenkins}”
BACKUP_DIR=“/opt/backups/jenkins”
TS=$(date +%F_%H%M%S)
BACKUP_PATH=“$BACKUP_DIR/jenkins_$TS”
REMOTE_USER=“backup”
REMOTE_HOST=“192.0.2.10”
REMOTE_DIR=“/data/jenkins_backups”
mkdir -p “$BACKUP_PATH”
echo “[$(date)] 停止 Jenkins”
sudo systemctl stop jenkins || { echo “停止失败”; exit 1; }
echo “[$(date)] 打包 $JENKINS_HOME（排除 workspace/artifacts/cache/tools/logs）”
sudo tar czf “$BACKUP_PATH/jenkins_home.tar.gz” -C “$JENKINS_HOME”
–exclude=jobs//workspace --exclude=jobs//builds/*/artifacts
–exclude=cache --exclude=tools --exclude=logs .
echo “[$(date)] 备份系统配置”
sudo tar czf “$BACKUP_PATH/jenkins_config.tar.gz” -C /etc sysconfig/jenkins default/jenkins 2>/dev/null || true
echo “[$(date)] 启动 Jenkins”
sudo systemctl start jenkins
echo “[$(date)] 上传到远程备份机”
rsync -avz --delete -e ssh “$BACKUP_PATH/” “$REMOTE_USER@$REMOTE_HOST:$REMOTE_DIR/”
echo “[$(date)] 清理 30 天前备份”
find “$BACKUP_DIR” -type f -name “jenkins_*.tar.gz” -mtime +30 -delete
echo “[$(date)] 备份完成：$BACKUP_PATH”
- 恢复要点
- 停止 Jenkins → 将 jenkins_home.tar.gz 解压到目标 $JENKINS_HOME → 如目录变更，更新 /etc/sysconfig/jenkins 或 /etc/default/jenkins 的 JENKINS_HOME → 启动 Jenkins → 如凭据异常，确认 master.key 已就位并可用。