仓库检查 (BASIC SELF)

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

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

使用 UI 检查项目的仓库

使用 UI 检查项目的仓库:

  1. 在左侧边栏中,选择 搜索或转到
  2. 选择 管理中心
  3. 在左侧边栏中,选择 概览 > 项目
  4. 选择要检查的项目。
  5. 仓库检查 部分,选择 触发仓库检查

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

为所有项目启用仓库检查

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

  1. 在左侧边栏中,选择 搜索或转到
  2. 选择 管理中心
  3. 在左侧边栏中,选择 设置 > 仓库 (/admin/application_settings/repository)。
  4. 展开 仓库维护 部分。
  5. 启用 启用仓库检查

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

  • 对于 Linux 软件包安装实例,编辑 /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. 转到仓库的存储位置:
    • 对于 Linux 软件包安装,仓库默认存储在 /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 --no-dangling
    

    错误 fatal: detected dubious ownership in repository 意味着您正在使用错误的账户运行命令,例如 root

如果检查失败怎么办

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

  • Linux 软件包安装实例:/var/log/gitlab/gitlab-rails
  • 源安装实例:/home/git/gitlab/log
  • Helm charts 安装的 Sidekiq pod 中:/var/log/gitlab

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

  1. 在左侧边栏中,选择 搜索或转到
  2. 选择 管理中心
  3. 在左侧边栏中,选择 设置 > 仓库/admin/application_settings/repository)。
  4. 展开 仓库维护 部分。
  5. 选择 清除所有仓库检查

错误: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 操作不需要。

丢弃提交、标签或 blob 消息

仓库检查输出通常包括必须修剪丢弃的标签、blob 和提交:

dangling tag 5c6886c774b713a43158aae35c4effdb03a3ceca
dangling blob 3e268c23fcd736db92e89b31d9f267dd4a50ac4b
dangling commit 919ff61d8d78c2e3ea9a32701dff70ecbefdd1d7

这种情况在 Git 仓库中很常见。它们是由强制推送到分支等操作生成的,因为这会在仓库中生成一个提交,该提交不再被 ref 或另一个提交引用。

如果仓库检查失败,输出可能包含这些警告。

忽略这些消息,并从其他输出中确定仓库检查失败的根本原因。

15.8 及更高版本不再将这些消息包含在检查输出中。当从命令行运行时,使用 --no-dangling 选项来禁用。