AKS hybrid在Stack HCI环境安装失败，提示配置无效需排查

• 定位并查看moc_validation_report.html报告
  报告默认存放在安装节点的C:\ProgramData\moc\logs目录下，直接打开该HTML文件，里面会明确列出所有配置校验失败的具体项（比如网络冲突、存储异常、节点资源不足、Azure权限缺失等），这是排查的核心依据。

• 针对常见配置无效问题的修复方向

  • 网络配置类
    • 检查Stack HCI集群的虚拟网络：需启用DHCP或配置合法静态IP池，子网掩码不能小于/24，同时确保所有节点间网络连通无异常
    • 确认Kubernetes服务网段、Pod网段未与现有企业内网冲突，且网段规模匹配预期部署的工作负载数量
  • 存储配置类
    • 验证Stack HCI的Storage Spaces Direct存储卷状态正常，可用存储容量需满足AKS hybrid最低要求（至少100GB可用空间）
    • 检查自定义存储类配置，确保其支持动态PVC创建，且存储后端无故障
  • 节点资源类
    • 确认所有Stack HCI节点满足最低硬件要求：每个节点至少4核CPU、16GB内存，且预留足够资源给AKS控制平面组件
    • 清理节点上不必要的进程或服务，释放被占用的CPU、内存资源
  • Azure配置类
    • 核对用于部署的Azure AD服务主体权限，确保其拥有AKS hybrid相关资源的创建、管理权限
    • 检查订阅ID、租户ID等参数输入是否准确，无拼写或格式错误
    • 验证本地节点可正常访问Azure公共服务，排除防火墙、代理拦截导致的连通问题

• 修复后重新部署
  修正报告中所有问题项后，重新执行AKS hybrid安装命令或通过Azure Portal触发部署流程。若仍失败，查看最新生成的moc_validation_report.html，重复排查修复步骤。

内容的提问来源于stack exchange，提问作者jerfcero