docker image load
| 描述 | 从 tar 归档或 STDIN 加载镜像 |
|---|---|
| 用法 | docker image load [OPTIONS] |
| 别名 | docker load |
描述
从文件或 STDIN 中的 tar 归档（即使使用 gzip、bzip2、xz 或 zstd 压缩）加载镜像或仓库。它会恢复镜像和标签。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
-i, --input | 从 tar 归档文件读取，而不是 STDIN | |
--platform | API 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