如何在Kubernetes KinD集群配置文件中添加自定义DNS主机记录？

问题背景 #

使用私有Docker Registry（地址docker-registry）时，KinD集群无法解析该地址，导致私有镜像拉取失败。目前只能手动给每个集群节点添加hosts记录：

docker exec my-cluster-control-plane bash -c "echo '10.5.0.6    docker-registry' >> /etc/hosts"
docker exec my-cluster-worker bash -c "echo '10.5.0.6    docker-registry' >> /etc/hosts"

希望通过KinD的集群配置YAML文件自动完成这个操作，当前配置文件如下：

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
containerdConfigPatches:
- |-
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker-registry:5000"]
    endpoint = ["http://docker-registry:5000"]
nodes:
- role: control-plane
  kubeadmConfigPatches:
  - |
    kind: InitConfiguration
    nodeRegistration:
      kubeletExtraArgs:
        node-labels: "ingress-ready=true"
  extraPortMappings:
  - containerPort: 80
    hostPort: 80
    protocol: TCP
  - containerPort: 443
    hostPort: 443
    protocol: TCP
- role: worker

解决方案 #

方法1：通过KinD配置自动写入节点hosts #

利用KinD的kubeadmConfigPatches添加preKubeadmCommands，在节点初始化/加入前自动写入hosts记录，替代手动操作。修改后的配置文件如下：

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
containerdConfigPatches:
- |-
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker-registry:5000"]
    endpoint = ["http://docker-registry:5000"]
nodes:
- role: control-plane
  kubeadmConfigPatches:
  - |
    kind: InitConfiguration
    nodeRegistration:
      kubeletExtraArgs:
        node-labels: "ingress-ready=true"
    preKubeadmCommands:
    - echo '10.5.0.6    docker-registry' >> /etc/hosts
  extraPortMappings:
  - containerPort: 80
    hostPort: 80
    protocol: TCP
  - containerPort: 443
    hostPort: 443
    protocol: TCP
- role: worker
  kubeadmConfigPatches:
  - |
    kind: JoinConfiguration
    nodeRegistration:
      kubeletExtraArgs:
        node-labels: "worker=true"
    preKubeadmCommands:
    - echo '10.5.0.6    docker-registry' >> /etc/hosts

• 控制平面节点用InitConfiguration，worker节点用JoinConfiguration，两者都通过preKubeadmCommands执行写入hosts的命令。
• 集群创建时会自动完成所有节点的hosts配置，无需手动执行docker exec。

方法2：挂载自定义hosts文件到节点 #

如果需要更复杂的hosts配置，可本地创建包含自定义记录的hosts文件，通过extraMounts挂载到节点：

1. 本地创建custom-hosts文件，需保留节点原hosts的必要系统条目（比如127.0.0.1 localhost），再添加自定义记录：

127.0.0.1 localhost
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
10.5.0.6    docker-registry

2. 修改KinD配置文件，给每个节点添加extraMounts：

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
containerdConfigPatches:
- |-
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker-registry:5000"]
    endpoint = ["http://docker-registry:5000"]
nodes:
- role: control-plane
  kubeadmConfigPatches:
  - |
    kind: InitConfiguration
    nodeRegistration:
      kubeletExtraArgs:
        node-labels: "ingress-ready=true"
  extraPortMappings:
  - containerPort: 80
    hostPort: 80
    protocol: TCP
  - containerPort: 443
    hostPort: 443
    protocol: TCP
  extraMounts:
  - hostPath: ./custom-hosts
    containerPath: /etc/hosts
    readOnly: true
- role: worker
  extraMounts:
  - hostPath: ./custom-hosts
    containerPath: /etc/hosts
    readOnly: true

注意：这种方式会覆盖节点原hosts文件，必须确保自定义文件包含所有必要的系统条目。

方法3：配置CoreDNS实现集群内Pod解析 #

如果只需要Pod内部能解析docker-registry，可以修改CoreDNS的ConfigMap添加自定义记录：

kubectl edit configmap coredns -n kube-system

在Corefile的hosts块中添加你的记录：

hosts {
    10.5.0.6 docker-registry
    fallthrough
}

保存后CoreDNS会自动重载配置，Pod就能通过CoreDNS解析该地址。但此方式仅对Pod生效，节点本身（比如containerd拉取镜像）仍需节点hosts配置，因此镜像拉取问题优先使用前两种方法。

内容的提问来源于stack exchange，提问作者Jayser