Docker构建独立.tar.gz镜像及构建缓存清理问题咨询

当前环境与构建命令 #

当前使用的Docker版本：

Docker version 23.0.6, build ef23cbc

现有构建命令：

docker build --no-cache=true --force-rm -t $TAG .
docker save $TAG | pigz > $DOCKER_CLIENT_NAME
docker image rm -f  $TAG

问题1：合并命令生成OCI格式.tar.gz镜像文件 #

可通过Docker Buildx实现命令合并，直接生成符合要求的OCI格式压缩镜像，无需分步执行save和rm：

1. 先创建并启用Buildx构建器（解决缓存导出的驱动限制问题）：

docker buildx create --use --name custom-builder

2. 执行合并后的构建导出命令：

docker buildx build --no-cache --force-rm -t $TAG --output type=oci,dest=- . | pigz > $DOCKER_CLIENT_NAME

• --output type=oci,dest=-：指定输出OCI标准格式的镜像，dest=-将镜像内容输出到标准输出，直接通过管道交给pigz压缩
• 该命令不会在本地Docker镜像库留存构建后的镜像，因此无需额外执行docker image rm

问题2：构建缓存堆积与清理问题 #

问题原因解析 #

• --no-cache=true仅用于构建时禁用缓存复用，不会清理已存在的构建缓存
• --force-rm仅删除构建过程中的临时容器，与构建缓存（中间层）无关，因此无法解决缓存堆积
• 默认Docker驱动不支持缓存导出/导入，需切换到Buildx构建器

解决方案 #

1. 用Buildx指定自定义缓存存储，避免本地缓存堆积：

docker buildx build --no-cache --force-rm -t $TAG \
  --cache-from type=local,src=/your/custom/cache/dir \
  --cache-to type=local,dest=/your/custom/cache/dir,mode=max \
  --output type=oci,dest=- . | pigz > $DOCKER_CLIENT_NAME

• mode=max：保存所有缓存层，可复用缓存加速后续构建；若无需复用，可改为mode=min减少缓存体积
• 缓存将存储在指定目录，不会占用Docker默认的构建缓存空间

2. 安全清理缓存

• 清理Buildx构建缓存（不影响运行中容器/镜像）：

docker buildx prune -f

• 若使用自定义缓存目录，直接删除目录即可：

rm -rf /your/custom/cache/dir

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