Gitlab实例丢失代码仓库实际存储路径的相对路径映射

1. 从备份提取路径映射信息 #

完全可以从GitLab完整备份中提取映射信息，因为备份包包含数据库全量快照，其中projects表的path、path_with_namespace字段就是你需要的相对路径映射：

• 找到备份文件（通常命名格式为1234567890_2024_05_20_18.0.0_gitlab_backup.tar）
• 解压备份包到临时目录：tar xf <备份文件名> -C /tmp/gitlab_backup
• 解压数据库备份文件：gunzip /tmp/gitlab_backup/db/database.sql.gz
• 直接查看SQL文件或用psql查询项目路径关联信息：

  SELECT id, name, path, path_with_namespace, disk_path FROM projects;
  

  其中disk_path对应磁盘上的哈希目录名，可直接匹配服务器上的仓库存储路径。

2. 通过脚本/数据库更新相对路径 #

可以直接修改数据库或用GitLab Rails控制台补全路径信息，操作前务必备份当前GitLab数据库：

方法一：直接操作数据库 #

1. 开启GitLab维护模式避免并发冲突：gitlab-ctl deploy-page up
2. 连接到GitLab数据库：gitlab-psql -d gitlabhq_production
3. 先查询缺失路径的项目：

   SELECT id, name, disk_path FROM projects WHERE path IS NULL OR path = '';
   

4. 根据磁盘仓库归属（比如已知哈希目录对应项目）执行更新：

   UPDATE projects 
   SET path = '项目路径', path_with_namespace = '组名/项目路径' 
   WHERE id = 目标项目ID;
   

方法二：用GitLab Rails控制台（更安全） #

1. 进入Rails控制台：gitlab-rails console
2. 通过磁盘路径或项目ID定位目标项目：

   project = Project.find_by(disk_path: 'abcdef123456')
   # 或通过ID查找
   project = Project.find(123)
   

3. 更新路径信息：

   project.update!(
     path: 'my-project',
     path_with_namespace: 'my-team/my-project'
   )
   

4. 退出控制台后关闭维护模式：gitlab-ctl deploy-page down

3. 永久保存路径映射信息 #

可以通过以下方式定期备份映射信息，避免再次丢失：

• 定时导出数据库字段：用crontab添加每日定时任务，导出projects表关键路径字段到CSV：

  0 2 * * * /usr/bin/psql -U gitlab -d gitlabhq_production -c "SELECT id, name, path, path_with_namespace, disk_path, repository_storage FROM projects;" > /var/backups/gitlab_project_paths_$(date +\%Y\%m\%d).csv
  

• API批量导出：写简单脚本调用GitLab API（需管理员Token），批量拉取项目路径信息保存：

  curl --header "PRIVATE-TOKEN: 你的管理员Token" "https://你的GitLab域名/api/v4/projects?per_page=100&page=1" | jq '.[] | {id, name, path, path_with_namespace, disk_path}' > gitlab_projects_$(date +%Y%m%d).json
  

• 保持自动数据库备份：确保GitLab自带的自动备份任务开启（在/etc/gitlab/gitlab.rb中配置），定期生成完整数据库快照。

内容的提问来源于stack exchange，提问作者matsukan