安装故障排查

当安装程序无法继续执行、安装资源失败，或安装后验证报告映像或构件问题时，请使用此页面。

常见卡顿及查看位置

在更改环境或提交支持工单之前，先收集第二列中的信息。

症状	首先查看的位置	要查找的内容
Web UI 无法加载	安装节点上 `setup.sh` 和 `nerdctl ps` 的终端输出	`minialauda-control-plane` 容器处于 Running 状态，并且浏览器可以访问端口 `8080`。
安装程序日志停止推进	`tail -f /var/cpaas/data/installer.log`	最后完成的阶段，以及第一个重复或失败的操作。
卡在控制平面预配	非 `Ready` 机器上的 `kubectl get machines -A` 和 `kubectl describe`	`Bootstrap` 和 `Infrastructure` 条件，以及 `status.addresses` 中的节点地址。
卡在网络和 Core 附加组件	新集群上的 `kubectl -n kube-system get pods`	Kube-OVN、CoreDNS 和 kube-proxy Pod 处于 `Running` 状态；映像拉取失败通常表明存在 registry 路径问题。
AppRelease 显示 `Failed`	`kubectl describe apprelease <name> -n <namespace>`	用于标识 chart 或依赖项故障的状态条件和近期 Events。
`ClusterModule/global` 未变为健康状态	`kubectl describe clustermodule global`	用于标识阻塞 Core 或 Aligned 模块的状态条件。

症状	检查	恢复
Pod 处于 `ImagePullBackOff` 或 `ErrImagePull` 状态	运行 `kubectl describe pod <pod> -n <namespace>`，并从发生故障的节点测试配置的 registry。	修正报告的 DNS、路由、防火墙、CA 信任、拉取凭证、registry 可用性或缺少 manifest 的问题。
安装后所需的 Core 或 Aligned 原生应用不可用	检查对应的 `AppRelease`、`ModuleInfo`、`ModulePlugin` 和 Pod Events。如果仍不清楚软件包是否可用，请检查 `kubectl get productbase base -o yaml` 中的匹配条目，以及 registry 中准确的 `repository:tag`。	如果 registry 确认缺少所需的 manifest，请上传匹配的安装版本软件包。对于授权、CA、DNS、路由或连接错误，请修正报告的 registry 问题，而不是重新发布软件包。忽略可选或未安装 catalog 软件包的无关 `Absent` 条目。
已恢复或替换的节点无法拉取已安装版本的映像	检查发生故障的 Pod 和 registry 保留记录。	恢复引用的 digest，然后在重试恢复之前修正 registry 可用性、备份或保留策略。

对于在安装程序启动前发生的上传命令失败，请使用External Platform Image Registry Troubleshooting。

安装程序通常会在安装完成后自动删除自身。如果安装完成 30 分钟后安装程序容器仍然存在，请在安装节点上运行以下命令：

nerdctl rm -f minialauda-control-plane

收集 /var/cpaas/data/installer.log、相关的 kubectl describe 输出、失败资源的状况，以及准确的 Core Package 版本和架构。请勿包含 registry 密码或 Secret 内容。