AKS中Web应用路由插件内部IngressController的DNS记录创建问题解析
【免费下载链接】AKS Azure Kubernetes Service 
项目地址: https://gitcode.com/gh_mirrors/ak/AKS
问题背景
在Azure Kubernetes Service(AKS)环境中使用Web应用路由插件时，当配置为使用内部IngressController时，发现未能自动在指定的私有DNS区域中创建相应的DNS记录。这是一个常见但容易被忽视的配置问题，特别是在AKS版本更新后，某些默认行为发生了变化。
问题现象
用户在AKS集群中部署了Web应用路由插件，并配置了以下关键参数：
- 启用了内部IngressController(defaultIngressControllerType设置为Internal)
- 指定了私有DNS区域资源ID
- 为Web应用路由使用的托管身份分配了"Private DNS Zone Contributor"角色
- 创建了VNet并建立了与私有DNS区域的链接
尽管所有基础架构配置看似正确，但在创建Ingress资源后，预期的DNS记录并未出现在指定的私有DNS区域中。
根本原因分析
经过深入排查，发现问题根源在于Ingress资源中指定的ingressClassName与Web应用路由插件实际创建的IngressClass名称不匹配。在AKS API版本2024-06-02-preview中，Web应用路由插件创建的IngressClass名称已变更为"webapprouting.kubernetes.azure.com"，而非用户预期的"nginx-internal"。
解决方案
要解决此问题，需要确保Ingress资源中正确指定了ingressClassName。具体步骤如下：
- 首先确认集群中实际存在的IngressClass：
kubectl get ingressClass
- 根据输出结果，修改Ingress资源定义，确保ingressClassName字段与Web应用路由插件创建的IngressClass名称一致：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: aks-helloworld
namespace: hello-web-app-routing
spec:
ingressClassName: webapprouting.kubernetes.azure.com # 修改为正确的IngressClass名称
rules:
- host: hello.lab.com
http:
paths:
- backend:
service:
name: aks-helloworld
port:
number: 80
path: /
pathType: Prefix
技术原理
Web应用路由插件在AKS中的工作流程如下：
- 插件部署时会自动创建IngressController和对应的IngressClass资源
- 当创建Ingress资源时，控制器会根据ingressClassName匹配对应的IngressClass
- 匹配成功后，控制器会为Ingress分配IP地址
- 最后，控制器会在指定的私有DNS区域中创建相应的DNS记录
在较新版本的AKS中，Web应用路由插件创建的IngressClass名称已标准化为"webapprouting.kubernetes.azure.com"，这一变化旨在提供更一致的命名规范，但可能导致从旧版本升级的用户遇到兼容性问题。
最佳实践建议
-
版本兼容性检查：在升级AKS集群或API版本时，务必查阅相关变更日志，了解IngressClass命名等关键配置的变化。
-
自动化验证：在CI/CD流水线中添加验证步骤，确保Ingress资源能够正确获取IP地址并创建DNS记录。
-
监控配置：设置监控告警，及时发现未能正确获取IP地址的Ingress资源。
-
文档同步更新：团队内部维护的部署文档应及时更新，反映最新的配置要求。
总结
AKS Web应用路由插件的内部IngressController DNS记录创建问题通常源于IngressClass名称配置不当。通过理解插件的工作原理和版本变更带来的影响，运维人员可以快速定位并解决此类问题。随着AKS功能的不断演进，保持对最新文档和最佳实践的关注，是确保集群稳定运行的关键。
【免费下载链接】AKS Azure Kubernetes Service 项目地址: https://gitcode.com/gh_mirrors/ak/AKS
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
