Kubernetes External-DNS 在 Digital Ocean 环境下过滤 Ingress 资源的实践指南

问题背景

在 Kubernetes 集群中使用 External-DNS 自动管理 DNS 记录时，特别是在 Digital Ocean 作为 DNS 提供商的环境中，用户经常遇到需要精确控制哪些 Ingress 资源应该被 External-DNS 处理的场景。常见的情况包括：

1. 需要排除 cert-manager 创建的 ACME 挑战验证 Ingress
2. 只需要处理特定 Ingress Class 的流量入口
3. 某些特殊业务场景需要手动控制 DNS 记录创建

核心挑战

External-DNS 默认会监控集群中所有 Ingress 资源，这可能导致以下问题：

1. 与 cert-manager 自动创建的临时 Ingress 冲突
2. 产生非预期的 DNS 记录
3. 在 CNAME 和 TXT 记录共存时出现 API 错误（如 Digital Ocean 不允许 CNAME 与其他记录同名）

解决方案详解

1. 基于 Ingress Class 的过滤

External-DNS 支持通过 ingressClassFilters 参数指定只处理特定 Ingress Class 的资源。这是最直接的过滤方式：

# Helm values.yaml 配置示例
ingressClassFilters: 
  - nginx

但需要注意，某些控制器（如 cert-manager）可能使用注解而非规范的 spec.ingressClassName 字段来指定 Ingress Class，这会导致过滤不完全。

2. 基于注解的精细控制

对于更复杂的过滤需求，可以使用注解系统：

# 在需要排除的 Ingress 上添加注解
metadata:
  annotations:
    external-dns.alpha.kubernetes.io/exclude: "true"

或者通过 External-DNS 的全局注解过滤：

# Helm values.yaml 配置
annotationFilter: "cert-manager.io/cluster-issuer in (letsencrypt-staging,letsencrypt-production)"

3. 特殊场景处理技巧

对于需要完全禁用 External-DNS 处理的 Ingress，可以使用以下注解组合：

metadata:
  annotations:
    external-dns.alpha.kubernetes.io/ingress-hostname-source: annotation-only
    external-dns.alpha.kubernetes.io/hostname: ""

这种方法特别适用于：

• 临时性资源
• 测试环境
• 需要手动管理的特殊域名

最佳实践建议

1. 明确记录管理策略：在集群规划阶段就确定哪些资源应该自动管理 DNS 记录
2. 分层过滤：结合使用 Ingress Class 过滤和注解过滤
3. 监控与告警：对 External-DNS 的日志设置监控，及时发现处理异常
4. 版本兼容性检查：不同版本的 External-DNS 对过滤功能的支持可能有所差异

总结

在 Kubernetes 集群中精细控制 External-DNS 的行为需要理解其多种过滤机制的工作原理。通过合理组合 Ingress Class 过滤、注解过滤以及特殊注解技巧，可以实现对 DNS 记录管理的精确控制。特别是在 Digital Ocean 环境下，注意其 API 对记录类型的特殊限制，可以避免常见的配置错误。

对于生产环境，建议在部署前充分测试过滤规则，确保只有预期的 DNS 记录会被创建和更新，从而构建稳定可靠的云原生 DNS 管理体系。