记录工作中k8s的域名映射问题

目录

一、问题说明

二、相关命令

三、配置文件示例

四、配置项说明

1、lameduck 5s

2、CoreDNS Kubernetes

3、hosts配置

4、forward

 五、修改配置文件

1、获取当前配置

2、修改配置

3、应用修改

4、回滚

---

一、问题说明

1、问题说明：新写的springboot项目集成kafka,配置文件中配置地址为ip地址，网络已经开通过，项目启动后报无法解析的域名。本地hosts文件中配置了域名映射启动成功。测试环境因为一开始看另外一个对接kafka服务的项目服务器hosts没有配置域名映射可以正常使用，新项目所在服务器却不可以。

2、原因：另外一个项目服务器采用k8s部署，k8s中coredns的配置文件中配置了hosts.

因为测试环境项目是docker镜像在k8s中部署，所以配置映射的时候如果在宿主机的hosts文件中配置映射是无法解决问题的

记录下相关的配置

二、相关命令

1、查看k8s中dns服务是否启动
kubectl get pods -n kube-system -l k8s-app=kube-dns
2、查看dns服务状态
kubectl get svc -n kube-system -l k8s-app=kube-dns
3、检查dns服务端点
kubectl get endpoints -n kube-system -l k8s-app=kube-dns
4、获取coredns的配置
kubectl get configmap coredns -n kube-system -o yaml

三、配置文件示例

apiVersion: v1
kind: ConfigMap
metadata:
  #名称
  name: coredns
  #所在的k8s命名空间
  namespace: kube-system
data:
  Corefile: |
    # 全局配置
    .:53 {
        # 基础插件
        #记录日志级别
        errors
        health {
            lameduck 5s
        }
        ready
        
        # Kubernetes服务发现
        kubernetes cluster.local in-addr.arpa ip6.arpa {
            pods insecure
            fallthrough in-addr.arpa ip6.arpa
            ttl 30
        }
        
        # 静态hosts配置,其中路径为挂在路径，也可以hosts{}直接配置
        hosts /etc/coredns/custom.hosts {
            fallthrough
            ttl 60
            reload 1m
        }
        
        # 监控
        prometheus :9153
        
        # 上游DNS
        forward . /etc/resolv.conf {
            policy sequential  # 查询策略
        }
        
        # 缓存
        cache 30
        
        # 高级功能
        reload
        loop
        loadbalance round_robin
    }
    
    # 额外域名配置
    example.com:53 {
        forward . 10.0.0.1
        cache 60
    }

四、配置项说明

1、lameduck 5s

说明：

lameduck 5s 是 CoreDNS 健康检查插件 (health) 中的一个重要参数，用于控制 CoreDNS 实例优雅退出的行为。当 CoreDNS 进程收到终止信号（如 Pod 被删除或升级时),会进入为期 5 秒的 "lameduck" 模式（跛脚鸭模式）,在此期间，健康检查端点会返回不健康状态（HTTP 503),但服务仍然继续处理现有的 DNS 请求

设计目的：

• 实现优雅终止 (graceful shutdown)，避免在应用更新期间出现连接拒绝的场景
• 让负载均衡器/服务发现机制有时间将流量从该实例转移
• 避免服务中断期间丢包

2、CoreDNS Kubernetes

kubernetes cluster.local in-addr.arpa ip6.arpa {
    pods insecure
    fallthrough in-addr.arpa ip6.arpa
    ttl 30
}

kubernetes cluster.local in-addr.arpa ip6.arpa

功能：启用 Kubernetes 服务发现

• cluster.local：Kubernetes 集群的默认域名（可自定义）
• in-addr.arpa：启用 IPv4 反向 DNS 查询支持
• ip6.arpa：启用 IPv6 反向 DNS 查询支持

fallthrough in-addr.arpa ip6.arpa

功能：控制查询失败时的行为

• 如果查询的域名匹配 in-addr.arpa 或 ip6.arpa 但未找到记录，则继续执行后续插件
• 如果没有 fallthrough，未找到记录时将直接返回 NXDOMAIN

ttl 30

功能：设置 DNS 响应的 TTL (Time-To-Live) 

• 单位是秒
• 控制客户端缓存该 DNS 记录的时间
• 较短的 TTL 可以更快感知服务变化，但会增加 DNS 查询压力

工作流程

当收到 DNS 查询时：

• 首先尝试匹配 Kubernetes 服务 (如 service.namespace.svc.cluster.local)
• 然后尝试匹配 Pod 记录 (如 10-244-1-3.default.pod.cluster.local)
• 对于反向查询 (x.x.x.x.in-addr.arpa)，尝试解析对应的服务或 Pod

如果未找到记录且配置了 fallthrough，继续执行 Corefile 中的下一个插件（如 forward 插件）

3、hosts配置

通过挂载文件配置

hosts /etc/coredns/custom.hosts {
    fallthrough
    ttl 60
    reload 1m
}

直接配置

hosts {

    10.152.141.121 test1

    10.152.141.122 test2
    fallthrough
    ttl 60
    reload 1m
}

•  fallthrough:如果域名没有在hosts文件中配置，则继续走后续插件
• ttl:控制客户端缓存时间，默认值5s,通常采用默认值
• reload:修改hosts文件后自动重新加载的时间，默认值不自动加载，通常采用默认值

4、forward

#配置为指定节点的/etc/resolv.conf文件

forward . /etc/resolv.conf {
            policy sequential  # 查询策略
        }

 五、修改配置文件

1、获取当前配置

kubectl get configmap -n kube-system coredns -o yaml > coredns-config.yaml

2、修改配置

vim coredns-config.yaml

3、应用修改

kubectl apply -f coredns-config.yaml 

4、回滚

#列出备份文件

ls -l coredns-backup-*.yaml

#回滚指定版本

kubectl apply -f coredns-backup-.yaml