Skip to content

模板商店与官方模板排障

本页用于处理“模板商店能打开,但官方模板状态看起来不对、安装后不可用、商店与模板页认知不一致”的问题。

典型症状:

  • 模板商店里看不到目标官方模板
  • 明明装过模板,但商店仍显示未安装
  • 点击安装后长期转圈、超时或没有结果
  • 官方模板已 READY,但部分节点就是拉不起实例
  • 商店提示“可更新”,但不确定是否影响当前业务

先做 3 分钟分层

建议按这个顺序判断:

  1. 先看模板商店卡片状态
  2. 再看模板详情状态
  3. 再看 可观测性(Observability) 中的失败模板与 API 连通性
  4. 最后看节点本地模板与副本分布

场景一:商店里看不到官方模板

优先判断:

  • 是搜索/筛选条件问题,还是管理面数据异常
  • Dashboard 当前是否正常访问管理 API

建议联动:

场景二:显示未安装,但我记得已经装过

模板商店通常只把 READY 模板视为“已安装”。

这意味着:

  • 还在 BUILDING 的模板,不一定会显示为已安装
  • 构建失败的模板,也不会被算作可用安装

此时建议直接跳到:

场景三:点击安装后长期没有结果

优先判断:

  1. Dashboard 操作接口是否正常
  2. 模板是否进入 BUILDING / FAILED
  3. 是否存在管理 API 连通性问题

建议联动:

场景四:模板 READY,但节点表现不一致

如果商店显示已安装,模板页也已 READY,但某些节点仍然不能起实例,重点看:

  • 副本是否已完整分发
  • 节点页是否存在 Local Templates
  • 是否只有个别节点异常

建议联动:

场景五:提示“可更新”,但不确定要不要动

“可更新”更像版本漂移提醒,不等于你必须立即更新。

建议先判断:

  • 当前业务是否正常
  • 是否正处在维护窗口
  • 是否需要先在测试环境验证新模板

更系统的判断方法可继续看:

相关文档