docker image history本地构建层缺失摘要，如何定位基础镜像digest？

一、BuildKit的层优化导致 #

从你提供的历史记录里的buildkit.dockerfile.v0注释能看出来，你是用BuildKit构建的镜像。BuildKit默认会做层合并优化：

• 它会把连续的相关构建指令（比如一串ADD、RUN）合并成更少的层，以此减小镜像体积。那些被合并的中间层不会被单独保存在本地镜像仓库里，所以docker image history查不到它们的ID，就显示成<missing>。
• 只有最顶层的753335235a5f是实际存在的可引用层，中间的临时构建层都被BuildKit清理或合并掉了。

二、镜像拉取时的层缺失 #

如果这个镜像是从远程仓库拉来的，而远程仓库做了镜像优化：

• 很多远程仓库（包括AWS的镜像仓库）不会存储所有中间构建层，只保留最终能运行的镜像层集合。拉到本地后，docker image history只能显示本地存在的层，那些没拉到的中间层就标记为<missing>。

三、Lambda基础镜像的特殊封装 #

AWS Lambda的官方基础镜像本身有特殊的构建逻辑：

• 它把运行时的配置项（比如ENV、WORKDIR、ENTRYPOINT这些）作为镜像元数据处理，而不是做成独立的可寻址层。这些元数据对应的“层”在本地没有独立ID，所以在历史记录里显示<missing>。

怎么拿到基础镜像的Digest？ #

不用纠结docker image history，换这两种方法：

• 看你的Dockerfile里的FROM指令，拉取对应基础镜像后查看digest：

  docker pull <lambda基础镜像名>:<标签>
  docker inspect --format='{{.RepoDigests}}' <lambda基础镜像名>:<标签>
  

• 如果是本地已构建的镜像，用docker inspect查它的父镜像信息：

  docker inspect --format='{{.Parent}}' <你的镜像ID>
  

内容的提问来源于stack exchange，提问作者Dustin Oprea