Debian中GitLab的备份与恢复方法

Debian系统中GitLab的备份与恢复方法

一、备份步骤

1. 准备工作

备份前建议停止GitLab的关键服务（如unicorn、sidekiq），避免数据写入导致备份不完整。执行以下命令停止服务：
sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq

2. 手动创建备份

使用GitLab内置的rake命令生成备份文件，默认存储路径为/var/opt/gitlab/backups，文件名为TIMESTAMP_gitlab_backup.tar（如1714567890_gitlab_backup.tar）。命令如下：
sudo gitlab-rake gitlab:backup:create

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

若需更改备份存储路径，编辑配置文件/etc/gitlab/gitlab.rb，添加或修改以下参数：
gitlab_rails['backup_path'] = '/data/gitlab/backups'
修改完成后，执行sudo gitlab-ctl reconfigure使配置生效。

4. 定时自动备份（可选）

通过cron设置定时任务，实现每日自动备份。例如，创建备份脚本/var/opt/gitlab/backups/gitlabbak.sh，内容如下：

#!/bin/bash
/opt/gitlab/bin/gitlab-rake gitlab:backup:create
sleep 10
find /var/opt/gitlab/backups -name "*.tar" -type f -mtime +7 -exec rm -rf {} \;  # 删除7天前的备份

赋予脚本执行权限：sudo chmod +x /var/opt/gitlab/backups/gitlabbak.sh
添加cron任务（每日凌晨2点执行）：
0 2 * * * /bin/sh /var/opt/gitlab/backups/gitlabbak.sh > /dev/null 2>&1

5. 备份敏感配置文件

手动备份GitLab的关键配置文件和敏感数据，避免恢复时遗漏：
sudo cp /etc/gitlab/gitlab.rb /data/gitlab/backups/
sudo cp /etc/gitlab/gitlab-secrets.json /data/gitlab/backups/
sudo cp -r /etc/ssl/gitlab /data/gitlab/backups/ssl

二、恢复步骤

1. 准备工作

• 确保恢复环境的GitLab版本与备份时的版本一致（或更高版本，但需注意兼容性）；
• 停止GitLab服务，避免数据冲突：
  sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq

2. 拷贝备份文件

将备份文件（如1714567890_gitlab_backup.tar）复制到目标服务器的gitlab_rails['backup_path']目录下（如/var/opt/gitlab/backups）。

3. 执行恢复操作

使用gitlab-rake命令恢复指定备份文件（BACKUP参数为备份文件名去掉扩展名的部分）：
sudo gitlab-rake gitlab:backup:restore BACKUP=1714567890
恢复过程中需输入两次yes确认操作。

4. 启动GitLab服务

恢复完成后，启动GitLab所有服务：
sudo gitlab-ctl start
或重启单个服务（如unicorn）：
sudo gitlab-ctl restart unicorn

5. 验证恢复结果

• 打开浏览器访问GitLab Web界面（如http://your_server_ip）；
• 使用原有账号登录，检查项目、仓库、用户数据是否完整恢复。

三、注意事项

• 版本一致性：恢复前务必确认GitLab版本匹配，否则可能导致数据损坏；
• 备份文件安全：备份文件包含敏感信息（如用户密码、SSH密钥），需存储在加密或受限访问的目录；
• 定期测试恢复：每季度至少测试一次备份文件的恢复流程，确保备份有效性；
• 数据覆盖风险：恢复操作会覆盖目标服务器上的现有数据，操作前需确认目标服务器无重要未备份数据。