注册表缓存

可以将缓存存储视为缓存的扩展。与缓存不同，缓存与镜像允许更灵活地使用 - 支持的缓存可以做到内联缓存可以做的所有事情，等等：registryinlineinlineregistryregistry

允许分离缓存和生成的镜像伪影，以便您可以分发最终镜像，而不在内部缓存。
它可以在模式下高效缓存多阶段构建，而不仅仅是最后阶段。max
它可以与其他导出器一起使用以获得更大的灵活性，而不仅仅是导出器。image

默认驱动程序不支持此缓存存储后端。要使用此功能，请使用其他驱动程序创建新的构建器。有关更多信息，请参阅构建驱动程序。docker

概要

与更简单的缓存不同，缓存支持多个配置参数：inlineregistry

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=registry,ref=<registry>/<cache-image>[,parameters...] \
  --cache-from type=registry,ref=<registry>/<cache-image> .

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

名字	选择	类型	违约	描述
`ref`	`cache-to`,`cache-from`	字符串		要导入的缓存镜像的全名。
`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`	忽略缓存导出失败导致的错误。

您可以为选择任何有效的值，只要它与将镜像推送到的目标位置。您可以选择不同的标签（例如和），分隔镜像名称（例如和），甚至不同的存储库（例如和）。由您决定策略。reffoo/bar:latestfoo/bar:build-cachefoo/barfoo/bar-cachedocker.io/foo/barghcr.io/foo/bar

如果目标不存在，则缓存导入步骤将失败，但构建会继续。--cache-from

延伸阅读

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

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