DNS提供商

概述#

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

NodeLocal DNS
CoreDNS
kube-dns

RKE 版本	Kubernetes 版本	默认 DNS 提供商
v0.2.5 及以上	v1.14.0 及以上	CoreDNS
v0.2.5 及以上	v1.13.x 及以下	kube-dns
v0.2.4 及以下	无版本要求	kube-dns
v1.1.0 及以上	v1.15.11+、v1.16.8 和 v1.17.4+	NodeLocal DNS

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

禁用 DNS provider 的 Deployment#

v0.2.0 及更新版本可用

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

dns:
  provider: none

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 Priority Class Name#

从 RKE v1.2.6+开始可用

pod 优先级是通过在options下配置一个优先级类名来设置的。

dns:
  options:
    nodelocal_autoscaler_priority_class_name: system-cluster-critical
    nodelocal_priority_class_name: system-cluster-critical
  provider: coredns # 必须配置一个DNS提供商

移除 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

容忍度#

从 v1.2.4 开始提供

配置的容忍度适用于coredns和coredns-autoscaler部署。

dns:
  provider: coredns
  tolerations:
    - key: "node.kubernetes.io/unreachable"
      operator: "Exists"
      effect: "NoExecute"
      tolerationseconds: 300
    - key: "node.kubernetes.io/not-ready"
      operator: "Exists"
      effect: "NoExecute"
      tolerationseconds: 300

要检查coredns和 coredns-autoscaler部署的应用容忍度，请使用以下命令：

kubectl -n kube-system get deploy coredns -o jsonpath='{.spec.template.spec.tolerations}'。
kubectl -n kube-system get deploy coredns-autoscaler -o jsonpath='{.spec.template.spec.tolerations}'。

CoreDNS 优先级类名称#

从 RKE v1.2.6+开始可用

pod 优先级是通过在options下配置一个优先级类名称来设置的。

dns:
  options:
    coredns_autoscaler_priority_class_name: system-cluster-critical
    coredns_priority_class_name: system-cluster-critical
  provider: coredns

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#

upstreamnameservers#

v0.2.0 及更新版本可用

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

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

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

容忍度#

从 v1.2.4 开始提供

配置的容忍度适用于kube-dns和kube-dns-autoscaler部署。

dns:
  provider: kube-dns
  tolerations:
    - key: "node.kubernetes.io/unreachable"
      operator: "Exists"
      effect: "NoExecute"
      tolerationseconds: 300
    - key: "node.kubernetes.io/not-ready"
      operator: "Exists"
      effect: "NoExecute"
      tolerationseconds: 300

要检查coredns和 coredns-autoscaler部署的应用容忍度，请使用以下命令：

kubectl get deploy kube-dns -n kube-system -o jsonpath='{.spec.template.spec.tolerations}'。
kubectl get deploy kube-dns-autoscaler -n kube-system -o jsonpath='{.spec.template.spec.tolerations}'。

kube-dns 优先级类别名称#

RKE v1.2.6+开始可用

pod 优先级是通过在options下配置优先级类名称来设置的。

dns:
  options:
    kube_dns_autoscaler_priority_class_name: system-cluster-critical
    kube_dns_priority_class_name: system-cluster-critical
  provider: kube-dns