Debian上GitLab备份与恢复步骤是什么

Debian系统GitLab备份与恢复步骤

一、备份步骤

1. 停止GitLab相关服务（可选但推荐）

为确保备份数据的完整性和一致性，建议停止GitLab的核心服务（如unicorn、sidekiq），避免备份过程中数据写入导致文件损坏。

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

2. 创建备份文件

使用GitLab提供的Rake任务生成备份，该命令会在默认路径/var/opt/gitlab/backups下生成一个压缩的tar格式备份文件（文件名格式为时间戳_版本号_gitlab_backup.tar）。

sudo gitlab-rake gitlab:backup:create

3. （可选）修改备份路径和过期时间

若需更改备份存储位置或设置备份保留期限，可编辑GitLab配置文件/etc/gitlab/gitlab.rb：

sudo vim /etc/gitlab/gitlab.rb

添加或修改以下参数（以备份到/data/gitlab/backups目录、保留7天为例）：

gitlab_rails['backup_path'] = "/data/gitlab/backups"  # 自定义备份路径
gitlab_rails['backup_keep_time'] = 604800           # 备份保留时间（秒，7天=604800秒）

修改完成后，执行以下命令使配置生效：

sudo gitlab-ctl reconfigure

4. （可选）设置定时备份

通过Linux的Crontab功能实现自动备份，例如每周一、三、五的8:30执行备份脚本（脚本需包含备份命令和旧备份清理逻辑）：

创建备份脚本/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 +10 -exec rm -rf {} \;  # 删除10天前的备份

赋予脚本可执行权限：

sudo chmod +x /var/opt/gitlab/backups/gitlabbak.sh

编辑Crontab（sudo crontab -e），添加以下行：

0 8 * * 1,3,5 /bin/sh /var/opt/gitlab/backups/gitlabbak.sh > /dev/null 2>&1  # 每周一、三、五8:00执行

5. （可选）备份配置文件和敏感数据

为确保恢复后GitLab配置一致，需手动备份以下关键文件到安全位置（如外部存储设备或另一台服务器）：

sudo cp /etc/gitlab/gitlab.rb /path/to/backup/          # GitLab主配置文件
sudo cp /etc/gitlab/gitlab-secrets.json /path/to/backup/  # 敏感信息（如数据库密码、SSH密钥）
sudo cp -r /etc/ssl/gitlab /path/to/backup/             # SSL证书目录

二、恢复步骤

1. 准备工作

确保目标服务器已安装与原服务器版本一致的GitLab（可通过sudo gitlab-ctl status查看原版本）；
将原服务器/var/opt/gitlab/backups目录下的备份文件复制到目标服务器的相同路径（若修改过备份路径，需复制到新路径）；
若修改过配置文件（如gitlab.rb），需提前将备份的配置文件复制到/etc/gitlab/目录下。

2. 停止GitLab相关服务

恢复前需停止GitLab服务，避免数据冲突：

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

3. 执行恢复操作

使用GitLab的Rake任务恢复备份，需指定备份文件的编号（备份文件名中_前的时间戳部分，如1712345678_2024_04_05_11.1.4_gitlab_backup.tar的编号为1712345678）：

sudo gitlab-rake gitlab:backup:restore BACKUP=1712345678

执行过程中会提示确认恢复操作，输入yes并按回车键继续。

4. 启动GitLab服务

恢复完成后，启动GitLab所有服务：

sudo gitlab-ctl start
# 或单独启动unicorn和sidekiq
sudo gitlab-ctl start unicorn
sudo gitlab-ctl start sidekiq

5. 验证恢复结果

打开浏览器访问GitLab Web界面（默认地址http://服务器IP），使用原账户登录，检查以下内容是否恢复：

项目仓库（代码、提交记录）；
用户账号及权限；
配置信息（如邮件设置、Webhook）；
SSL证书是否生效。

注意事项

版本一致性：恢复前必须确保目标服务器GitLab版本与原服务器一致，否则会提示版本不匹配错误；
数据覆盖：恢复操作会覆盖目标服务器上的现有数据，请提前备份当前数据；
敏感信息保护：备份文件包含项目代码、用户信息等敏感内容，需存储在安全位置（如加密存储、访问控制）；
定期测试：至少每季度测试一次备份文件的恢复流程，确保备份有效性。