建立垃圾收集

当 docker builder prune 或 docker buildx prune 命令同时运行时，垃圾收集会定期运行并遵循修剪策略的有序列表。

垃圾收集在 BuildKit 守护进程中运行。当缓存大小变得太大或缓存期限到期时，守护进程会清除构建缓存。以下部分介绍如何通过定义垃圾收集策略来配置大小和期限参数。

配置

根据构建器实例使用的驱动程序，垃圾收集将使用不同的配置文件。

如果您使用 docker驱动程序，则可以在 Docker Daemon 配置中配置垃圾收集。文件：

{
  "builder": {
    "gc": {
      "enabled": true,
      "defaultKeepStorage": "10GB",
      "policy": [
        { "keepStorage": "10GB", "filter": ["unused-for=2200h"] },
        { "keepStorage": "50GB", "filter": ["unused-for=3300h"] },
        { "keepStorage": "100GB", "all": true }
      ]
    }
  }
}

对于其他驱动程序，可以使用 BuildKit 配置文件配置垃圾收集：

[worker.oci]
  gc = true
  gckeepstorage = 10000
  [[worker.oci.gcpolicy]]
    keepBytes = 512000000
    keepDuration = 172800
    filters = [ "type==source.local", "type==exec.cachemount", "type==source.git.checkout"]
  [[worker.oci.gcpolicy]]
    all = true
    keepBytes = 1024000000

默认策略

如果未设置，默认垃圾收集策略适用于所有构建器：

GC Policy rule#0:
        All:            false
        Filters:        type==source.local,type==exec.cachemount,type==source.git.checkout
        Keep Duration:  48h0m0s
        Keep Bytes:     512MB
GC Policy rule#1:
        All:            false
        Keep Duration:  1440h0m0s
        Keep Bytes:     26GB
GC Policy rule#2:
        All:            false
        Keep Bytes:     26GB
GC Policy rule#3:
        All:            true
        Keep Bytes:     26GB

rule#0：如果构建缓存使用超过 512MB，请在 2 天未使用后删除最容易重现的数据。
rule#1：删除 60 天内未使用的所有数据。
rule#2：将非共享构建缓存保持在上限以下。
rule#3：如果以前的策略不够，请开始删除内部数据以将构建缓存保持在上限之下。

笔记
Keep Bytes默认为磁盘大小的 10%。如果无法确定磁盘大小，则使用 2GB 作为后备。