首页/开发/Git 与协作速查/GitLab 仓库 Housekeeping
进阶与大仓实践69 条

GitLab 仓库 Housekeeping

GitLab 会在推送后自动执行仓库整理(gc、repack 等)以控制体积;管理员也可在项目或实例层面手动触发,排查体积异常时先确认整理是否完成。

Git 与协作速查开发更新于 2026-10-12
自动推送量达到阈值后平台自动触发整理
手动项目/管理中心提供 Housekeeping 入口(权限按平台版本)
观察仓库体积、对象数在整理后下降才说明生效

体积观测(本地镜像)

体积观测(本地镜像)
git clone --mirror https://gitlab.example.com/group/app.git app-mirror.git
git -C app-mirror.git count-objects -vH
git -C app-mirror.git gc --quiet
不要直接在平台数据目录手工跑 gc 作为常规手段:容器化部署由平台托管,手工操作可能被覆盖。

易错点

  • 整理耗时与仓库规模相关,大仓触发后短时间内性能可能波动
  • 体积不降常见原因是历史里仍有大对象,需要先做内容治理

数据来源与参考

  • GitLab Docs:Housekeeping(仓库整理)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌