图像和注册表导出器

导出器image将构建结果输出为容器镜像格式。导出器 registry是相同的,但它通过设置自动推送结果push=true

概要

image使用和导出器构建容器映像registry

$ docker buildx build --output type=image[,parameters] .
$ docker buildx build --output type=registry[,parameters] .

--output下表描述了您可以传递给for 的可用参数 type=image

范围类型默认描述
name细绳指定图像名称
pushtrue,falsefalse创建镜像后推送。
push-by-digesttrue,falsefalse推送没有名字的图片。
registry.insecuretrue,falsefalse允许推送到不安全的注册表。
dangling-name-prefix<value>用 命名图像prefix@<digest>,用于匿名图像
name-canonicaltrue,false添加额外的规范名称name@<digest>
compressionuncompressed, gzip, estargz,zstdgzip压缩类型,参见 压缩
compression-level0..22压缩级别,参见 压缩
force-compressiontrue,falsefalse强制应用压缩,请参阅 压缩
oci-mediatypestrue,falsefalse在导出器清单中使用 OCI 媒体类型,请参阅 OCI 媒体类型
unpacktrue,falsefalse创建后解压镜像(与containerd一起使用)
storetrue,falsetrue将结果图像存储到工作线程(例如,containerd)的图像存储中,并确保图像在内容存储中具有所有 blob。如果工作人员没有图像存储(例如,使用 OCI 工作人员时),则忽略。
annotation.<key>细绳将注释与相应的key和附加value到构建的图像上,请参阅 注释

注释

这些导出器支持使用参数添加 OCI 注释annotation,后跟使用点表示法的注释名称。以下示例设置org.opencontainers.image.title注释:

$ docker buildx build \
    --output "type=<type>,name=<registry>/<image>,annotation.org.opencontainers.image.title=<title>" .

有关注释的更多信息,请参阅 BuildKit 文档

进一步阅读

有关imageregistry导出器的更多信息,请参阅 BuildKit README