图像和注册表导出器
导出器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 | 细绳 | 指定图像名称 | |
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 | 强制应用压缩,请参阅 压缩 |
oci-mediatypes | true,false | false | 在导出器清单中使用 OCI 媒体类型,请参阅 OCI 媒体类型 |
unpack | true,false | false | 创建后解压镜像(与containerd一起使用) |
store | true,false | true | 将结果图像存储到工作线程(例如,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 文档。
进一步阅读
有关image或registry导出器的更多信息,请参阅
BuildKit README。