怎样在Linux上备份GitLab数据

Linux上备份GitLab数据的实用指南

一 核心步骤

• 使用 GitLab 内置工具创建备份包：执行命令 sudo gitlab-rake gitlab:backup:create。备份包默认生成在 /var/opt/gitlab/backups，文件名形如 TIMESTAMP_gitlab_backup.tar，其中包含仓库、数据库、用户与权限等核心数据。为降低对线上影响，建议在业务低峰期执行。

二 备份配置与自动化

• 修改备份目录：编辑 /etc/gitlab/gitlab.rb，设置例如 gitlab_rails[‘backup_path’] = “/your/backup/path”，保存后执行 sudo gitlab-ctl reconfigure 使配置生效。
• 设置保留策略：在 gitlab.rb 中配置 gitlab_rails[‘backup_keep_time’] = 604800（单位：秒，示例为保留 7 天），避免磁盘被旧备份占满。
• 定时任务示例：使用 crontab -e 添加条目，每天 02:00 自动备份
  • 0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create
  • 如自定义了备份路径，请确保 cron 任务使用的命令与 gitlab.rb 配置一致。

三 备份完整性校验与异地容灾

• 校验与演练：定期将备份包拷贝到测试环境执行恢复演练，验证可用性与完整性，灾难来临时可快速接管。
• 配置文件一并备份：除数据备份包外，建议同步备份 /etc/gitlab/ 下的配置（如 gitlab.rb/gitlab-secrets.json），可编写脚本在备份后打包并传输到远端存储。
• 传输与清理脚本示例（可按需调整）：
  • 备份并跳过制品：gitlab-rake gitlab:backup:create SKIP=artifacts
  • 打包配置：tar czvf gitlab_config_$(date +%F).tar.gz -C /etc/gitlab gitlab*
  • 传输到备份机：scp /var/opt/gitlab/backups/*.tar user@backup:/path
  • 清理本地旧包：find /var/opt/gitlab/backups -name “*_gitlab_backup.tar” -mtime +6 -delete
• 版本要求：恢复时的 GitLab 版本需与备份时一致或更新，否则可能出现兼容性问题。

四 容器与多机环境要点

• Docker 环境：可直接在容器内执行备份
  • docker run --rm --link gitlab:gitlab -v /var/opt/gitlab/data:/data gitlab/gitlab-ce:latest gitlab-backup create
  • 注意挂载数据卷与备份目录，确保容器内外路径一致。
• Omnibus 包与源码安装路径差异：
  • Omnibus 常用命令为 /opt/gitlab/bin/gitlab-rake gitlab:backup:create
  • 源码安装可能使用 bundle exec rake gitlab:backup:create RAILS_ENV=production
  • 以实际安装方式选择对应命令。

五 恢复简述

• 恢复前准备：将备份包放到目标机器的备份目录（与 gitlab.rb 中 backup_path 一致），为保证一致性，先停止相关服务：sudo gitlab-ctl stop unicorn 与 sudo gitlab-ctl stop sidekiq。
• 执行恢复：运行 sudo gitlab-rake gitlab:backup:restore BACKUP=your_backup_filename，按提示确认覆盖。恢复完成后启动服务：sudo gitlab-ctl start 或 sudo gitlab-ctl restart。