如何在Docker Buildkit模式下从构建中间层运行容器
核心说明
Buildkit的底层存储机制和传统非Buildkit构建模式存在差异,日志中输出的sha256哈希默认无法直接被Docker runtime识别,不存在直接拿这个值就能和老模式一样直接运行容器的快捷操作,但有多种等效方案可以实现同等的中间层调试目标。
为什么不能直接用日志里的sha256运行容器
- 传统非Buildkit(即经典Docker构建器)模式下,每个构建步骤生成的中间层会直接存入Docker daemon的公共镜像存储,可被Docker runtime直接识别,因此日志输出的层ID可以直接作为
docker run的参数使用。 - Buildkit默认会把所有构建中间结果存放在独立、隔离的内容寻址存储中,这些中间层不会自动同步到Docker daemon的可访问存储目录。日志中打印的
sha256:xxx是Buildkit内部对应当前构建步骤结果的存储哈希,并非Docker runtime可直接调用的镜像标识,直接执行docker run sha256:xxx会报“找不到对应镜像”的错误。
等效的中间层调试操作方法
方法1:按步骤导出镜像到本地Docker存储(和传统模式体验最接近)
这个方法可以完全复现非Buildkit模式下进入中间层调试的体验,操作步骤:
- 从构建日志中定位需要调试的目标步骤,比如日志里的
#32 [28/33] COPY test.py .,对应构建流程的第28步 - 构建时通过
--target参数指定只构建到这一步就停止,搭配--load参数把构建结果直接加载到本地Docker镜像列表,示例命令:docker buildx build --target 目标步骤对应的构建阶段标识 --load -t debug-image . - 构建完成后执行
docker run -ti debug-image bash,就能进入对应步骤的环境调试,和传统模式的操作逻辑完全一致
方法2:使用Buildkit原生调试能力直接进入失败步骤容器
Buildkit自带的调试功能不需要导出镜像,调试效率比传统模式更高:
- 创建Buildx builder实例时开启调试模式,执行命令:
docker buildx create --name debug-builder --buildkitd-flags '--debug' --use - 保持
--progress=plain参数执行构建,当流程在某一步中断或失败时,直接执行buildctl debug shells命令,就能直接连接到失败步骤对应的运行环境,开启交互shell调试,不需要手动查找层ID。
日志中sha256值的实际使用场景
日志里的sha256是Buildkit内部存储的内容寻址哈希,如果一定要用这个值完成调试,需要手动把Buildkit存储中对应哈希的层导出成Docker可识别的镜像:
- 找到当前Buildx builder的本地存储挂载路径
- 从存储目录中提取对应sha256哈希的层文件,打包成符合Docker镜像格式的tar归档
- 用
docker load命令把打包好的归档导入本地Docker镜像列表,导入完成后就可以正常基于这个层运行容器了
注意:这种手动提取层的操作流程繁琐,仅适合有特殊调试需求的场景,日常调试优先选择前面两种方法即可。
内容的提问来源于stack exchange,提问作者Finch_Powers
相关产品推荐
相关产品推荐

