概述

RKE 提供了以下三种 DNS 提供商，作为附加组件部署：

• NodeLocal DNS
• CoreDNS
• kube-dns

在 RKE v0.2.5 及更新版本中，使用 Kubernetes 1.14 及以上版本时，CoreDNS 是默认 DNS 提供商。如果使 RKE 版本低于 v0.2.5，则 kube-dns 是默认 DNS 提供商。

NodeLocal DNS

先决条件

启用 NodeLocal DNS 选项需要满足以下条件：

• RKE 版本为 v1.1.0 或更新版本
• Kubernetes 版本为 v1.15.11+、v1.16.8+或 v1.17.4+。

NodeLocal DNS 是一个额外的组件，可以部署在每个节点上，提高 DNS 性能。由于它不能替代provider参数，所以仍然需要为每个节点配置一个可用的 DNS 提供商。有关 NodeLocal DNS 工作原理的更多信息，请参见在 Kubernetes 集群中使用 NodeLocal DNS Cache。

配置 NodeLocal DNS

使用ip_address参数配置每台主机监听的链路本地 IP 地址，请确保这个 IP 地址在主机上没有被占用。

dns:
  provider: coredns
  nodelocal:
    ip_address: "169.254.20.10"

**说明：**当在现有群集上启用 NodeLocal DNS 时，当前正在运行的 pod 不会被修改，更新后的/etc/resolv.conf配置只对启用 NodeLocal DNS 后启动的 pod 生效。

移除 NodeLocal DNS

删除ip_address值就会将从集群中删除 NodeLocal DNS。

说明： 删除 NodeLocal DNS 时， 可能会对 DNS 造成干扰。更新后的/etc/resolv.conf配置仅对删除 NodeLocal DNS 后启动的 pod 生效。在一般情况下，使用默认dnsPolicy: ClusterFirst将需要重新部署。

说明： 如果您从一个 DNS 提供商切换到另一个 DNS 提供商，在部署新的 DNS 提供商之前，现有的 DNS 提供商会被删除。

CoreDNS

v0.2.5 及更新版本可用

CoreDNS 只能在 Kubernetes v1.14.0 及以上版本上使用。

RKE 将 CoreDNS 部署为一个默认副本为 1 的 Deployment，该 pod 由coredns一个容器组成。RKE 也会将 coredns-autoscaler 部署为 Deployment，使用核心数量和节点的数量来扩展 coredns Deployment。详情请参考Linear Mode。

CoreDNS 使用的镜像在system_images中。对于每个 Kubernetes 版本，都有与 CoreDNS 相关联的默认镜像，但这些镜像可以通过更改system_images中的镜像标签来覆盖。

调度 CoreDNS

如果只想在特定的节点上部署 CoreDNS pod ，可以在dns部分设置一个node_selector。node_selector中的标签需要与要部署 CoreDNS pod 的节点上的标签相匹配。

nodes:
  - address: 1.1.1.1
    role: [controlplane, worker, etcd]
    user: root
    labels:
      app: dns
dns:
  provider: coredns
  node_selector:
    app: dns

配置 CoreDNS

上游名称服务器

默认情况下，CoreDNS 使用主机配置的命名服务器（通常保存在/etc/resolv.conf路径下）来解析外部查询。如果想配置特定的上游名称服务器，可以使用upstreamnameservers指令。

设置 upstreamnameservers时，还需要同步修改provider配置。

dns:
  provider: coredns
  upstreamnameservers:
    - 1.1.1.1
    - 8.8.4.4

kube-dns

RKE 将 kube-dns 部署为一个默认副本为 1 的 Deployment，该 pod 由kubedns、dnsmasq和sidecar共 3 个容器组成。RKE 也将 kube-dns-autoscaler 部署为 Deployment，通过使用核心和节点数量来扩展 kube-dns Deployment。详情请参考Linear Mode。

kube-dns 使用的镜像在system_images下。对于每个 Kubernetes 版本，都有与 kube-dns 相关联的默认镜像，但这些图片可以通过更改system_images中的镜像标签来覆盖。

调度 kube-dns

v0.2.0 及更新版本可用

如果只想在特定的节点上部署 kube-dns pod，可以在dns部分设置一个node_selector。node_selector中的标签需要与要部署 CoreDNS pod 的节点上的标签相匹配。

nodes:
  - address: 1.1.1.1
    role: [controlplane, worker, etcd]
    user: root
    labels:
      app: dns
dns:
  provider: kube-dns
  node_selector:
    app: dns

配置 kube-dns

上游名称服务器

v0.2.0 及更新版本可用

默认情况下，kube-dns 使用主机配置的命名服务器（通常保存在/etc/resolv.conf路径下）来解析外部查询。如果想配置特定的上游名称服务器，可以使用upstreamnameservers指令。

设置 upstreamnameservers时，还需要同步修改provider配置。

dns:
  provider: kube-dns
  upstreamnameservers:
    - 1.1.1.1
    - 8.8.4.4

禁用 DNS provider 的 Deployment

v0.2.0 及更新版本可用

您可以在群集配置中的 dnsprovider设置为none，禁用默认的 DNS 提供商。这个操作会阻止 pods 在集群中进行名称解析。

dns:
  provider: none