容器与云原生 / 系统课时
怎样建立定期资源清理流程
怎样建立定期资源清理流程
长期运行的 Docker 主机会逐渐积累停止容器、悬空镜像、构建缓存和持续增长的日志。稳定的清理流程不应依赖临时执行一条 prune 命令,而要先监控占用,再按保留策略清理,最后验证业务和磁盘结果。
学习目标
- 用固定顺序检查 Docker 磁盘占用并识别主要来源
- 为容器、镜像、构建缓存和日志设置不同的保留策略
- 把清理动作做成可审计、可回滚风险较低的周期流程
先把清理拆成固定流程
定期清理可以分成“检查、判断、清理、验证”四段。检查阶段记录主机磁盘和 Docker 占用;判断阶段依据保留时间与业务状态决定哪些资源可删;清理阶段只执行明确允许的动作;验证阶段再次查看空间并确认关键容器正常。

这套顺序的关键是先有证据再删除。若磁盘增长来自应用自己的绑定目录,单纯清理镜像不会解决问题;若增长来自容器日志,也不应靠删除镜像腾空间。
用基线命令记录占用
docker system df 能查看镜像、容器、本地 Volume 和构建缓存的大致占用。配合系统磁盘检查,可以快速判断问题属于 Docker 资源还是宿主机其他目录。
df -h /
docker system df预期输出
Filesystem Size Used Avail Use% Mounted on
<DEVICE> <SIZE> <USED> <AVAIL> <PERCENT> /
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images <N> <N> <SIZE> <SIZE>
Containers <N> <N> <SIZE> <SIZE>
Local Volumes <N> <N> <SIZE> <SIZE>
Build Cache <N> <N> <SIZE> <SIZE><SIZE>、<N> 和 <PERCENT> 都是动态值。定期任务应保存这些结果,便于判断本次清理到底回收了多少空间,而不是只看命令是否执行成功。
给不同资源不同保留策略
停止容器通常可以按时间清理,例如只删除已经停止超过 7 天的容器;悬空镜像可以定期清理;构建缓存可设置更长保留期。命名 Volume 不应放进默认自动清理,因为它可能保存脱离容器生命周期的重要数据。
下面是一份偏保守的清理脚本:不删除正在运行的容器、不执行 docker image prune -a,也不自动删除 Volume。
set -euo pipefail
echo "=== before ==="
docker system df
docker container prune -f --filter "until=168h"
docker image prune -f
docker builder prune -f --filter "until=720h"
echo "=== after ==="
docker system df预期输出
=== before ===
<DOCKER-USAGE-REPORT>
<CLEANUP-OUTPUT>
=== after ===
<DOCKER-USAGE-REPORT><CLEANUP-OUTPUT> 的内容和回收量会随主机资源变化,可能显示删除明细,也可能只显示回收空间为 0。第一次上线自动任务前,应先手工执行并确认筛选条件符合主机上的部署习惯。
日志增长要靠轮转而不是事后删除
Docker 默认的 json-file 日志如果不设置上限,长期运行可能持续增长。可以在 Docker daemon 配置中设置单文件大小和保留文件数。下面是片段示例,依赖宿主机已有 /etc/docker/daemon.json;合并时不要覆盖其他现有配置。
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}生效行为:重启 Docker daemon 后,新创建的容器会使用该默认日志轮转策略;已有容器通常需要重新创建才能采用新的日志配置。验证时可检查新容器的日志驱动配置,并观察日志文件不会无限增长。
把任务放进周期调度
可以用 cron、systemd timer 或企业调度平台周期执行脚本。频率取决于磁盘增长速度:构建机可能每天检查,普通业务主机可以每周执行清理、每天采集占用。定时任务至少应记录执行时间、清理前后占用、退出状态和错误输出。
下面是 crontab 片段示例,依赖前面的清理脚本已保存为 /usr/local/sbin/docker-cleanup.sh 且具备执行权限。它会在每周日 03:00 执行,并把输出追加到日志文件。
0 3 * * 0 /usr/local/sbin/docker-cleanup.sh >> /var/log/docker-cleanup.log 2>&1生效后可在下一次计划执行后检查 /var/log/docker-cleanup.log,确认存在清理前后的占用记录且脚本没有报错。生产环境还应接入现有监控或告警系统,避免定时任务失败后长期无人发现。
自动化之后仍要保留人工审查入口。当磁盘增长异常、Volume 占用突然变大、镜像回收量长期为零或清理后关键容器异常时,应停止继续扩大清理范围,先定位资源来源。一个成熟流程的目标不是“删得多”,而是持续把磁盘占用控制在可预测范围内。