OCI 與 Docker 匯出器

oci 匯出工具將建置結果輸出為 OCI 映像檔配置的 tarball。docker 匯出工具的行為相同，不同之處在於它匯出的是 Docker 映像檔配置。

docker 驅動程式不支援這些匯出工具。如果您想產生這些輸出，必須使用 docker-container 或其他驅動程式。

概要

使用 oci 和 docker 匯出工具建置容器映像檔

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

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

下表說明了可用的參數

參數	類型	預設值	描述
`name`	String		指定映像檔名稱
`dest`	String		路徑
`tar`	`true`,`false`	`true`	將輸出打包成 tarball 配置
`compression`	`uncompressed`, `gzip`, `estargz`, `zstd`	`gzip`	壓縮類型，請參閱壓縮
`compression-level`	`0..22`		壓縮層級，請參閱壓縮
`force-compression`	`true`,`false`	`false`	強制套用壓縮，請參閱壓縮
`oci-mediatypes`	`true`,`false`		在匯出工具清單中使用 OCI 媒體類型。預設值為 `type=oci` 時為 `true`，`type=docker` 時為 `false`。請參閱 OCI 媒體類型
`annotation.<key>`	String		將帶有對應 `key` 和 `value` 的註釋附加到建置的映像檔中，請參閱註釋 (annotations)

這些匯出工具支援使用 annotation 參數來新增 OCI 註釋，後面接著使用點記法表示的註釋名稱。以下範例設定了 org.opencontainers.image.title 註釋

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

有關註釋的更多資訊，請參閱 BuildKit 文件。

有關 oci 或 docker 匯出工具的更多資訊，請參閱 BuildKit README。