Higress 2.0.2 在 ACK 1.30.1 集群中部署问题分析

在 Kubernetes 集群中部署 Higress 2.0.2 版本时，用户可能会遇到控制器无法就绪的问题。本文将深入分析这一问题的原因，并提供解决方案。

问题现象

当在 ACK 1.30.1 版本的 Kubernetes 集群中部署 Higress 2.0.2 时，主要会出现以下两个问题：

1. Gateway 组件启动失败，报错显示无法找到名为 "higress-ca-root-cert" 的 ConfigMap
2. Controller 组件健康检查失败，日志中显示无法找到 GRPCRoute 资源

根本原因分析

经过深入分析，这些问题主要由以下因素导致：

1. ConfigMap 缺失问题：Higress 部署时需要一个名为 "higress-ca-root-cert" 的 ConfigMap 作为证书存储，但 Helm Chart 中可能没有正确创建这个资源。

2. Gateway API 兼容性问题：Higress 2.0.2 控制器默认会监听 Gateway API 资源，包括 GRPCRoute。但在某些 Kubernetes 版本中，这些 CRD 可能未被安装或版本不兼容。

3. 参数配置问题：当前版本的 Helm Chart 中，global.enableGatewayAPI 参数实际上并未生效，导致即使显式设置为 false，控制器仍会尝试监听 Gateway API 资源。

解决方案

针对上述问题，可以采取以下解决方案：

1. 手动创建缺失的 ConfigMap： 执行以下命令创建所需的 ConfigMap：

   kubectl create configmap higress-ca-root-cert -n higress-system
   

2. 临时解决方案 - 修改部署配置： 在 Helm values 文件中添加以下配置：

   controller:
     args:
       - --enable-gateway-api=false
   

   这将显式禁用 Gateway API 功能。

3. 等待官方修复： 开发团队已经确认将在本周修复 global.enableGatewayAPI 参数无效的问题。建议关注官方更新。

最佳实践建议

1. 在生产环境部署前，建议先在测试环境验证 Higress 与 Kubernetes 版本的兼容性。
2. 部署时仔细检查 Helm values 配置，确保所有必需参数正确设置。
3. 关注 Higress 官方文档和更新日志，及时获取最新修复信息。

总结

Higress 作为阿里巴巴开源的云原生网关，在 Kubernetes 环境中部署时需要注意版本兼容性和配置细节。本文分析的问题主要源于 Gateway API 功能的默认开启和配置参数未生效，通过适当的配置调整可以解决这些问题。随着项目的持续发展，这些兼容性问题预计将得到更好的解决。