Skip to content

模板分发与副本一致性排障

本页用于处理“模板已经构建完成或接近可用,但副本覆盖、节点本地状态和模板详情显示不一致”的问题。

典型症状:

  • 模板已经 READY,但分发长期停在 0/N 或小于预期
  • 模板页显示可用,但部分节点始终没有 Local Templates
  • 某些节点能起沙箱,另一些节点总失败
  • 重建后任务 ID 变了,但副本覆盖仍异常

先区分:这是构建失败还是分发不一致

如果模板长期 BUILDING 或直接 FAILED,优先看:

如果模板已经 READY,但节点分布和实例行为不一致,则更适合看本页。

一致性应该看什么

建议同时对照两个视角:

模板详情视角

重点关注:

  • 模板状态
  • 副本分布
  • 最近一次任务 ID
  • 各节点副本状态是否一致

节点详情视角

重点关注:

  • Local Templates
  • 当前节点是否已注册
  • 节点资源是否足够
  • 节点是否存在异常 Conditions

高频症状与判断建议

症状一:模板 READY,但分发长期不完整

常见原因:

  • 节点未正常注册
  • 节点资源不足
  • 节点本地模板物化异常

建议联动:

症状二:节点页看不到目标模板

常见原因:

  • 控制面已记录模板,但节点侧未同步完成
  • 节点健康状态抖动
  • 模板副本只分发到部分节点

建议先看节点详情,再看服务日志。

症状三:部分节点能起实例,部分节点总失败

优先判断:

  1. 是否只有某个节点异常
  2. 该节点是否缺少本地模板副本
  3. 该节点是否资源紧张或注册异常

推荐排障顺序(副本一致性问题)

  1. 先确认管理面健康
  2. 再看模板详情中的副本分布
  3. 再看节点详情里的 Local Templates
  4. 再看节点注册、资源和日志
  5. 最后再决定是否重建模板

什么时候该重建模板

更适合重建的情况:

  • 构建链路已经恢复,但副本状态明显漂移
  • 最近一次任务长期没有推进
  • 节点问题已经排除,但模板分发仍异常

相关文档