模板商店与官方模板排障
本页用于处理“模板商店能打开,但官方模板状态看起来不对、安装后不可用、商店与模板页认知不一致”的问题。
典型症状:
- 模板商店里看不到目标官方模板
- 明明装过模板,但商店仍显示未安装
- 点击安装后长期转圈、超时或没有结果
- 官方模板已
READY,但部分节点就是拉不起实例 - 商店提示“可更新”,但不确定是否影响当前业务
先做 3 分钟分层
建议按这个顺序判断:
- 先看模板商店卡片状态
- 再看模板详情状态
- 再看 可观测性(Observability) 中的失败模板与 API 连通性
- 最后看节点本地模板与副本分布
场景一:商店里看不到官方模板
优先判断:
- 是搜索/筛选条件问题,还是管理面数据异常
- Dashboard 当前是否正常访问管理 API
建议联动:
场景二:显示未安装,但我记得已经装过
模板商店通常只把 READY 模板视为“已安装”。
这意味着:
- 还在
BUILDING的模板,不一定会显示为已安装 - 构建失败的模板,也不会被算作可用安装
此时建议直接跳到:
场景三:点击安装后长期没有结果
优先判断:
- Dashboard 操作接口是否正常
- 模板是否进入
BUILDING/FAILED - 是否存在管理 API 连通性问题
建议联动:
场景四:模板 READY,但节点表现不一致
如果商店显示已安装,模板页也已 READY,但某些节点仍然不能起实例,重点看:
- 副本是否已完整分发
- 节点页是否存在
Local Templates - 是否只有个别节点异常
建议联动:
场景五:提示“可更新”,但不确定要不要动
“可更新”更像版本漂移提醒,不等于你必须立即更新。
建议先判断:
- 当前业务是否正常
- 是否正处在维护窗口
- 是否需要先在测试环境验证新模板
更系统的判断方法可继续看: