映像檔和 Registry 匯出器

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`	建立映像檔後推送。
`push-by-digest`	`true`、`false`	`false`	推送沒有名稱的映像檔。
`registry.insecure`	`true`、`false`	`false`	允許推送至不安全的儲存庫。
`dangling-name-prefix`	`<值>`		使用 `prefix@<摘要>` 命名映像檔，用於匿名映像檔
`name-canonical`	`true`、`false`		新增額外的標準名稱 `name@<摘要>`
`compression`	`uncompressed`、`gzip`、`estargz`、`zstd`	`gzip`	壓縮類型，請參閱壓縮
`compression-level`	`0..22`		壓縮級別，請參閱壓縮
`force-compression`	`true`、`false`	`false`	強制套用壓縮，請參閱壓縮
`rewrite-timestamp`	`true`、`false`	`false`	將檔案時間戳記改寫為 `SOURCE_DATE_EPOCH` 值。請參閱建置重現性`oci-mediatypes`	`true`、`false`	`false`	在匯出器資訊清單中使用 OCI 媒體類型，請參閱 OCI 媒體類型
`unpack`	`true`、`false`	`false`	建立後解壓縮映像檔（與 containerd 搭配使用）
`store`	`true`、`false`	`true`	將結果映像檔儲存到工作者的映像檔存放區（例如，containerd），並確保映像檔在內容存放區中具有所有 Blob。如果工作者沒有映像檔存放區（例如，使用 OCI 工作者時），則會忽略。
`annotation.<鍵>`	字串		使用各自的 `鍵` 和 `值` 將註釋附加到建置的映像檔，請參閱註釋

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

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