GitLab数据库迁移失败及仓库恢复问题技术求助

一、原GitLab实例修复方案 #

1. 优先修复权限问题 #

从报错信息来看，核心问题是GitLab相关目录的权限被错误修改，导致进程无法读写文件。执行以下命令重置权限：

# 修复日志目录权限
sudo chown -R git:git /opt/gitlab/embedded/service/gitlab-rails/log/
sudo chmod -R u+rwx,g+rwx,o-rwx /opt/gitlab/embedded/service/gitlab-rails/log/

# 修复仓库数据目录权限
sudo chown -R git:git /var/opt/gitlab/git-data/
sudo chmod -R u+rwx,g+rwx,o-rwx /var/opt/gitlab/git-data/

# 修复GitLab日志目录权限
sudo chown -R git:git /var/log/gitlab/

2. 排查数据库迁移失败原因 #

执行带追踪的迁移命令，获取详细错误信息：

sudo gitlab-rake db:migrate --trace

根据输出结果针对性处理：

• 若为数据库连接失败：检查/etc/gitlab/gitlab.rb中的数据库配置，确认MariaDB的用户名、密码、端口正确，且对应用户拥有gitlabhq_production数据库的访问权限。
• 若为数据库权限不足：登录MariaDB执行授权命令：

  GRANT ALL PRIVILEGES ON gitlabhq_production.* TO 'git'@'localhost' IDENTIFIED BY '你的数据库密码';
  FLUSH PRIVILEGES;
  

3. 重新配置并重启GitLab #

完成以上修复后，重新执行配置并重启服务：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

二、新实例恢复仓库的正确步骤 #

直接复制仓库文件无法被GitLab识别，需配合数据库同步操作，以下两种方式可选：

1. 官方备份恢复（推荐） #

如果原实例还能生成备份：

• 在原实例生成备份：

  sudo gitlab-backup create
  

  备份文件会存放在/var/opt/gitlab/backups/，格式类似1699999999_2023_11_13_16.0.0_gitlab_backup.tar。
• 将备份文件上传至新实例的/var/opt/gitlab/backups/，修改权限：

  sudo chown git:git /var/opt/gitlab/backups/[备份文件名].tar
  

• 停止相关服务并执行恢复：

  sudo gitlab-ctl stop puma
  sudo gitlab-ctl stop sidekiq
  sudo gitlab-backup restore BACKUP=[备份文件名前缀，如1699999999_2023_11_13_16.0.0]
  sudo gitlab-ctl reconfigure
  sudo gitlab-ctl restart
  

2. 手动导入仓库文件（无备份时） #

仅能拿到仓库文件时：

• 将原仓库文件复制到新实例的/var/opt/gitlab/git-data/repositories/，修复权限：

  sudo chown -R git:git /var/opt/gitlab/git-data/repositories/
  sudo chmod -R u+rwx,g+rwx,o-rwx /var/opt/gitlab/git-data/repositories/
  

• 执行仓库扫描命令，让GitLab识别并同步到数据库：

  sudo gitlab-rake gitlab:import:repos
  

• 扫描完成后重启服务：

  sudo gitlab-ctl restart
  

内容的提问来源于stack exchange，提问作者Martin De Beer