docker image load

描述从 tar 归档或 STDIN 加载镜像
用法docker image load [选项]
别名
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` 选项指定要加载的镜像平台变体。如果归档中不存在指定的平台，则会产生错误。

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