镜像和注册表导出器
目录
导出器将构建结果输出为容器镜像格式。导出器是相同的,但它会自动将结果推送
设置。image
registry
push=true
概要
使用 和 exporters 构建容器镜像:image
registry
$ docker buildx build --output type=image[,parameters] .
$ docker buildx build --output type=registry[,parameters] .
下表描述了您可以传递给 for 的可用参数:--output
type=image
参数 | 类型 | 违约 | 描述 |
---|---|---|---|
name | 字符串 | 指定镜像名称 | |
push | true ,false | false | 创建镜像后推送。 |
push-by-digest | true ,false | false | 推送不带名称的镜像。 |
registry.insecure | true ,false | false | 允许推送到不安全的注册表。 |
dangling-name-prefix | <value> | 名称镜像与 ,用于匿名镜像prefix@<digest> | |
name-canonical | true ,false | 添加其他规范名称name@<digest> | |
compression | uncompressed ,,,gzip estargz zstd | gzip | 压缩类型,请参阅压缩 |
compression-level | 0..22 | 压缩级别,请参阅 压缩 | |
force-compression | true ,false | false | 强制应用压缩,请参阅压缩 |
rewrite-timestamp | true ,false | false | 将文件时间戳重写为该值。有关如何指定该值的信息,请参阅构建重现性。SOURCE_DATE_EPOCH SOURCE_DATE_EPOCH |
oci-mediatypes | true ,false | false | 在导出程序清单中使用 OCI 媒体类型,请参阅 OCI 媒体类型 |
unpack | true ,false | false | 创建后解压缩镜像(用于 containerd) |
store | true ,false | true | 将结果镜像存储到工作程序(例如 containerd)的镜像存储中,并确保镜像在 Content Store 中包含所有 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 文档。
延伸阅读
有关 or 导出器的更多信息,请参阅 BuildKit README。image
registry