本地缓存

缓存存储是一个简单的缓存选项，可将缓存存储为文件在文件系统上的目录中，将 OCI 镜像布局用于底层目录结构。如果你是只是测试，或者如果您希望灵活地自行管理共享存储溶液。local

概要

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=local,dest=path/to/local/dir[,parameters...] \
  --cache-from type=local,src=path/to/local/dir .

下表描述了您可以传递给和的可用 CSV 参数。--cache-to--cache-from

名字	选择	类型	违约	描述
`src`	`cache-from`	字符串		从中导入缓存的本地目录的路径。
`digest`	`cache-from`	字符串		要导入的清单的摘要，请参阅缓存版本控制。
`dest`	`cache-to`	字符串		缓存导出到的本地目录的路径。
`mode`	`cache-to`	`min`,`max`	`min`	要导出的缓存层，请参阅缓存模式。
`oci-mediatypes`	`cache-to`	`true`,`false`	`true`	在导出的清单中使用 OCI 媒体类型，请参阅 OCI 媒体类型。
`image-manifest`	`cache-to`	`true`,`false`	`false`	使用 OCI 媒体类型时，请为高速缓存镜像生成镜像清单而不是镜像索引，请参阅 OCI 媒体类型。
`compression`	`cache-to`	`gzip`,,`estargzzstd`	`gzip`	Compression type （压缩类型），请参阅缓存压缩。
`compression-level`	`cache-to`	`0..22`		压缩级别，请参阅缓存压缩。
`force-compression`	`cache-to`	`true`,`false`	`false`	强制应用压缩，请参见缓存压缩。
`ignore-error`	`cache-to`	布尔	`false`	忽略缓存导出失败导致的错误。

如果缓存不存在，则缓存导入步骤将失败，但 build 继续。src

缓存版本控制

本节介绍了本地文件系统上的缓存的版本控制工作方式。以及如何使用该参数来使用旧版本的 cache。digest

如果手动检查缓存目录，则可以看到生成的 OCI 镜像布局：

$ ls cache
blobs  index.json  ingest
$ cat cache/index.json | jq
{
  "schemaVersion": 2,
  "manifests": [
    {
      "mediaType": "application/vnd.oci.image.index.v1+json",
      "digest": "sha256:6982c70595cb91769f61cd1e064cf5f41d5357387bab6b18c0164c5f98c1f707",
      "size": 1560,
      "annotations": {
        "org.opencontainers.image.ref.name": "latest"
      }
    }
  ]
}

与其他缓存类型一样，本地缓存在导出时被替换，方法是将文件的内容。但是，以前的缓存仍将是在目录中可用。这些旧缓存可以通过摘要寻址，并无限期保留。因此，本地缓存的大小将继续为 grow （有关更多信息，请参阅 moby/buildkit#1896）。index.jsonblobs

使用导入缓存时，您可以指定参数要强制加载旧版本的缓存，例如：--cache-todigest

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=local,dest=path/to/local/dir \
  --cache-from type=local,ref=path/to/local/dir,digest=sha256:6982c70595cb91769f61cd1e064cf5f41d5357387bab6b18c0164c5f98c1f707 .

延伸阅读

有关缓存的介绍，请参阅 Docker 构建缓存。

有关缓存后端的更多信息，请参阅 BuildKit README。local