docker image load

描述從 tar 歸檔或 STDIN 載入映象
用法docker image load [OPTIONS]
別名
docker load

描述

從檔案或 STDIN 中的 tar 歸檔（即使使用 gzip、bzip2、xz 或 zstd 壓縮）載入映象或倉庫。它會恢復映象和標籤。

選項

選項預設值描述
-i, --input從 tar 歸檔檔案讀取，而不是 STDIN
--platformAPI 1.48+ 僅載入給定的平臺變體。格式為 os[/arch[/variant]]（例如，linux/amd64）
-q, --quiet抑制載入輸出

示例

$ docker image ls

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE

從 STDIN 載入映象

$ docker load < busybox.tar.gz

Loaded image: busybox:latest
$ docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
busybox             latest              769b9341d937        7 weeks ago         2.489 MB

從檔案載入映象 (--input)

$ docker load --input fedora.tar

Loaded image: fedora:rawhide
Loaded image: fedora:20

$ docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
busybox             latest              769b9341d937        7 weeks ago         2.489 MB
fedora              rawhide             0d20aec6529d        7 weeks ago         387 MB
fedora              20                  58394af37342        7 weeks ago         385.5 MB
fedora              heisenbug           58394af37342        7 weeks ago         385.5 MB
fedora              latest              58394af37342        7 weeks ago         385.5 MB

載入特定平臺 (--platform)

--platform 選項允許您指定要載入的映象平臺變體。預設情況下，docker load 會載入歸檔中存在的所有平臺變體。使用 --platform 選項來指定要載入的映象平臺變體。如果歸檔中不存在給定的平臺，則會產生錯誤。

平臺選項採用 os[/arch[/variant]] 格式；例如，linux/amd64 或 linux/arm64/v8。架構和變體是可選的，如果省略，則預設為守護程序的本機架構。

以下示例從包含多個平臺變體的歸檔中載入 alpine 映象的 linux/amd64 變體。

$ docker image load -i image.tar --platform=linux/amd64
Loaded image: alpine:latest

以下示例嘗試從歸檔中載入 linux/ppc64le 映象，但給定的平臺不存在於歸檔中；

$ docker image load -i image.tar --platform=linux/ppc64le
requested platform (linux/ppc64le) not found: image might be filtered out