# LFS自动清理


# 基本功能介绍

工蜂 LFS 提供自动清理功能,用于周期性清理仓库中已不再使用的LFS文件

  • 当项目LFS存储占用超过80%时,将会在「设置-高级设置-版本库设置」页面提示可以开启LFS自动清理功能,仅项目owner/master可进行操作
  • 点击「配置自动清理规则」按钮后,可在弹窗中开启并配置清理策略
  • 清理策略包括:
    • 清理周期:清理周期可选:每年重复 / 每半年重复 / 每月重复
    • 清理条件:清理条件可选:一年未访问 / 半年未访问
  • 清理周期定义:
    • 每月重复:每个月1号清理一次
    • 每半年重复:每年1月1日和7月1日清理一次
    • 每年重复:每年1月1日清理一次
  • 如果需要关闭/修改LFS自动清理策略,同样可以在「设置-高级设置-版本库设置」页面进行配置

# 如何制定合理的清理策略?

您可根据项目的实际情况制定合理的清理策略,避免出现 误删除 的情况,可参考的维度包括但不限于:

  • LFS文件的访问频率
  • 项目整体更新速度
  • 相关流水线构建频率
  • 相关流水线构建方式(全量拉取 or 增量拉取)

我们强烈建议您先制定相对保守的清理策略,运行一段时间后再根据项目的实际情况进行调整

此外,为了最大程度避免自动清理过程中出现误删除的情况,以下文件即使符合您设定的清理条件也不会被清理:

  • 小于64kb的文件
  • 默认分支最新commit中存在的文件

自动清理过程中出现误删除该怎么办?

可以联系 工蜂 helper(工蜂助手)进行反馈,我们会尽量帮你恢复

# fork项目是否可以开启LFS自动清理功能?

由于fork项目和原始项目共用LFS存储,因此fork出来的项目无法单独开启LFS自动清理功能

  • 原始项目开启LFS自动清理后,此时在fork项目的「设置-高级设置-版本库设置」页面会有相关提示,同时fork项目中的LFS文件也会被清理
  • fork项目无法单独关闭LFS自动清理,除非原始项目已关闭该功能
  • 如果原始项目被删除,fork项目的自动清理功能也会终止
lastUpdate: 3/10/2025, 7:03:39 PM