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 | 字串 | 指定映象名稱 | |
dest | 字串 | 路徑 | |
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> | 字串 | 使用相應的 key 和 value 為構建的映象附加註解,請參閱 註解 |
註解
這些匯出器支援使用 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。