登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  软件教程

Docker buildx du 怎样按构建器查看缓存占用和可回收空间

来源:17golang原创

时间:2026-11-19 12:30:38 435浏览 收藏

Docker Buildx 的缓存占用不能只看宿主机目录大小,先要确认查询对应的 builder。docker buildx du 默认查看当前选中的构建器,输出每条缓存记录的可回收标记、大小和最近访问时间;如果要看另一台 builder,使用 --builder 指定名称。整个过程是只读检查,不会执行 prune。

官方地址:https://docs.docker.com/reference/cli/docker/buildx/du/

最稳妥的顺序是:先确认 builder,再看总量和记录,最后用 --filter、--format 缩小范围。不要把 du 的检查命令误当成清理命令。
  • 默认表格回答“缓存占了多少、哪些记录可回收”。
  • --builder 用来避免查错构建器。
  • --format 只改变展示方式,--filter 才改变检查范围。

1. 先确认要检查的 builder

Buildx 命令支持全局的 --builder 选择器。日常排查先列出 builder,确认当前使用项和需要检查的远程或专用构建器名称;如果没有特别指定,du 就读取当前选中的 builder。

# 说明:先查看可用 builder,确认当前选中项的名称和状态
docker buildx ls

# 说明:只检查名为 team-builder 的 builder,不切换全局默认值
docker buildx du --builder team-builder

这里的关键不是先清理,而是固定检查对象。多 builder 环境中,如果省略 --builder,看到的占用可能来自另一个构建节点,后续判断就会失去上下文。

Buildx 当前构建器、缓存记录和磁盘占用汇总的原创说明图
图1:说明图,展示选择 builder 后查看缓存记录与 Shared、Private、Reclaimable、Total 汇总的关系;不是实际 Docker 截图。

2. 先用默认表格看清缓存记录

不加其它选项时,docker buildx du 会展示当前 builder 的缓存记录,并在末尾汇总共享、私有、可回收和总占用。常见列可以这样读:

列或标记阅读重点
ID缓存记录标识;ID 后的星号表示记录可变。
RECLAIMABLE判断记录是否可回收,不能只按 SIZE 排序就直接删除。
SIZE该记录关联的占用大小;大小后的星号表示共享存储。
LAST ACCESSED辅助判断记录的最近使用情况。

官方示例说明,ID 后的星号代表 mutable,大小后的星号代表 shared。共享记录被 prune 时,通常只是删除缓存元数据,实际存储层仍可能被镜像等资源使用;而 RECLAIMABLE=false 的记录即使使用 prune --all 也不会被删除。

# 说明:读取当前 builder 的完整缓存占用概览,不执行清理
docker buildx du

# 说明:用 pretty 查看可变、共享、描述和最近使用等细节
docker buildx du --verbose

3. 用 filter 和 format 缩小排查范围

du --filter 沿用 Buildx prune 的筛选器语法,但在这里仍然只做查看。筛选器可以按最近使用时间、类型、描述、是否在用、是否共享等条件组合;多个 --filter 会同时生效。

# 说明:只查看最近 24 小时之外的记录,先评估旧缓存规模
docker buildx du --filter "until=24h"

# 说明:排除 exec.cachemount 类型,缩小普通缓存记录的查看范围
docker buildx du --filter "type!=exec.cachemount"

# 说明:只输出 ID 与大小,便于复制到后续报表或人工对照
docker buildx du --format "{{.ID}}: {{.Size}}"

# 说明:以换行 JSON 输出字段,便于脚本逐条读取
docker buildx du --format=json

模板支持 .ID、.Size、.Reclaimable、.Shared、.LastUsedAt 等字段。过滤决定“看哪些记录”,格式化决定“怎么展示这些记录”,两者不要混为一谈。

Buildx 缓存检查中的筛选器、格式模板和预览结果原创说明图
图2:说明图,展示用筛选器缩小范围、用模板整理预览;不是实际 Docker 截图。

4. 根据结果判断是否需要进一步处理

看到较大的 SIZE 不等于它一定可以安全清理。先看 RECLAIMABLE、shared 标记和最近使用时间,再结合业务构建频率决定后续动作。若只是想确认空间来源,到这里就足够;不要为了验证查询结果而直接执行 prune。

现象建议判断
总量很大,但可回收量很小先检查是否有在用或共享记录,不要按总量盲删。
指定 builder 与默认结果差异明显保留 --builder 参数,分别记录节点上下文。
输出太长优先用 until、type 或 description 过滤,再用模板输出。

常见疑问

docker buildx du 会删除缓存吗?不会。它只读取选定 builder 的磁盘使用记录;删除动作属于 docker buildx prune,两者应当分开操作。

为什么同一条记录有两个星号含义?ID 后的星号表示 mutable,SIZE 后的星号表示 shared。前者说明记录可能继续变化,后者说明存储可能被其它资源共享。

什么时候应该使用 --format=json?当需要把每条记录交给脚本或报表处理时使用。它输出换行分隔的 JSON 记录,仍然是查询结果,不代表已经执行清理。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>