Ubuntu中GitLab的备份与恢复方法

Ubuntu中GitLab备份与恢复方法

一、GitLab备份方法

1. 准备工作

• 权限要求：需具备root权限或sudo权限；
• 服务状态：确保GitLab服务正常运行（可通过sudo gitlab-ctl status检查）；
• 存储空间：备份目录需预留足够空间（默认备份路径为/var/opt/gitlab/backups）。

2. 使用内置工具备份（推荐）

GitLab提供了gitlab-rake和gitlab-backup命令，可快速完成全量备份（包含仓库、数据库、用户、配置等）：

• 立即执行备份：运行sudo gitlab-rake gitlab:backup:create CRON=1（CRON=1表示跳过定时任务调度，立即执行）；
• 使用专用命令（GitLab 12.1+）：sudo gitlab-backup create，生成的备份文件默认存储在/var/opt/gitlab/backups目录，文件名格式为时间戳_版本_gitlab_backup.tar（如1714684800_16.0.0_gitlab_backup.tar）。

3. 修改备份路径（可选）

若需更改备份存储位置，可编辑配置文件/etc/gitlab/gitlab.rb，添加或修改以下参数：

gitlab_rails['backup_path'] = '/your/custom/backup/path'

保存后执行sudo gitlab-ctl reconfigure使配置生效。

4. 设置自动备份（可选）

通过系统Cron定时任务实现每日自动备份，例如每天凌晨3点执行：

sudo crontab -e

添加以下行：

0 3 * * * /opt/gitlab/bin/gitlab-backup create CRON=1

保存退出后，Cron会自动执行备份任务。

5. 增量备份（可选）

结合rsync命令可实现增量备份（仅备份新增/修改的文件），减少存储占用：

sudo rsync -avz --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} /var/opt/gitlab/ /path/to/incremental/backup/

此命令会同步/var/opt/gitlab目录到目标路径，排除无需备份的系统目录。

二、GitLab恢复方法

1. 准备工作

• 版本匹配：恢复时GitLab版本需与备份时一致或更高（如备份时为16.0.0，恢复时可使用16.0.x或17.0.0）；
• 备份文件：确保备份文件（如1714684800_16.0.0_gitlab_backup.tar）完整且未被损坏；
• 服务状态：停止GitLab相关服务以保证数据一致性。

2. 停止GitLab服务

执行以下命令停止关键服务（避免恢复过程中数据冲突）：

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq

3. 恢复备份文件

• 移动备份文件：将备份文件复制到备份目录（默认/var/opt/gitlab/backups）：

  sudo cp /path/to/backup/file.tar /var/opt/gitlab/backups/
  

• 赋予权限：确保备份文件可读：

  sudo chmod 777 /var/opt/gitlab/backups/file.tar
  

• 执行恢复：运行以下命令（BACKUP参数为备份文件的时间戳部分，如1714684800）：

  sudo gitlab-backup restore BACKUP=1714684800
  

  恢复过程中会提示“是否覆盖现有数据”，输入yes确认。

4. 恢复配置与SSL（可选）

若备份时单独备份了配置文件和SSL证书，需将其恢复到原路径：

sudo cp /path/to/backup/gitlab.rb /etc/gitlab/gitlab.rb
sudo cp -r /path/to/backup/ssl /etc/gitlab/

5. 启动GitLab服务

恢复完成后，重新配置并启动GitLab：

sudo gitlab-ctl reconfigure  # 重新加载配置
sudo gitlab-ctl start       # 启动所有服务

6. 验证恢复

• 访问GitLab Web界面（默认http://服务器IP），使用原账户登录；
• 检查仓库、用户、组、权限等数据是否完整，确保系统正常运行。

三、注意事项

• 定期测试恢复：每季度至少测试一次恢复流程，确保备份文件可用；
• 备份文件安全：将备份文件存储在异地（如云存储、外部硬盘），避免单点故障；
• 监控备份状态：通过邮件或日志（/var/log/gitlab/gitlab-rails/production.log）监控备份是否成功；
• 增量备份策略：结合全量备份（每周1次）与增量备份（每日1次），平衡存储成本与恢复效率。