映象和登錄檔匯出器

image 匯出器將構建結果輸出為容器映象格式。registry 匯出器與之相同，但它透過設定 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`	建立映象後推送。
`按摘要推送`	`true`,`false`	`false`	不帶名稱推送映象。
`registry.insecure`	`true`,`false`	`false`	允許推送到不安全的登錄檔。
`dangling-name-prefix`	`<值>`		將映象命名為 `prefix@<digest>`，用於匿名映象
`name-canonical`	`true`,`false`		新增額外的規範名稱 `name@<digest>`
`compression`	`uncompressed`,`gzip`,`estargz`,`zstd`	`gzip`	壓縮型別，請參閱壓縮
`compression-level`	`0..22`		壓縮級別，請參閱壓縮
`force-compression`	`true`,`false`	`false`	強制應用壓縮，請參閱壓縮
`重寫時間戳`	`true`,`false`	`false`	將檔案時間戳重寫為 `SOURCE_DATE_EPOCH` 值。有關如何指定 `SOURCE_DATE_EPOCH` 值，請參閱構建可重現性。
`oci-mediatypes`	`true`,`false`	`false`	在匯出器清單中使用 OCI 媒體型別，請參閱OCI 媒體型別
`oci-artifact`	`true`,`false`	`false`	證明以 OCI 工件格式生成，請參閱OCI 媒體型別
`解壓`	`true`,`false`	`false`	建立後解壓映象（用於 containerd）
`儲存`	`true`,`false`	`true`	將結果映象儲存到工作程式（例如 containerd）的映象儲存中，並確保映象在內容儲存中包含所有 Blob。如果工作程式沒有映象儲存（例如，當使用 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 文件。

有關 image 或 registry 匯出器的更多資訊，請參閱 BuildKit README。