仓库检查

您可以使用 git fsck 来验证提交到仓库的所有数据的完整性。极狐GitLab 管理员可以：

  • 使用 UI 为项目手动触发此检查。
  • 安排此检查为所有项目自动运行。
  • 从命令行运行此检查。
  • 运行 Rake 任务来检查 Git 仓库。作为比较不同服务器上存储库的一种方式，可对所有仓库运行 git fsck 并生成存储库校验和。

使用 UI 检查项目的仓库

使用 UI 检查项目的仓库：

  1. 在顶部栏上，选择 主菜单 > 管理员。
  2. 在左侧边栏上，选择 概览 > 项目。
  3. 选择要检查的项目。
  4. 在 仓库检查 部分，选择 触发仓库检查。

检查是异步运行的，因此可能需要几分钟才能在管理中心的项目页面上看到检查结果。如果检查失败，请参阅文档。

为所有项目启用仓库检查

可以将极狐GitLab 配置为定期运行检查，而不是手动检查仓库：

  1. 在顶部栏上，选择 主菜单 > 管理员。
  2. 在左侧边栏上，选择 设置 > 仓库 (/admin/application_settings/repository)。
  3. 展开 仓库维护 部分。
  4. 启用 启用仓库检查。

启用后，极狐GitLab 会定期对所有项目仓库和 wiki 仓库运行仓库检查，检测可能的数据损坏。一个项目每月检查不超过一次。 管理员可以配置仓库检查的频率。编辑频率：

  • 对于 Omnibus 安装实例，编辑 /etc/gitlab/gitlab.rb 中的 gitlab_rails['repository_check_worker_cron']。
  • 对于源安装，在 /home/git/gitlab/config/gitlab.yml 中编辑 [gitlab.cron_jobs.repository_check_worker]。

如果任何项目未通过仓库检查，所有极狐GitLab 管理员都会收到有关情况的电子邮件通知。默认情况下，此通知每周在周日开始的午夜发送一次。

可以在 /admin/projects?last_repository_check_failed=1 找到已知检查失败的仓库。

使用命令行运行检查

您可以在 Gitaly 服务器上的仓库使用命令行运行 git fsck。要找到仓库：

  1. 转到仓库的存储位置：
    • 对于 Omnibus 安装，仓库默认存储在 /var/opt/gitlab/git-data/repositories 目录中。
    • 对于 Helm charts 安装，仓库默认存储在 Gitaly pod 内的 /home/git/repositories 目录中。
  2. 确定包含您需要检查的仓库的子目录。

  3. 运行检查。例如： 

    sudo -u git /opt/gitlab/embedded/bin/git -C /var/opt/gitlab/git-data/repositories/@hashed/0b/91/0b91...f9.git fsck

如果检查失败怎么办

如果存储库检查失败，请在磁盘上的 repocheck.log 文件中找到错误：

  • Omnibus 安装实例：/var/log/gitlab/gitlab-rails。
  • 源安装实例：/home/git/gitlab/log。
  • Helm charts 安装的 Sidekiq pod 中：/var/log/gitlab。

如果定期仓库检查导致错误警报，您可以清除所有仓库检查状态：

  1. 在顶部栏上，选择 主菜单 > 管理员。
  2. 在左侧边栏上，选择 设置 > 仓库（/admin/application_settings/repository）。
  3. 展开 仓库维护 部分。
  4. 选择 清除所有仓库检查。

错误：failed to parse commit <commit SHA> from object database for commit-graph

您可以在仓库检查日志中看到 failed to parse commit <commit SHA> from object database for commit-graph 错误。如果您的 commit-graph 缓存已过期，则会发生此错误。commit-graph 缓存是辅助缓存，常规 Git 操作不需要。