| 文档编号 | 维护人 | 内容 | 版本号 |
|---|
| 2026111721 | corin | K3s 镜像垃圾回收导致缺失镜像的恢复方法 | V2.0 |
问题现象:#
日常使用、重启或升级过程中,司空服务不可用,多个 Pod 无法拉取镜像。原案例正常环境约有 400 条镜像记录。实际数量随版本、组件及镜像标签变化,仅凭数量不能判断镜像是否完整。问题原因:#
本案例中,磁盘空间不足触发 K3s/Kubelet 的镜像垃圾回收,部分本地镜像被清理;随后工作负载需要这些镜像时,无法重新获取,导致多个 Pod 异常。解决方法1:通过对应版本的安装包检查并恢复镜像#
1. 检查磁盘空间#
先处理导致空间不足的问题,为镜像恢复预留足够空间,避免恢复后再次触发清理:2. 进入安装包目录并恢复镜像#
在镜像缺失节点上,进入与当前部署版本匹配的完整安装包目录。以下路径为原案例示例,需按实际位置替换:原案例使用该命令检查并修复缺失镜像。linux/amd64 对应原案例的平台,其他架构应以当前安装包和安装器实际支持的平台为准。3. 验证恢复结果#
确认相关 Pod 不再持续报镜像拉取失败,服务恢复可用。若仍异常,继续结合对应 Pod 事件和镜像检查结果排查。修改于 2026-11-17 03:22:05