External-DNS在AWS Route53中管理多域名Ingress的实践与问题分析

背景介绍

在Kubernetes集群中使用External-DNS组件时，用户经常需要通过单个负载均衡器管理多个域名。External-DNS作为Kubernetes生态中重要的DNS自动化管理工具，能够自动将Ingress资源中定义的域名同步到云服务商的DNS服务中。但在实际使用过程中，特别是与AWS ALB Ingress Controller配合时，多域名场景下的DNS记录同步可能会出现预期之外的行为。

问题现象

用户在AWS环境中部署了v0.14.1版本的External-DNS，并配置了Route53作为DNS提供商。当尝试通过单个Ingress资源定义多个域名时，发现External-DNS未能按预期在Route53中创建相应的别名记录。查看External-DNS日志仅显示"All records are already up to date"信息，没有实际的DNS更新操作。

技术分析

典型配置模式

用户最初尝试了两种配置方式：

1. 单Ingress多Host模式：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    external-dns.alpha.kubernetes.io/hostname: domain1.example.com,domain2.example.com
    external-dns.alpha.kubernetes.io/alias: "true"
spec:
  rules:
    - host: domain1.example.com
    - host: domain2.example.com

2. 多Ingress共享ALB模式：

# Ingress 1
metadata:
  annotations:
    alb.ingress.kubernetes.io/group.name: shared-alb
    external-dns.alpha.kubernetes.io/hostname: domain1.example.com

# Ingress 2
metadata:
  annotations:
    alb.ingress.kubernetes.io/group.name: shared-alb  
    external-dns.alpha.kubernetes.io/hostname: domain2.example.com

问题根源

经过实践验证，发现以下关键点：

1. External-DNS对多域名hostname注解的支持存在限制，逗号分隔的多域名格式可能无法被正确解析
2. 当使用ALB Ingress Controller时，需要确保所有共享同一ALB的Ingress资源都配置了相同的group.name注解
3. 需要明确指定external-dns.alpha.kubernetes.io/ingress-hostname-source: defined-hosts-only注解来确保只同步明确指定的域名

解决方案

推荐实践方案

1. 为每个域名创建独立的Ingress资源
2. 使用统一的ALB组名：通过alb.ingress.kubernetes.io/group.name确保所有Ingress共享同一个ALB
3. 明确指定hostname来源：添加external-dns.alpha.kubernetes.io/ingress-hostname-source注解

完整示例配置

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

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

进阶建议

1. 版本兼容性：建议使用较新版本的External-DNS，新版本对多域名场景的支持更加完善
2. 日志调试：可通过提高External-DNS日志级别来获取更详细的调试信息
3. IAM权限：确保External-DNS使用的IAM角色有足够的Route53权限
4. 同步间隔：了解External-DNS的同步机制，默认同步间隔为1分钟，重要变更可能需要等待

通过以上实践，可以确保External-DNS在AWS环境中正确管理多个域名与单个ALB的映射关系，实现高效的DNS自动化管理。