Kubernetes External-DNS 多域名路由配置问题解析

问题背景

在使用 Kubernetes External-DNS 与 AWS ALB Ingress Controller 配合时，用户遇到了一个常见但棘手的问题：当尝试为单个负载均衡器配置多个域名时，External-DNS 无法正确更新 Route53 中的 DNS 记录。这个问题尤其影响那些需要在同一 ALB 下托管多个域名的场景。

问题表现

用户报告的主要症状包括：

1. 在 Ingress 资源中定义多个 host 规则时，External-DNS 没有任何更新操作
2. External-DNS Pod 日志仅显示"All records are already up to date"信息，没有实际的变更操作
3. 尝试了两种配置方式都未成功：
   • 单个 Ingress 文件定义多个 host
   • 多个 Ingress 文件分别定义不同的 host

技术分析

配置方式一：单Ingress多域名

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    external-dns.alpha.kubernetes.io/hostname: first-private.domain.com,second-private.domain.com
    external-dns.alpha.kubernetes.io/alias: "true"
spec:
  ingressClassName: alb
  rules:
    - host: first-private.domain.com
    - host: second-private.domain.com

这种配置方式的问题在于：

1. External-DNS 可能无法正确处理逗号分隔的多个 hostname 值
2. 缺少必要的路径和后端服务定义，导致 Ingress 配置不完整

配置方式二：多Ingress单域名

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:eu-central-1:123456789:certificate/ID
    alb.ingress.kubernetes.io/group.name: ingress1
    external-dns.alpha.kubernetes.io/alias: "true"
    external-dns.alpha.kubernetes.io/hostname: private.domain.com
spec:
  ingressClassName: alb
  rules:
    - host: private.domain.com
      http:
        paths:
          - path: /*
            pathType: ImplementationSpecific
            backend:
              service:
                name: private-app
                port:
                  number: 80

这种配置方式相对更规范，但需要注意：

1. 必须为每个 Ingress 指定相同的 alb.ingress.kubernetes.io/group.name 注解
2. 每个 Ingress 需要完整定义路径和后端服务

解决方案

经过实践验证，以下配置方式可以解决多域名路由问题：

1. 为每个域名创建单独的 Ingress 资源
2. 在所有相关 Ingress 上设置相同的 ALB 组名注解
3. 确保每个 Ingress 都有完整的规则定义

示例配置：

# ingress-domain1.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: domain1-ingress
  annotations:
    alb.ingress.kubernetes.io/group.name: my-alb-group
    external-dns.alpha.kubernetes.io/hostname: domain1.example.com
    external-dns.alpha.kubernetes.io/alias: "true"
spec:
  ingressClassName: alb
  rules:
  - host: domain1.example.com
    http:
      paths:
      - path: /*
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-service
            port:
              number: 80

# ingress-domain2.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: domain2-ingress
  annotations:
    alb.ingress.kubernetes.io/group.name: my-alb-group
    external-dns.alpha.kubernetes.io/hostname: domain2.example.com
    external-dns.alpha.kubernetes.io/alias: "true"
spec:
  ingressClassName: alb
  rules:
  - host: domain2.example.com
    http:
      paths:
      - path: /*
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-service
            port:
              number: 80

最佳实践建议

1. 明确hostname注解：每个 Ingress 应该只包含一个明确的 hostname 注解，避免使用逗号分隔的多个值

2. 完整定义规则：确保每个 host 规则都有完整的路径和后端服务定义

3. 使用ALB组：通过 alb.ingress.kubernetes.io/group.name 确保多个 Ingress 共享同一个 ALB

4. 日志监控：检查 External-DNS Pod 日志时，注意是否有过滤信息，如"Applying provider record filter for domains"

5. 版本兼容性：确认使用的 External-DNS 版本是否支持多域名场景

总结

Kubernetes External-DNS 在处理多域名路由时确实存在一些配置上的复杂性，特别是与 ALB Ingress Controller 配合使用时。通过为每个域名创建单独的 Ingress 资源并正确设置 ALB 组名注解，可以可靠地实现单负载均衡器多域名的路由配置。这种配置方式不仅解决了 DNS 记录更新的问题，还保持了配置的清晰性和可维护性。