文档首页/ 云容器引擎 CCE/ 用户指南（安卡拉区域）/ 插件/ 节点本地域名解析加速
更新时间：2024-12-04 GMT+08:00
查看PDF
分享

节点本地域名解析加速

插件简介

节点本地域名解析加速（node-local-dns）是基于社区NodeLocal DNSCache提供的插件，通过在集群节点上作为守护程序集运行DNS缓存代理，提高集群DNS性能。

开源社区地址：https://github.com/kubernetes/dns

启用NodeLocal DNSCache之后，DNS查询所遵循的路径如下图所示。

图1 NodeLocal DNSCache查询路径
其中解析线路说明如下：
  • ①：已注入DNS本地缓存的Pod，默认会通过NodeLocal DNSCache解析请求域名。
  • ②：NodeLocal DNSCache本地缓存如果无法解析请求，则会请求集群CoreDNS进行解析。
  • ③：对于非集群内的域名，CoreDNS会通过VPC的DNS服务器进行解析。
  • ④：已注入DNS本地缓存的Pod，如果无法连通NodeLocal DNSCache，则会直接通过CoreDNS解析域名。
  • ⑤：未注入DNS本地缓存的Pod，默认会通过CoreDNS解析域名。

约束与限制

  • 仅支持1.19及以上版本集群。

安装插件

  1. 登录CCE控制台，单击集群名称进入集群，在左侧导航栏中选择“插件中心”，在右侧找到节点本地域名解析加速插件，单击“安装”。
  2. 在安装插件页面，设置“规格配置”。

    表1 插件规格配置

    参数

    参数说明

    插件规格

    该插件可配置“单实例”、“高可用”或“自定义”规格。

    实例数

    选择上方插件规格后，显示插件中的实例数。

    选择“自定义”规格时，您可根据需求调整插件实例数。

    容器

    选择插件规格后，显示插件容器的CPU和内存配额。

    选择“自定义”规格时，您可根据需求调整插件实例的容器规格。

  3. 设置插件支持的“参数配置”。

    • DNSConfig自动注入：启用后，会创建DNSConfig动态注入控制器，该控制器基于Admission Webhook机制拦截目标命名空间（即命名空间包含标签node-localdns-injection=enabled）下Pod的创建请求，自动配置使用DNS缓存的Pod dnsConfig字段。未开启DNSConfig自动注入或Pod属于非目标命名空间，则需要手动给Pod配置DNSConfig。
    • 目标命名空间：启用DNSConfig自动注入时支持设置。仅1.3.0及以上版本的插件支持。
      • 全部开启：CCE会为已创建的命名空间添加标签（node-local-dns-injection=enabled），同时会识别命名空间的创建请求并自动添加标签，这些操作的目标不包含系统内置的命名空间（如kube-system）。
      • 手动配置：手动为需要注入DNSConfig的命名空间添加标签（node-local-dns-injection=enabled），操作步骤请参见管理命名空间标签。

  4. 设置插件实例的“调度策略”。

    • 调度策略对于DaemonSet类型的插件实例不会生效。
    • 设置多可用区部署或节点亲和策略时，需保证集群中存在满足调度策略的节点且拥有足够的资源，否则插件实例将无法运行。
    表2 插件调度配置

    参数

    参数说明

    多可用区部署
    • 优先模式：优先将插件的Deployment实例调度到不同可用区的节点上，如集群下节点不满足多可用区，插件实例将调度到单可用区。
    • 均分模式：插件Deployment实例均匀调度到当前集群下各可用区，增加新的可用区后建议扩容插件实例以实现跨可用区高可用部署；均分模式限制不同可用区间插件实例数相差不超过1，单个可用区资源不足会导致后续其他实例无法调度。
    • 强制模式：插件Deployment实例强制调度到不同可用区的节点上，如集群下节点不满足多可用区，插件实例将无法全部运行。

    节点亲和
    • 不配置：插件实例不指定节点亲和调度。
    • 指定节点调度：指定插件实例部署的节点。若不指定，将根据集群默认调度策略进行随机调度。
    • 指定节点池调度：指定插件实例部署的节点池。若不指定，将根据集群默认调度策略进行随机调度。
    • 自定义亲和策略：填写期望插件部署的节点标签实现更灵活的调度策略，若不填写将根据集群默认调度策略进行随机调度。

      同时设置多条自定义亲和策略时，需要保证集群中存在同时满足所有亲和策略的节点，否则插件实例将无法运行。

    容忍策略

    容忍策略与节点的污点能力配合使用，允许（不强制）插件的 Deployment 实例调度到带有与之匹配的污点的节点上，也可用于控制插件的 Deployment 实例所在的节点被标记污点后插件的 Deployment 实例的驱逐策略。

    插件会对实例添加针对node.kubernetes.io/not-ready和node.kubernetes.io/unreachable污点的默认容忍策略，容忍时间窗为60s。

    详情请参见容忍策略。

  5. 完成以上配置后，单击“安装”。

组件说明

表3 node-local-dns组件

容器组件

说明

资源类型

node-local-dns-admission-controller

提供自动注入DNSConfig功能。

Deployment

node-local-dns-cache

作为节点上DNS缓存代理提高集群DNS性能。

DaemonSet

使用NodeLocal DNSCache

默认情况下，应用的请求会通过CoreDNS代理，如果需要使用node-local-dns进行DNS缓存代理，您有以下几种方式可以选择：

  • 自动注入：创建Pod时自动配置Pod的dnsConfig字段。（kube-system等系统命名空间下的Pod不支持自动注入）
  • 手动配置：手动配置Pod的dnsConfig字段，从而使用NodeLocal DNSCache。

自动注入

自动注入需要满足如下条件：

  • 在安装插件时，开启DNSConfig自动注入。
  • 命名空间添加node-local-dns-injection=enabled标签。例如，为default命名空间添加该标签的命令如下：

    kubectl label namespace default node-local-dns-injection=enabled

  • 新建Pod不位于kube-system和kube-public等系统命名空间。
  • 新建Pod没有被打上禁用DNS注入的标签node-local-dns-injection=disabled。
  • 新建Pod的DNSPolicy为ClusterFirstWithHostNet，或Pod为非hostNetwork且DNSPolicy为ClusterFirst。

开启自动注入后，创建的Pod会自动添加如下dnsConfig字段，nameservers中除了NodeLocal DNSCache的地址（169.254.20.10）外，还添加了CoreDNS的地址（10.247.3.10），保障了业务DNS请求高可用。

...
  dnsConfig:
    nameservers:
      - 169.254.20.10
      - 10.247.3.10
    searches:
      - default.svc.cluster.local
      - svc.cluster.local
      - cluster.local
    options:
      - name: timeout
        value: ''
      - name: ndots
        value: '5'
      - name: single-request-reopen
...

手动配置

手动配置即自行给Pod加上dnsConfig配置。

创建一个Pod，并在dnsConfig中的nameservers配置中添加NodeLocal DNSCache的地址（169.254.20.10）。

apiVersion: v1
kind: Pod
metadata:
  name: nginx
spec:
  containers:
  - image: nginx:alpine
    name: container-0
  dnsConfig:
    nameservers:
    - 169.254.20.10
    - 10.247.3.10
    searches:
    - default.svc.cluster.local
    - svc.cluster.local
    - cluster.local
    options:
    - name: ndots
      value: '2'
  imagePullSecrets:
  - name: default-secret

卸载插件

卸载插件后将影响已经使用node-local-dns地址进行域名解析的Pod，请谨慎操作。如需卸载，请先清除命名空间上的node-local-dns-injection=enabled标签，然后删除重建带有上述标签的Pod，待Pod完成重建以后再卸载插件。

  1. 卸载前检查。

    1. 登录CCE控制台，单击集群名称进入集群，在左侧导航栏中选择“插件中心”，在右侧找到node-local-dns，单击“编辑”。
    2. 在“参数配置”中查看是否启用DNS Config自动注入。
      如果已启用DNSConfig自动注入：
      1. 在左侧导航栏中选择“命名空间”。
      2. 检查哪些命名空间存在node-local-dns-injection=enabled的标签，并删除标签，操作步骤请参见管理命名空间标签。
      3. 删除上述命名空间中的Pod并重建。

      如果未启用DNSConfig自动注入：

      1. 使用kubectl连接集群。
      2. 检查哪些业务Pod被手动注入DNSConfig。如果在多个命名空间下创建Pod，所有命名空间下的Pod均需要进行检查。

        例如，检查default命名空间下的Pod，您可以执行以下命令：

        kubectl get pod -n default -o yaml
      3. 手动清除DNSConfig，并重建Pod。

  2. 卸载node-local-dns插件。

    1. 在左侧导航栏中选择“插件中心”，在右侧找到node-local-dns，单击“卸载”。
    2. 在弹出对话框中单击“确定”。

相关链接

使用NodeLocal DNSCache提升DNS性能

父主题： 插件