OCI 和 Docker 匯出器

oci 匯出器將構建結果輸出為 OCI 映象佈局 tarball。docker 匯出器行為相同,但它匯出的是 Docker 映象佈局。

docker 驅動程式不支援這些匯出器。如果你想生成這些輸出,必須使用 docker-container 或其他驅動程式。

概要

使用 ocidocker 匯出器構建容器映象

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

下表描述了可用的引數

引數型別預設值描述
name字串指定映象名稱
dest字串路徑
tartrue,falsetrue將輸出捆綁到 tarball 佈局中
compressionuncompressed,gzip,estargz,zstdgzip壓縮型別,請參閱 壓縮
compression-level0..22壓縮級別,請參閱 壓縮
force-compressiontrue,falsefalse強制應用壓縮,請參閱 壓縮
oci-mediatypestrue,false在匯出器清單中使用 OCI 媒體型別。對於 type=oci 預設為 true,對於 type=docker 預設為 false。請參閱 OCI 媒體型別
annotation.<key>字串使用相應的 keyvalue 為構建的映象附加註解,請參閱 註解

註解

這些匯出器支援使用 annotation 引數新增 OCI 註解,後跟使用點符號的註解名稱。以下示例設定了 org.opencontainers.image.title 註解

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

有關注解的更多資訊,請參閱 BuildKit 文件

進一步閱讀

有關 ocidocker 匯出器的更多資訊,請參閱 BuildKit README