跨架构镜像打包问题及解决方案

问题背景:

  • 需求:
    • 有一个镜像是 docker.io 的,是 docker.io/aquasec/kube-bench:v0.10.6,我想把该镜像在本地电脑(可翻墙)下载下来,然后 docker save 打包成一个 tar 包,传输到服务器上。
  • 环境:
    • 本地电脑:MacOS 14.5 (ARM64)
    • Docker Desktop:4.41.2 (191736)
    • Docker Engine:28.1.1

问题现象

我的电脑是 arm64 架构,我考虑通过 docker pull --platform=linux/amd64 下来镜像,然后 docker save 成一个 tar 包,传输到服务器上,直接 docker load 使用,具体命令如下:

bash 复制代码
# 拉取 linux/amd64 架构镜像
docker pull --platform=linux/amd64 docker.io/aquasec/kube-bench:v0.10.6

# 打包镜像为tar包
docker save -o kube-bench.tar docker.io/aquasec/kube-bench:v0.10.6

但是在执行 docker save 命令时,报错信息:
Error response from daemon: unable to create manifests file: NotFound: content digest sha256:b544d2a5cba58aa28c123fe2a535893f607d4f6b62a38db370c4dcc3a6a275e6: not found

根因分析:

详细原因参考:https://github.com/docker/cli/issues/5476

  1. Docker Desktop Bug:当宿主机与目标镜像架构不同时,docker save 错误地尝试访问宿主机架构(ARM64)的manifest数据。
  2. 预期行为:save 操作应仅打包已拉取的指定架构(AMD64)镜像数据,不应检查其他架构
  3. 补充验证:相同操作在Ubuntu AMD64主机上保存ARM64镜像可成功(反向场景正常)

补充:该问题属于是 docker desktop 的一个bug了,同样的操作,我在 ubuntu amd64 服务上,使用 docker save 一个 arm64 架构的镜像,可以正常 docker save 成功。

save 失败是因为 docker 在 save 时去找了 arm64 架构镜像的元数据(b544d2a5cba58aa28c123fe2a535893f607d4f6b62a38db370c4dcc3a6a275e6 就是 arm64 架构镜像的sha256),发现没找到,就报错了,正常情况不应该报错,因为 save 操作其实就是将镜像元数据和 layer 层打包就可以了。

解决方案:

docker save 时显式指定平台参数:

bash 复制代码
# 打包指定架构镜像为tar包
docker save -o kube-bench.tar --platform=linux/amd64 docker.io/aquasec/kube-bench:v0.10.6

可以正常 save 成功。

建议

  1. 完整性验证:传输后可在服务器执行 docker load -i kube-bench.tar && docker inspect --format='{{.Architecture}}' <IMAGE_ID> 确认架构
  2. 替代方案:考虑使用 skopeo 工具(更适合跨架构镜像操作)
  3. 长期方案:关注Docker Desktop更新,该问题可能在未来版本修复
相关推荐
白-胖-子3 小时前
深入剖析大模型在文本生成式 AI 产品架构中的核心地位
人工智能·架构
mCell3 小时前
从删库到跑路?这50个Linux命令能保你职业生涯
linux·windows·macos
勇哥的编程江湖6 小时前
starrocks官网docker部署mysql无法连接
运维·docker·容器
Pomelo_刘金7 小时前
用 DDD 把「闹钟」需求一点点捏出来
架构·rust·领域驱动设计
Pomelo_刘金7 小时前
Clean Architecture 整洁架构:借一只闹钟讲明白「整洁架构」的来龙去脉
后端·架构·rust
碳酸的唐7 小时前
Inception网络架构:深度学习视觉模型的里程碑
网络·深度学习·架构
小码过河.9 小时前
CentOS 搭建 Docker 私有镜像仓库
linux·docker·centos
五点六六六11 小时前
前端常见的性能指标采集
前端·性能优化·架构
fhf11 小时前
2025年了你会卸载Macbook上的应用吗?
macos·shell
飞询12 小时前
部署 coze-loop
docker·coze