文档中心

容器服务

请输入

DNS 组件

node-local-dns

node-local-dns 组件为容器服务集群提供节点级 DNS 缓存代理功能。本文介绍该组件的作用、核心资源以及安装与升级说明。

组件概述

node-local-dns 是容器服务提供的 DNS 组件，基于社区的 NodeLocal DNSCache 方案，通过在每个节点上部署 DNS 缓存代理，提升大规模集群下 DNS 服务发现的性能和稳定性。

在集群中安装组件后，系统会在 kube-system 命名空间下创建如下 Kubernetes 资源。

资源名称	资源类型	资源说明
node-local-dns	DaemonSet	节点上的 DNS 缓存代理，用于响应节点上 Pod 的 DNS 请求，提高集群 DNS 性能。
node-local-dns-admission	Deployment	提供 Pod NodeLocal dnsConfig 自动注入功能。

说明

上表中仅罗列出了该组件的主要资源，以及配置组件或对应功能时可能使用到的资源，方便您了解该组件的主要组成。其他的组件相关资源（例如 ConfigMap、Secret 等）不多做介绍，请以集群中的实际为准。

组件版本

关于组件的历史发布记录、各版本新增特性及优化说明等信息，详情请参见组件发布记录。

安装组件

参数	描述
默认不注入配置	是否为 Pod 默认注入 DNSConfig。包括：启用：默认不为 Pod 注入 DNSConfig。如有需求，可以通过为 Pod 或命名空间添加dns-config-injection=enable标签，实现注入。禁用：默认为 Pod 注入 DNSConfig。该访问为一般情况下的默认方案，即在集群中安装 node-local-dns 组件后，系统会为 Pod 注入 DNSConfig，优先使用本地 DNS 缓存。说明在禁用模式下，依然可以通过为 Pod 或命名空间添加dns-config-injection=disable标签，实现不注入 DNSConfig。更多详情，请参见使用 NodeLocal DNSCache 缓存代理。
节点标签选择	仅部署形态选择云服务器部署时，可配置该参数。开启后，可设置节点标签，组件的核心工作负载会被调度到带有该指定标签的节点上。
节点污点调度	仅部署形态选择云服务器部署时，可配置该参数。开启后，可设置污点容忍值，组件的核心工作负载允许被调度到带有指定污点的节点。
Admission 副本数	配置 node-local-dns-admission 资源的默认副本数。
资源配置	配置组件资源配额，包括 CPU 请求和上限、内存请求和上限。

升级组件

组件会不定期发布新版本以提供新特性或修复已知问题。当组件卡片提示有可用更新时，建议您及时进行升级。为确保业务平稳过渡，升级前请尽量安排在业务低峰期执行操作。关于升级的操作步骤和注意事项，请参见升级组件。

观测与告警

组件观测

node-local-dns 组件稳定性和性能直接影响组件功能正常使用和效果，建议您在集群中开启组件观测，帮助您实时掌握组件的健康度。详情请参见 DNS 服务观测。

开启组件观测后，您可以在控制台中查看组件预置观测看板。该看板主要展示了 node-local-dns 组件资源使用情况和健康度，包括 DNS 请求、DNS 错误率、DNS 转发等。支持设置查询的时间段，并指定刷新方式（手动刷新、自动刷新）。

配置告警

容器服务基于托管 Prometheus（VMP）提供完善的集群监控告警能力，您可以直接使用系统预置模板快速创建告警规则组，也可以基于业务实际需求自定义基于 PromQL 语句的告警规则，或在导出预置模板 YAML 后调整规则并沉淀为自定义告警模板，统一复用于多个集群。详情请参见：

预置告警模板由系统根据常见运维场景预置，适合首次建设告警体系或快速补充基础监控项，帮助您及时发现组件资源不足或运行异常。预置告警模板告警规则详情，请参见预置告警模板。