Debian下GitLab的备份与恢复策略是什么

Debian下GitLab的备份与恢复策略

一 备份范围与策略要点

• 备份范围应覆盖：数据库、仓库数据、附件、CI/CD作业输出与产物、LFS对象、以及关键配置文件与密钥。GitLab Omnibus 提供的备份工具会打包上述应用数据；配置文件与密钥需单独备份。备份文件默认位于 /var/opt/gitlab/backups，文件名包含时间戳与版本，例如：1493107454_2018_04_25_10.6.4-ce_gitlab_backup.tar。建议将备份与配置分别存放与传输，降低密钥与加密数据同时泄露的风险。

二 备份实施步骤

• 配置备份路径与保留策略：编辑 /etc/gitlab/gitlab.rb，设置备份目录与保留时间（秒），然后执行 gitlab-ctl reconfigure 使配置生效。
  • 示例：
    • gitlab_rails[‘backup_path’] = “/data/gitlab/backups”
    • gitlab_rails[‘backup_keep_time’] = 604800 # 保留7天
• 创建应用数据备份：执行备份命令，生成时间戳备份包到指定目录。
  • 示例：/opt/gitlab/bin/gitlab-backup create
• 备份配置文件与密钥：使用专用命令将 /etc/gitlab 打包，便于独立保管与快速恢复。
  • 示例：gitlab-ctl backup-etc（默认生成到 /etc/gitlab/config_backup；可用 --backup-path 指定目录）
• 定时与远程冗余：使用 Cron 定时执行备份；将备份文件通过 scp/rsync 同步到远程存储或对象存储，避免单点故障。
  • 示例（每天 2:00）：0 2 * * * /opt/gitlab/bin/gitlab-backup create
  • 示例（远程拷贝）：rsync -avz /var/opt/gitlab/backups/ user@remote:/backup/gitlab/
• 版本一致性：备份与恢复的 GitLab 版本应尽量保持一致，避免兼容性问题。

三 恢复实施步骤

• 准备与版本匹配：在新/目标服务器安装同版本 GitLab，停写服务（建议停止 unicorn/sidekiq 或执行 gitlab-ctl stop），将备份文件放到目标机的备份目录（默认 /var/opt/gitlab/backups）。
• 恢复应用数据：使用备份编号或完整文件名执行恢复（提示输入两次 yes 确认）。
  • 示例：gitlab-rake gitlab:backup:restore BACKUP=备份编号
• 恢复配置与密钥：将之前备份的 gitlab.rb / gitlab-secrets.json 等还原至 /etc/gitlab，确保加密与签名密钥一致。
• 启动与验证：启动服务（gitlab-ctl start 或 restart），登录 Web 检查项目、仓库、附件、CI/CD 产物与 LFS 对象是否完整一致。

四 推荐备份策略模板

五 注意事项与常见问题

• 恢复会覆盖现有数据，务必先做好完整备份与变更记录；恢复前停止写入服务可减少不一致风险。
• 配置文件与密钥（如 gitlab-secrets.json）是恢复成功的关键，丢失将导致无法解密或签名失败；应与应用数据分开保管与传输。
• 备份工具默认不包含 /etc/gitlab 与 /var/log/gitlab 等目录，需单独纳入备份清单；必要时可手动打包归档。
• 版本不匹配是恢复失败的常见原因，跨小版本恢复需谨慎评估；跨大版本建议按官方升级路径逐步升级后再恢复。
• 备份文件含敏感信息，需设置严格的访问控制与传输加密（如 scp/rsync over SSH、对象存储服务端加密）。