Kube-Hetzner项目中DNS服务器配置问题的分析与解决方案

问题背景

在使用Kube-Hetzner项目部署Kubernetes集群时，用户发现自动扩展节点（autoscaler nodes）的DNS配置存在问题。具体表现为这些节点上的/etc/resolv.conf文件中包含了超过3个DNS服务器地址，而Kubernetes系统对此有限制，最多只能支持3个DNS服务器条目。这导致集群中出现警告信息："Nameserver limits were exceeded, some nameservers have been omitted"。

技术分析

问题根源

经过深入分析，发现问题的根源在于Hetzner云平台默认提供的cloud-init配置会设置4个DNS服务器地址（2个IPv4和2个IPv6地址），而Kubernetes的DNS解析机制对DNS服务器数量有限制，最多只能处理3个。当超过这个限制时，Kubernetes会自动忽略多余的DNS服务器，可能导致某些情况下的DNS解析问题。

影响范围

这一问题主要影响：

1. 自动扩展节点（autoscaler nodes）
2. 新创建的节点
3. 使用默认cloud-init配置的节点

相比之下，手动配置的工作节点（worker nodes）通常不会出现这个问题，因为它们的DNS配置已经被正确限制在3个服务器地址。

解决方案

方案一：修改cloud-init配置

最彻底的解决方案是通过修改cloud-init配置来限制DNS服务器数量。具体实现方式有两种：

1. 使用resolv-conf模块： 在cloud-init配置中添加以下内容：

   manage_resolv_conf: true
   resolv_conf:
     nameservers:
       - 185.12.64.1
       - 185.12.64.2
       - 2a01:4ff:ff00::add:1
   

   这种方法直接控制/etc/resolv.conf文件的内容，简单有效。

2. 使用networking-conf选项： 通过cloud-init的network-config功能来配置DNS，这种方法更加规范，但实现起来相对复杂，需要处理更多网络相关配置。

方案二：后处理脚本

如果暂时无法修改cloud-init配置，可以使用后处理脚本来修正DNS配置。在节点创建后执行以下命令：

sed -i "/2a01:4ff:ff00::add:2/d" /etc/netplan/50-cloud-init.yaml
netplan apply

这种方法通过删除一个IPv6 DNS服务器地址来满足Kubernetes的限制要求。

实施建议

对于生产环境，建议采用第一种方案中的resolv-conf模块方法，因为：

1. 它是预防性的解决方案，在节点初始化阶段就正确配置DNS
2. 不需要额外的后处理步骤
3. 更加可靠和可维护

实施步骤：

1. 修改Kube-Hetzner项目的cloud-init模板
2. 确保新创建的节点使用修改后的配置
3. 考虑重建现有的自动扩展节点以应用新配置

验证方法

实施后，可以通过以下方式验证解决方案是否生效：

1. 检查新创建节点的/etc/resolv.conf文件，确认只有3个nameserver条目
2. 观察Kubernetes事件日志，确认不再出现"Nameserver limits were exceeded"警告
3. 测试集群内外的DNS解析功能是否正常工作

总结

Kube-Hetzner项目中DNS服务器数量限制问题看似简单，但实际上反映了云平台默认配置与Kubernetes系统要求之间的微妙差异。通过合理配置cloud-init，我们可以确保集群中的所有节点都符合Kubernetes的DNS服务器数量限制，从而避免潜在的DNS解析问题。这一解决方案不仅适用于当前报告的问题，也为处理类似的基础设施配置问题提供了参考模式。