模板分发与副本一致性排障
本页用于处理“模板已经构建完成或接近可用,但副本覆盖、节点本地状态和模板详情显示不一致”的问题。
典型症状:
- 模板已经
READY,但分发长期停在0/N或小于预期 - 模板页显示可用,但部分节点始终没有
Local Templates - 某些节点能起沙箱,另一些节点总失败
- 重建后任务 ID 变了,但副本覆盖仍异常
先区分:这是构建失败还是分发不一致
如果模板长期 BUILDING 或直接 FAILED,优先看:
如果模板已经 READY,但节点分布和实例行为不一致,则更适合看本页。
一致性应该看什么
建议同时对照两个视角:
模板详情视角
重点关注:
- 模板状态
- 副本分布
- 最近一次任务 ID
- 各节点副本状态是否一致
节点详情视角
重点关注:
Local Templates- 当前节点是否已注册
- 节点资源是否足够
- 节点是否存在异常 Conditions
高频症状与判断建议
症状一:模板 READY,但分发长期不完整
常见原因:
- 节点未正常注册
- 节点资源不足
- 节点本地模板物化异常
建议联动:
症状二:节点页看不到目标模板
常见原因:
- 控制面已记录模板,但节点侧未同步完成
- 节点健康状态抖动
- 模板副本只分发到部分节点
建议先看节点详情,再看服务日志。
症状三:部分节点能起实例,部分节点总失败
优先判断:
- 是否只有某个节点异常
- 该节点是否缺少本地模板副本
- 该节点是否资源紧张或注册异常
推荐排障顺序(副本一致性问题)
- 先确认管理面健康
- 再看模板详情中的副本分布
- 再看节点详情里的
Local Templates - 再看节点注册、资源和日志
- 最后再决定是否重建模板
什么时候该重建模板
更适合重建的情况:
- 构建链路已经恢复,但副本状态明显漂移
- 最近一次任务长期没有推进
- 节点问题已经排除,但模板分发仍异常