diff --git a/content/zh-cn/docs/concepts/services-networking/dns-pod-service.md b/content/zh-cn/docs/concepts/services-networking/dns-pod-service.md index 41b06462c183e..82b36504f941c 100644 --- a/content/zh-cn/docs/concepts/services-networking/dns-pod-service.md +++ b/content/zh-cn/docs/concepts/services-networking/dns-pod-service.md @@ -1,7 +1,7 @@ --- title: Service 与 Pod 的 DNS content_type: concept -weight: 60 +weight: 80 description: >- 你的工作负载可以使用 DNS 发现集群内的 Service，本页说明具体工作原理。 --- @@ -11,7 +11,7 @@ reviewers: - thockin title: DNS for Services and Pods content_type: concept -weight: 60 +weight: 80 description: >- Your workload can discover Services within your cluster using DNS; this page explains how that works. @@ -29,14 +29,10 @@ Kubernetes 为 Service 和 Pod 创建 DNS 记录。 -## 介绍 {#introduction} - Kubernetes DNS 除了在集群上调度 DNS Pod 和 Service， 还配置 kubelet 以告知各个容器使用 DNS Service 的 IP 来解析 DNS 名称。 @@ -55,7 +51,7 @@ A DNS query may return different results based on the namespace of the Pod makin it. DNS queries that don't specify a namespace are limited to the Pod's namespace. Access Services in other namespaces by specifying it in the DNS query. -For example, consider a Pod in a `test` namespace. A `data` service is in +For example, consider a Pod in a `test` namespace. A `data` Service is in the `prod` namespace. A query for `data` returns no results, because it uses the Pod's `test` namespace. @@ -81,7 +77,7 @@ DNS queries may be expanded using the Pod's `/etc/resolv.conf`. Kubelet sets this file for each Pod. For example, a query for just `data` may be expanded to `data.test.svc.cluster.local`. The values of the `search` option are used to expand queries. To learn more about DNS queries, see -[the `resolv.conf` manual page.](https://www.man7.org/linux/man-pages/man5/resolv.conf.5.html) +[the `resolv.conf` manual page.](https://www.man7.org/linux/man-pages/man5/resolv.conf.5.html) --> DNS 查询可以使用 Pod 中的 `/etc/resolv.conf` 展开。kubelet 会为每个 Pod 生成此文件。例如，对 `data` 的查询可能被展开为 `data.test.svc.cluster.local`。 @@ -143,7 +139,7 @@ Services, this resolves to the set of IPs of the Pods selected by the Service. Clients are expected to consume the set or else use standard round-robin selection from the set. --> -### Services +### Service #### A/AAAA 记录 {#a-aaaa-records} @@ -181,7 +177,7 @@ SRV 记录格式为 `_my-port-name._my-port-protocol.my-svc.my-namespace.svc.clu 其中包含 Pod 端口号和格式为 `auto-generated-name.my-svc.my-namespace.svc.cluster-domain.example` 的域名。 -## Pods +## Pod -Endpoints 对象可以为任何端点地址及其 IP 指定 `hostname`。 +{{}} +对象可以为任何端点地址及其 IP 指定 `hostname`。 ### Pod 的 setHostnameAsFQDN 字段 {#pod-sethostnameasfqdn-field} @@ -351,8 +346,8 @@ When a Pod is configured to have fully qualified domain name (FQDN), its hostnam When you set `setHostnameAsFQDN: true` in the Pod spec, the kubelet writes the Pod's FQDN into the hostname for that Pod's namespace. In this case, both `hostname` and `hostname --fqdn` return the Pod's FQDN. --> 当 Pod 配置为具有全限定域名 (FQDN) 时，其主机名是短主机名。 - 例如，如果你有一个具有完全限定域名 `busybox-1.default-subdomain.my-namespace.svc.cluster-domain.example` 的 Pod， - 则默认情况下，该 Pod 内的 `hostname` 命令返回 `busybox-1`，而 `hostname --fqdn` 命令返回 FQDN。 +例如，如果你有一个具有完全限定域名 `busybox-1.default-subdomain.my-namespace.svc.cluster-domain.example` 的 Pod， +则默认情况下，该 Pod 内的 `hostname` 命令返回 `busybox-1`，而 `hostname --fqdn` 命令返回 FQDN。 当你在 Pod 规约中设置了 `setHostnameAsFQDN: true` 时，kubelet 会将 Pod 的全限定域名（FQDN）作为该 Pod 的主机名记录到 Pod 所在名字空间。 @@ -364,16 +359,14 @@ In Linux, the hostname field of the kernel (the `nodename` field of `struct utsn If a Pod enables this feature and its FQDN is longer than 64 character, it will fail to start. The Pod will remain in `Pending` status (`ContainerCreating` as seen by `kubectl`) generating error events, such as Failed to construct FQDN from Pod hostname and cluster domain, FQDN `long-FQDN` is too long (64 characters is the max, 70 characters requested). One way of improving user experience for this scenario is to create an [admission webhook controller](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) to control FQDN size when users create top level objects, for example, Deployment. --> -在 Linux 中，内核的主机名字段（`struct utsname` 的 `nodename` 字段）限定 -最多 64 个字符。 +在 Linux 中，内核的主机名字段（`struct utsname` 的 `nodename` 字段）限定最多 64 个字符。 如果 Pod 启用这一特性，而其 FQDN 超出 64 字符，Pod 的启动会失败。 Pod 会一直出于 `Pending` 状态（通过 `kubectl` 所看到的 `ContainerCreating`）， 并产生错误事件，例如 "Failed to construct FQDN from Pod hostname and cluster domain, FQDN `long-FQDN` is too long (64 characters is the max, 70 characters requested)." -（无法基于 Pod 主机名和集群域名构造 FQDN，FQDN `long-FQDN` 过长，至多 64 -字符，请求字符数为 70）。 +（无法基于 Pod 主机名和集群域名构造 FQDN，FQDN `long-FQDN` 过长，至多 64 个字符，请求字符数为 70）。 对于这种场景而言，改善用户体验的一种方式是创建一个 [准入 Webhook 控制器](/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks)， 在用户创建顶层对象（如 Deployment）的时候控制 FQDN 的长度。 @@ -409,9 +402,8 @@ following Pod-specific DNS policies. These policies are specified in the DNS 策略可以逐个 Pod 来设定。目前 Kubernetes 支持以下特定 Pod 的 DNS 策略。 这些策略可以在 Pod 规约中的 `dnsPolicy` 字段设置： -- "`Default`": Pod 从运行所在的节点继承名称解析配置。参考 - [相关讨论](/zh-cn/docs/tasks/administer-cluster/dns-custom-nameservers) - 获取更多信息。 +- "`Default`": Pod 从运行所在的节点继承名称解析配置。 + 参考[相关讨论](/zh-cn/docs/tasks/administer-cluster/dns-custom-nameservers)获取更多信息。 - "`ClusterFirst`": 与配置的集群域后缀不匹配的任何 DNS 查询（例如 "www.kubernetes.io"） 都将转发到从节点继承的上游名称服务器。集群管理员可能配置了额外的存根域和上游 DNS 服务器。 参阅[相关讨论](/zh-cn/docs/tasks/administer-cluster/dns-custom-nameservers) @@ -419,15 +411,15 @@ DNS 策略可以逐个 Pod 来设定。目前 Kubernetes 支持以下特定 Pod - "`ClusterFirstWithHostNet`"：对于以 hostNetwork 方式运行的 Pod，应显式设置其 DNS 策略 "`ClusterFirstWithHostNet`"。 - 注意：这在 Windows 上不支持。 有关详细信息，请参见[下文](#dns-windows)。 -- "`None`": 此设置允许 Pod 忽略 Kubernetes 环境中的 DNS 设置。Pod 会使用其 `dnsConfig` 字段 - 所提供的 DNS 设置。 +- "`None`": 此设置允许 Pod 忽略 Kubernetes 环境中的 DNS 设置。Pod 会使用其 `dnsConfig` + 字段所提供的 DNS 设置。 参见 [Pod 的 DNS 配置](#pod-dns-config)节。 +{{< note >}} -{{< note >}} "Default" 不是默认的 DNS 策略。如果未明确指定 `dnsPolicy`，则使用 "ClusterFirst"。 {{< /note >}} @@ -459,9 +451,12 @@ spec: +### Pod 的 DNS 配置 {#pod-dns-config} {{< feature-state for_k8s_version="v1.14" state="stable" >}} + -### Pod 的 DNS 配置 {#pod-dns-config} - -{{< feature-state for_k8s_version="v1.14" state="stable" >}} - Pod 的 DNS 配置可让用户对 Pod 的 DNS 设置进行更多控制。 `dnsConfig` 字段是可选的，它可以与任何 `dnsPolicy` 设置一起使用。 @@ -544,6 +535,7 @@ kubectl exec -it dns-example -- cat /etc/resolv.conf The output is similar to this: --> 输出类似于： + ``` nameserver 2001:db8:30::a search default.svc.cluster-domain.example svc.cluster-domain.example cluster-domain.example @@ -551,26 +543,36 @@ options ndots:5 ``` +## DNS 搜索域列表限制 {#dns-search-domain-list-limits} -By default, for Pod's DNS Config, Kubernetes allows at most 6 search domains and -a list of search domains of up to 256 characters. +{{< feature-state for_k8s_version="1.26" state="beta" >}} -If the feature gate `ExpandedDNSConfig` is enabled for the kube-apiserver and -the kubelet, it is allowed for Kubernetes to have at most 32 search domains and -a list of search domains of up to 2048 characters. + -#### 扩展 DNS 配置 {#expanded-dns-configuration} +Kubernetes 本身不限制 DNS 配置，最多可支持 32 个搜索域列表，所有搜索域的总长度不超过 2048。 +此限制分别适用于节点的解析器配置文件、Pod 的 DNS 配置和合并的 DNS 配置。 -{{< feature-state for_k8s_version="1.22" state="alpha" >}} +{{< note >}} + +早期版本的某些容器运行时可能对 DNS 搜索域的数量有自己的限制。 +根据容器运行环境，那些具有大量 DNS 搜索域的 Pod 可能会卡在 Pending 状态。 -如果启用 kube-apiserver 和 kubelet 的特性门控 `ExpandedDNSConfig`，Kubernetes 将可以有最多 32 个 -搜索域以及一个最多 2048 个字符的搜索域列表。 +众所周知 containerd v1.5.5 或更早版本和 CRI-O v1.21 或更早版本都有这个问题。 +{{< /note >}} -有关管理 DNS 配置的指导，请查看 -[配置 DNS 服务](/zh-cn/docs/tasks/administer-cluster/dns-custom-nameservers/) +有关管理 DNS 配置的指导， +请查看[配置 DNS 服务](/zh-cn/docs/tasks/administer-cluster/dns-custom-nameservers/)