4. ExternalDNS 核心原理

ExternalDNS 是一个 Kubernetes 原生的附加组件，它通过监听集群内 Service、Ingress 等资源的变化，自动同步 DNS 记录到外部的 DNS 提供商。理解其核心工作机制——DNS Provider、Source、Owner 和 TTL——是构建可靠多集群 DNS 流水线的基础。

4.1 整体工作流程

ExternalDNS 以循环控制器的模式运行，其核心流程可概括为以下步骤：

1. 列举 Sources： 从 Kubernetes API 中获取所有匹配的 Ingress、Service（类型为 LoadBalancer 或 NodePort）等资源。
2. 提取端点： 从这些资源中提取出 DNS 名称和目标 IP 地址（或 Hostname），形成 Endpoints 列表。
3. 查询当前 DNS 记录： 调用 DNS Provider 的 API，获取当前托管区中已有的记录。
4. 差异计算与调和： 对比期望的 Endpoints 与实际的 DNS 记录，生成创建、更新或删除的操作计划。
5. 执行变更： 通过 DNS Provider 的 API 执行操作计划，并应用 Owner 标签和 TTL 设置。

4.2 DNS Provider：与外部 DNS 服务的桥梁

DNS Provider 是 ExternalDNS 与外部 DNS 服务交互的适配层。它封装了不同 DNS 服务商的 API 差异，提供统一的接口用于 DNS 记录的增删改查。

4.3 Source：DNS 记录的来源

Source 定义了 ExternalDNS 从哪些 Kubernetes 资源中提取 DNS 端点信息。常见的 Source 类型包括：

• Ingress： 从 Ingress 资源的 spec.rules.host 字段提取域名，从 status.loadBalancer.ingress 提取目标 IP 或 Hostname。
• Service： 从类型为 LoadBalancer 或 NodePort 的 Service 中提取 DNS 名称（通过 annotation external-dns.alpha.kubernetes.io/hostname 指定）和负载均衡器 IP。
• Gateway API： 支持 Kubernetes Gateway API 资源（如 HTTPRoute），适用于更复杂的流量管理场景。
• CRD Source： 允许用户自定义资源作为 DNS 记录的来源，适用于特殊业务需求。

# 示例：通过 Service annotation 指定 DNS 名称
apiVersion: v1
kind: Service
metadata:
  name: my-app
  annotations:
    external-dns.alpha.kubernetes.io/hostname: "app.example.com."
spec:
  type: LoadBalancer
  ports:
  - port: 80
    targetPort: 8080

4.4 Owner：防止 DNS 记录冲突的标识机制

Owner 是 ExternalDNS 实现“谁创建、谁管理、谁删除”的核心机制。它通过在 DNS 记录中写入一个唯一的标识（通常使用 TXT 记录），来标记该记录由哪个 ExternalDNS 实例管理。

Owner 的工作原理：

1. 当 ExternalDNS 创建一条 DNS 记录（如 app.example.com）时，它会同时创建一条同名的 TXT 记录（如 app.example.com），其值包含 Owner ID。
2. 在后续的调和循环中，ExternalDNS 会检查 TXT 记录中的 Owner ID 是否与自身配置的 --owner-id 匹配。
3. 如果匹配，则允许修改或删除该记录；如果不匹配，则跳过该记录，避免误操作。

4.5 TTL：DNS 记录的缓存时间控制

TTL（Time To Live）决定了 DNS 记录在客户端和递归解析器中的缓存时长。合理的 TTL 设置可以在“更新及时性”和“查询性能”之间取得平衡。

ExternalDNS 中的 TTL 配置方式：

• 全局默认 TTL： 通过启动参数 --default-ttl 设置，例如 --default-ttl=300。
• 按资源覆盖： 通过 annotation external-dns.alpha.kubernetes.io/ttl 为特定 Ingress 或 Service 设置独立的 TTL。

# 示例：为特定 Ingress 设置 TTL 为 60 秒
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: canary-ingress
  annotations:
    external-dns.alpha.kubernetes.io/ttl: "60"
spec:
  rules:
  - host: canary.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: canary-service
            port:
              number: 80

4.6 四大核心机制的关系总结

下表总结了 DNS Provider、Source、Owner 和 TTL 在 ExternalDNS 中的角色与相互关系：