Integrity check Rake task · Gitlab 中文文檔

# Integrity check Rake task > 原文：[https://docs.gitlab.com/ee/administration/raketasks/check.html](https://docs.gitlab.com/ee/administration/raketasks/check.html) * [Repository integrity](#repository-integrity) * [Check all GitLab repositories](#check-all-gitlab-repositories) * [Uploaded files integrity](#uploaded-files-integrity) * [LDAP check](#ldap-check) # Integrity check Rake task[](#integrity-check-rake-task-core-only "Permalink") GitLab 提供了 Rake 任務來檢查各種組件的完整性. ## Repository integrity[](#repository-integrity "Permalink") 盡管 Git 非常靈活，并試圖防止數據完整性問題，但有時還是會出錯. 以下 Rake 任務旨在幫助 GitLab 管理員診斷問題存儲庫，以便對其進行修復. 需要檢查 3 件事以確定完整性. 1. Git 存儲庫文件系統檢查（ [`git fsck`](https://git-scm.com/docs/git-fsck) ）. 此步驟驗證存儲庫中對象的連接性和有效性. 2. 在存儲庫目錄中檢查`config.lock` . 3. 檢查`refs/heads`是否有任何分支/引用鎖定文件. 重要的是要注意，僅存在`config.lock`或引用鎖并不一定表示問題. 當 Git 和 GitLab 在存儲庫上執行操作時，會定期創建和刪除鎖定文件. 它們用于防止數據完整性問題. 但是，如果 Git 操作被中斷，則這些鎖可能無法正確清理. 以下癥狀可能表明存儲庫完整性有問題. 如果用戶遇到這些癥狀，則可以使用下面介紹的 Rake 任務來確定導致問題的確切存儲庫. * 嘗試推送代碼時收到錯誤- `remote: error: cannot lock ref` * 查看 GitLab 儀表板或訪問特定項目時出現 500 錯誤. ### Check all GitLab repositories[](#check-all-gitlab-repositories "Permalink") 此任務循環遍歷 GitLab 服務器上的所有存儲庫，并運行前面所述的完整性檢查. **全部安裝** ``` sudo gitlab-rake gitlab:git:fsck ``` **源安裝** ``` sudo -u git -H bundle exec rake gitlab:git:fsck RAILS_ENV=production ``` ## Uploaded files integrity[](#uploaded-files-integrity "Permalink") 用戶可以將各種類型的文件上傳到 GitLab 安裝. 這些完整性檢查可以檢測丟失的文件. 此外，對于本地存儲的文件，會在上載時生成校驗和并將其存儲在數據庫中，這些校驗將針對當前文件進行校驗. 當前，以下類型的文件支持完整性檢查： * CI 工件（從版本 10.7.0 起可用） * LFS 對象（從版本 10.6.0 起可用） * 用戶上傳（從版本 10.6.0 起可用） **全部安裝** ``` sudo gitlab-rake gitlab:artifacts:check sudo gitlab-rake gitlab:lfs:check sudo gitlab-rake gitlab:uploads:check ``` **Source Installation** ``` sudo -u git -H bundle exec rake gitlab:artifacts:check RAILS_ENV=production sudo -u git -H bundle exec rake gitlab:lfs:check RAILS_ENV=production sudo -u git -H bundle exec rake gitlab:uploads:check RAILS_ENV=production ``` 這些任務還接受一些環境變量，可用于覆蓋某些值： | Variable | Type | Description | | --- | --- | --- | | `BATCH` | integer | 指定批處理的大小. 默認為 200. | | `ID_FROM` | integer | 指定從其開始的 ID，包括值. | | `ID_TO` | integer | 指定以 ID 結尾的 ID 值（包括該值）. | | `VERBOSE` | boolean | 導致失敗被單獨列出，而不是被匯總. | ``` sudo gitlab-rake gitlab:artifacts:check BATCH=100 ID_FROM=50 ID_TO=250 sudo gitlab-rake gitlab:lfs:check BATCH=100 ID_FROM=50 ID_TO=250 sudo gitlab-rake gitlab:uploads:check BATCH=100 ID_FROM=50 ID_TO=250 ``` 輸出示例： ``` $ sudo gitlab-rake gitlab:uploads:check Checking integrity of Uploads - 1..1350: Failures: 0 - 1351..2743: Failures: 0 - 2745..4349: Failures: 2 - 4357..5762: Failures: 1 - 5764..7140: Failures: 2 - 7142..8651: Failures: 0 - 8653..10134: Failures: 0 - 10135..11773: Failures: 0 - 11777..13315: Failures: 0 Done! ``` 詳細輸出示例： ``` $ sudo gitlab-rake gitlab:uploads:check VERBOSE=1 Checking integrity of Uploads - 1..1350: Failures: 0 - 1351..2743: Failures: 0 - 2745..4349: Failures: 2 - Upload: 3573: #<Errno::ENOENT: No such file or directory @ rb_sysopen - /opt/gitlab/embedded/service/gitlab-rails/public/uploads/user-foo/project-bar/7a77cc52947bfe188adeff42f890bb77/image.png> - Upload: 3580: #<Errno::ENOENT: No such file or directory @ rb_sysopen - /opt/gitlab/embedded/service/gitlab-rails/public/uploads/user-foo/project-bar/2840ba1ba3b2ecfa3478a7b161375f8a/pug.png> - 4357..5762: Failures: 1 - Upload: 4636: #<Google::Apis::ServerError: Server error> - 5764..7140: Failures: 2 - Upload: 5812: #<NoMethodError: undefined method `hashed_storage?' for nil:NilClass> - Upload: 5837: #<NoMethodError: undefined method `hashed_storage?' for nil:NilClass> - 7142..8651: Failures: 0 - 8653..10134: Failures: 0 - 10135..11773: Failures: 0 - 11777..13315: Failures: 0 Done! ``` ## LDAP check[](#ldap-check "Permalink") LDAP 檢查 Rake 任務將測試綁定 DN 和密碼憑據（如果已配置），并將列出 LDAP 用戶的樣本. 此任務也作為`gitlab:check`任務的一部分執行，但可以獨立運行. 有關詳細信息，請參見[LDAP Rake 任務-LDAP 檢查](ldap.html#check) .