6.6. OpenShift Container Platform 中的 DNS Operator

1. 使用 oc get 命令查看部署状态：

   $ oc get -n openshift-dns-operator deployment/dns-operator

   输出示例

   NAME           READY     UP-TO-DATE   AVAILABLE   AGE
   dns-operator   1/1       1            1           23h

2. 使用 oc get 命令来查看 DNS Operator 的状态：

   $ oc get clusteroperator/dns

   输出示例

   NAME      VERSION     AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   dns       4.1.15-0.11  True        False         False      92m

   AVAILABLE、PROGRESSING 和 DEGRADED 提供了有关 Operator 状态的信息。当 CoreDNS 守护进程中至少有一个 pod 被设置为 Available 状态时，AVAILABLE 为 True，DNS 服务有一个集群 IP 地址。

流程

1. 使用 oc describe 命令来查看默认 dns：

   $ oc describe dns.operator/default

   输出示例

   Name:         default
   Namespace:
   Labels:       <none>
   Annotations:  <none>
   API Version:  operator.openshift.io/v1
   Kind:         DNS
   ...
   Status:
     Cluster Domain:  cluster.local 1
     Cluster IP:      172.30.0.10 2
   ...

   1

   Cluster Domain 字段是用来构造完全限定的 pod 和服务域名的基本 DNS 域。

   2

   Cluster IP 是 Pod 为名称解析查询的地址。IP 由服务 CIDR 范围中的第 10 个地址定义。

2. 要查找集群的服务 CIDR 范围，请使用 oc get 命令：

   $ oc get networks.config/cluster -o jsonpath='{$.status.serviceNetwork}'

   输出示例

   [172.30.0.0/16]

流程

1. 修改名为 default 的 DNS Operator 对象：

   $ oc edit dns.operator/default

   发出上一命令后，Operator 会根据 spec.servers 创建并更新名为 dns-default 的配置映射，并使用额外的服务器配置块。如果任何服务器都没有与查询匹配的区域，则名称解析会返回上游 DNS 服务器。

   配置 DNS 转发

   apiVersion: operator.openshift.io/v1
   kind: DNS
   metadata:
     name: default
   spec:
     cache:
       negativeTTL: 0s
       positiveTTL: 0s
     logLevel: Normal
     nodePlacement: {}
     operatorLogLevel: Normal
     servers:
     - name: example-server 1
       zones:
       - example.com 2
       forwardPlugin:
         policy: Random 3
         upstreams: 4
         - 1.1.1.1
         - 2.2.2.2:5353
     upstreamResolvers: 5
       policy: Random 6
       protocolStrategy: ""  7
       transportConfig: {}  8
       upstreams:
       - type: SystemResolvConf 9
       - type: Network
         address: 1.2.3.4 10
         port: 53 11
       status:
         clusterDomain: cluster.local
         clusterIP: x.y.z.10
         conditions:
      ...

   1

   必须符合 rfc6335 服务名称语法。

   2

   必须符合 rfc1123 服务名称语法中的子域的定义。集群域 cluster.local 是对 zones 字段的无效子域。

   3

   定义用于选择 forwardPlugin 中列出的上游解析器的策略。默认值为 Random。您还可以使用 RoundRobin, 和 Sequential 值。

   4

   每个 forwardPlugin 最多允许 15 个 upstreams。

   5

   您可以使用 upstreamResolvers 覆盖默认转发策略，并将 DNS 解析转发到默认域的指定 DNS 解析器（上游解析器）。如果没有提供任何上游解析器，DNS 名称查询将进入 /etc/resolv.conf 中声明的服务器。

   6

   决定选择上游中列出的 upstreams 服务器进行查询的顺序。您可以指定这些值之一： Random、RoundRobin 或 Sequential。默认值为 Sequential。

   7

   如果被省略，平台会选择一个默认值，通常是原始客户端请求的协议。设置为 TCP，以指定平台应该对所有上游 DNS 请求使用 TCP，即使客户端请求使用了 UDP。

   8

   用于配置传输类型、服务器名称和可选自定义 CA 或 CA 捆绑包，以便在将 DNS 请求转发到上游解析器时使用。

   9

   您可以指定两个类型的 upstreams：SystemResolvConf 或 Network。SystemResolvConf 将上游配置为使用 /etc/resolv.conf 和 Network 定义一个 Networkresolver。您可以指定其中一个或两者都指定。

   10

   如果指定类型是 Network，则必须提供 IP 地址。address 字段必须是有效的 IPv4 或 IPv6 地址。

   11

   如果指定类型是 Network，您可以选择性地提供端口。port 字段必须是 1 到 65535 之间的值。如果您没有为上游指定端口，则默认端口为 853。

验证

1. 要查看生成的更改，请输入以下命令：

   $ oc get dnses.operator -A -oyaml

   您应该会看到两个日志级别条目。operatorLogLevel 适用于 OpenShift DNS Operator 问题，logLevel 适用于 CoreDNS pod 的 daemonset：

    logLevel: Trace
    operatorLogLevel: Debug

2. 要查看 daemonset 的日志，请输入以下命令：

   $ oc logs -n openshift-dns ds/dns-default

流程

1. 运行以下命令来编辑名为 default 的 DNS Operator 对象：

   $ oc edit dns.operator.openshift.io/default

2. 修改生存时间 (TTL) 缓存值：

   配置 DNS 缓存

   apiVersion: operator.openshift.io/v1
   kind: DNS
   metadata:
     name: default
   spec:
     cache:
       positiveTTL: 1h 1
       negativeTTL: 0.5h10m 2

   1

   CoreDNS 会将字符串值 1h 转换为其相应的秒数。如果省略此字段，则假定该值为 0s，集群将使用内部默认值 900s 作为回退。

   2

   字符串值可以是单元的组合（如 0.5h10m），并被 CoreDNS 转换为相应秒数。如果省略了此字段，则假定该值为 0s，集群将使用内部默认值 30s 作为回退。

验证

1. 要查看更改，请运行以下命令再次查看配置映射：

   oc get configmap/dns-default -n openshift-dns -o yaml

2. 验证您是否看到类似以下示例的条目：

          cache 3600 {
               denial 9984 2400
           }