镜像和注册表导出器
目录
这image
exporter 将构建结果输出为容器镜像格式。这registry
exporter 是相同的,但它会自动将结果推送
设置push=true
.
概要
使用image
和registry
出口商:
$ docker buildx build --output type=image[,parameters] .
$ docker buildx build --output type=registry[,parameters] .
下表描述了您可以传递给--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 到构建的镜像中,参见 annotations |
附注
这些导出程序支持使用annotation
参数
后跟使用点表示法的注释名称。以下示例将
这org.opencontainers.image.title
注解:
$ docker buildx build \
--output "type=<type>,name=<registry>/<image>,annotation.org.opencontainers.image.title=<title>" .
有关注释的更多信息,请参阅 BuildKit 文档。
延伸阅读
有关image
或registry
exporters 中,请参阅 BuildKit README。