AKS中Web应用路由插件内部IngressController的DNS记录创建问题解析

原创于 2025-06-14 09:00:38 发布 · 349 阅读

CC 4.0 BY-SA版权

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