组件介绍

CCE Node Local DNS 组件是基于社区开源项目 NodeLocal DNSCache 的一套 DNS 本地缓存解决方案。在 CCE 集群中部署 NodeLocalDNS 可以提升服务发现的稳定性和性能，NodeLocalDNS 通过在集群节点上作为 DaemonSet 运行 DNS 缓存代理来提高集群DNS性能。该组件由两部分组成，分别是：Local DNS 本地缓存的 DaemonSet 和 用于 DNSConfig 注入的动态注入控制器 Deployment。

• Local DNS 本地缓存会在每个 Node 上创建一个 Pod 用于监听 Local IP（默认 IP 为 169.254.20.10），通过注入的 DNSConfig 配置， Pod 上的 DNS 请求会被 Local DNS 本地缓存所代理。

DaemonSet 服务是基于CoreDNS提供的服务，但其仅具有代理和缓存的功能。

• 用于 DNSConfig 注入的动态注入控制器是基于 Admission Webhook 机制拦截 Pod 创建的请求，自动为新建 Pod 注入 DNSConfig 配置信息。

如果没有启用该 Webhook，则需要您手动添加 DNSConfig 配置。

Node Local DNS 工作原理图

• 在 Pod 创建流程中，新增了 Admission Webhook 为 Pod 注入 DNSConfig。
• 在 Pod 的域名解析流程中，数据链路如下：

Node Local DNS 使用方式

为了使用 Node Local DNS，将请求 CoreDSN 的流量转到由本地 LocalDNS 的 DaemonSet 代理，您需要在 Pod 内部注入 DNSConfig 配置，三种方式可供选择：

• 方式一：安装 CCE Node Local DNS 组件，通过组件中的 Webhook 实现 DNSConfig 注入，推荐使用该方式。
• 方式二：手动给 Pod 添加 DNSConfig
• 方式三：修改 kubelet 参数，并重启kubelet使其生效，不推荐该方式，业务存在中断风险。

方式一：DNSConfig 自动注入

前置条件：

• 集群安装 CCE Node Local DNS 组件

DNSConfig 动态注入控制器可实现在 Pod 新建时，自动注入 DNSConfig，无需手动添加配置。该 Webhook 默认会监听带有cce.baidu.com/node-local-dns-injection=enabled标签的命名空间中新建 Pod 的请求，您可以通过以下命令给命名空间打上Label标签:

kubectl label namespace default cce.baidu.com/node-local-dns-injection=enabled

请注意：

• 上述命令仅给 default 命名空间打上自动注入标签，这意味着只有在 default 命名空间下新建的 Pod 才会触发 Webhook 实现 DNSConfig 自动注入。如需修改命名空间，需要您将 default 替换成目标命名空间。
• 在满足上述条件下，如果您需要对部分 Pod 进行豁免（即不注入 DNSConfig），您可以给 Pod 添加标签： cce.baidu.com/node-local-dns-injection=disabled 。

DNSConfig自动注入生效后，您新建的 Pod 将会被添加以下字段：

dnsConfig:
  nameservers:
  - 169.254.20.10
  - 172.21.0.10
  options:
  - name: ndots
    value: "3"
  - name: attempts
    value: "2"
  - name: timeout
    value: "1"
  searches:
  - default.svc.cluster.local
  - svc.cluster.local
  - cluster.local
dnsPolicy: None

说明：

• nameservers：配置成169.254.20.10（默认值）和 kube-dns 的 ClusterIP 对应的IP地址，其中 ClusterIP 将作为备份的DNS服务器地址
• searches：设置搜索域，保证集群内部域名能够被正常解析，默认为 default.svc.cluster.local、svc.cluster.local 和 cluster.local
• ndots：默认为3，可以适当降低 ndots 以提升解析效率
• attempts：默认为2，尝试解析次数
• timeout：默认为1，超时时间

在 方式一 下，如果您新建的 Pod 未被注入 DNSConfig，请检查以下条件（只有当以下条件全部满足时，才会实现 Pod 自动注入）：

1. Pod 所在 Namespace 包含 label：cce.baidu.com/node-local-dns-injection=enabled
2. Pod 所在 Namespace 不为: kube-system、cce-monitor 或 cprom-system
3. Pod 不包含 label：cce.baidu.com/node-local-dns-injection=disabled
4. Pod 不包含要求调度到 VirtualKubelet 节点的调度配置（如节点选择、节点亲和性等配置）
5. Pod 的 hostNetwork 为 false 且 DNSPolicy 为 ClusterFirst 或 none，或 hostNetwork 为 true 且 DNSPolicy 为 ClusterFirstWithHostNet

方式二：手动添加DNSConfig

在不采用 方式一 的情况下，您需要手动添加 DNSConfig，参考案例如下：

apiVersion: v1
kind: Pod
metadata:
  name: test01
  namespace: default
spec:
  containers:
  - image: registry.baidubce.com/cce-plugin-pro/cce-cni/netshoot:latest
    command:
      - sleep
      - "100000"
    imagePullPolicy: Always
    name: net-debug-container
  dnsPolicy: None
  dnsConfig:
    nameservers: ["169.254.20.10","172.21.0.10"]
    searches:
    - default.svc.cluster.local
    - svc.cluster.local
    - cluster.local
    options:
    - name: ndots
      value: "3"
    - name: attempts
      value: "2"
    - name: timeout 
      value: "1"

请注意：

• dnsPolicy必须为 None
• 其他参数介绍请参考 方式一 说明

方式三：配置 kubelet 启动参数

您可以通过修改 kubelet 启动参数来全局控制Pod DNSConfig，详情请参考：Using NodeLocal DNSCache in Kubernetes Clusters。

组件功能

• 通过DNSConfig动态注入控制器Deployment，可以自动给新建 Pod 添加 DNSConfig 配置
• 通过在集群节点上以 Daemonset 的形式运行 NodeLocal DNS Cache，能够大幅提升集群内 DNS 解析性能

使用场景

通过在集群节点上作为 DaemonSet 运行 DNS 缓存代理来提高集群DNS性能。

使用限制

• 集群版本在 1.18 以上
• CCE Node Local DNS 不支持 ARM 集群、边缘集群
• 能够使用 kubectl 访问集群，操作步骤见：通过kubectl连接集群

安装组件

安装 CCE Node Local DNS 组件有两种方式，分别是：组件管理安装 和 Helm 模版安装，建议您通过组件管理安装该组件。

方式一：通过组件管理安装 CCE Node Local DNS

1. 登录百度智能云官网，并进入管理控制台。
2. 选择“产品服务 > 云原生 > 容器引擎 CCE”，单击进入容器引擎管理控制台。
3. 单击左侧导航栏中的 集群管理 > 集群列表。
4. 在集群列表页面中，单击目标集群名称进入集群管理页面。
5. 在集群管理页面单击 组件管理 。
6. 在组件管理列表中选择 Node Local DNS 组件单击“安装”。
7. 点击“确定”按钮完成组件的安装。

方式二：通过 Helm 模版安装 CCE Node Local DNS

1. 登录百度智能云官网，并进入管理控制台。
2. 选择“产品服务>云原生>容器引擎CCE”，单击进入容器引擎管理控制台。
3. 单击左侧导航栏中的 “Helm > Helm 模版”。
4. 在 Helm 模版页面中，单击 百度智能云模版 进入模版管理页面。
5. 在模版管理页面中选择模版名称 cce-node-local-dns，然后单击 “安装”。
6. 在 安装模版 页面中完成相关配置填写，点击 “确定” 按钮完成组件的安装。

相关配置填写说明如下表：

部署情况

安装 CCE Node Local DNS 组件，将在 Kubernetes 集群中部署以下对象:

可观测性

您可以通过抓取 Node Local DNS 暴漏的指标接口，观测 Node Local DNS 组件的工作情况。

• 在集群中获取指标数据可以通过该方式：

curl http://<local ip>:9253/metrics # 默认为 169.254.20.10

下面是常见的 CoreDNS 指标介绍：

在 CProm 中添加对 CCE Node Local DNS 的指标采集任务

在 CProm 中添加对 Node-Problem-Detector 的指标采集规则之前，需要先为 CCE 集群关联 CProm 实例，并添加指标采集任务。 操作参考：

• CProm 实例关联 CCE 集群
• CProm 实例中添加采集任务

添加如下指标采集任务：

job_name: 'localdns'
scheme: http
static_configs:
- targets: [<local ip>:9253']

版本记录