云原生【免费下载链接】external-dnsConfigure external DNS servers dynamically from Kubernetes resources项目地址https://gitcode.com/gh_mirrors/ex/external-dns点击查看免费下载本篇指南聚焦 external-dns 的pod数据源Source讲解它如何将 KubernetesPod资源转换为 DNS 记录涵盖--pod-source-domain默认域名机制、--ignore-non-host-network-pods过滤行为、基于注解annotation的 FQDN 解析以及面向无 SNAT 本地集群的“全量 Pod PTR 反解”实战配置组合。读完本文你将掌握 pod source 的全部核心命令行参数、底层端点生成逻辑与可复用的部署方案。什么是 Pod SourcePod source 是 external-dns 内置的数据源之一其职责是根据 KubernetesPod资源生成 DNS 记录。启用方式很简单在 external-dns 启动参数中通过--sourcepod指定./external-dns --sourcepod --provider...从源码结构看pod source 的实现位于 source/pod.go其中podSource结构体同时维护了 Pod 与 Node 两个 informersource/pod.go。Pod informer 负责读取 Pod 列表及其注解Node informer 则在需要把记录解析到节点地址时使用。该 source 标注的能力维度source/pod.go包括资源类型Pod过滤方式annotation、label命名空间支持 all全部与 single单个支持 FQDN 模板fqdn-template、事件驱动events不涉及 provider 特有逻辑provider-specificfalse也就是说pod source 是纯粹的 Kubernetes 核心资源驱动型数据源不依赖任何特定 DNS 厂商。默认行为仅考虑使用 host networking 的 PodPod source 的默认行为有一个重要前提只处理启用了 host networkinghostNetwork: true的 Pod。这是因为 Pod 自身的 IP 在集群内部网络中往往不可被外部 DNS 直接引用而 host networking 模式下 Pod 共享节点网络栈其地址才具有集群外的可达性。你可以通过--ignore-non-host-network-pods选项覆盖这一默认行为——加上该选项后非 host networking 的 Pod 将被忽略。该参数在 pkg/apis/externaldns/types.go 中注册默认值为false完整定义见 docs/flags.md--[no-]ignore-non-host-network-pods Ignore pods not running on host network when using pod source (default: false)在实现层面这个开关的判定逻辑位于addPodEndpointsToEndpointMap函数source/pod.goif ps.ignoreNonHostNetworkPods !pod.Spec.HostNetwork { log.Debugf(skipping pod %s. hostNetworkfalse, pod.Name) return }即只有当ignoreNonHostNetworkPodstrue且pod.Spec.HostNetworkfalse时才跳过该 Pod并输出skipping pod ... hostNetworkfalse的调试日志。source/pod_test.go 中的测试用例如mixed valid and hostNetworkfalse pods、when ignoreNonHostNetworkPodsfalse, no skip logs should be generated验证了两种开关状态下的行为差异。三种行为模式对比配置hostNetworktrue 的 PodhostNetworkfalse 的 Pod默认不加任何选项被处理被处理--ignore-non-host-network-pods被处理被忽略产生 skip 日志为 Pod 指定 FQDN 的三种途径Pod source 生成 DNS 记录时目标域名FQDN可以来自三个互不冲突的来源最终端点会通过endpoint.MergeEndpoints合并去重source/pod.go注解annotation默认情况下pod source 从 Pod 注解中查找关联的 FQDN相关注解键定义于 source/annotations/annotations.goexternal-dns.alpha.kubernetes.io/hostname为该 Pod 注册指定主机名。若未设置target注解记录将解析到该 Pod 所在节点的地址见下文“节点地址解析”若设置了target注解则解析到 target 指定的地址。external-dns.alpha.kubernetes.io/internal-hostname注册内部主机名默认解析到 Pod 自身的 IPpod.Status.PodIP。external-dns.alpha.kubernetes.io/target显式指定记录的目标地址可多个逗号分隔。external-dns.alpha.kubernetes.io/ttl指定记录 TTL。 注解整体说明可参考 docs/annotations/annotations.md。--pod-source-domain默认域名为所有 Pod 统一生成 FQDN见下一节。FQDN 模板fqdn-template通过模板引擎批量生成对应podSource.templateEnginesource/pod.go支持{{.Name}}等占位符。节点地址解析规则当使用hostname注解且未指定target时记录解析到节点地址。addPodNodeEndpointsToEndpointMapsource/pod.go通过 Node informer 读取pod.Spec.NodeName对应节点遍历node.Status.Addresses遵循如下规则NodeExternalIP类型的地址直接采用NodeInternalIP类型的地址仅在记录类型为 AAAAIPv6时采用——源码注释解释了原因IPv6 地址虽被标记为 NodeInternalIP但同样可被外部使用source/pod.go。记录类型由endpoint.SuitableType(address)根据地址是 IPv4A还是 IPv6AAAA自动判定。使用默认域名--pod-source-domain默认情况下 pod source 依赖 Pod 注解来发现 FQDN这对于大规模、无需逐个打注解的场景并不友好。此时可以使用--pod-source-domain选项为所有 Pod 自动构建 FQDN。例如启动参数./external-dns --sourcepod --pod-source-domainexample.org名为test-pod的 Pod 会被注册为test-pod.example.org。该选项注册于 pkg/apis/externaldns/types.go默认值为空字符串完整定义见 docs/flags.md--pod-source-domain Domain to use for pods records (optional)其底层实现位于addPodSourceDomainEndpointssource/pod.go核心逻辑即为字符串拼接domain : pod.Name . ps.podSourceDomain在未设置target注解时podName.podSourceDomain解析到 Pod 自身的 IPpod.Status.PodIP记录类型根据 IP 版本自动判定若 Pod 带有target注解则优先解析到注解指定的目标地址。值得注意的一个细节--pod-source-domain与注解机制可以同时生效。addPodEndpointsToEndpointMap中依次处理 internal-hostname、hostname、kops 兼容注解与 pod-source-domain 四类端点source/pod.go最终所有记录都会被合并输出因此同一个 Pod 可以同时拥有注解定义的 FQDN 与默认域名生成的 FQDN。实战场景全量注册 Pod 及其 PTR 记录文档 docs/sources/pod.md 给出了一个将这些选项组合使用的典型场景当你在本地on-premiseKubernetes 集群中运行且 Pod 网络未启用 SNAT时外部流量到达集群后无法通过 Pod IP 快速回溯到对应工作负载。此时可以把所有 Pod 连同其 PTR 记录一起注册到 DNS使集群外的流量来源可以通过nslookup或dig命令对 Pod IP 做反向解析迅速定位到对应的工作负载。这在运行大量 Kubernetes 集群时尤其有用。反向解析PTR的原理Pod IP 形如10.0.0.5其 PTR 记录位于5.0.0.10.in-addr.arpa。因此要让全部 Pod 支持反解需要同时把正向域名与反向 in-addr.arpa 域名都纳入 DNS 管辖。完整配置组合如下./external-dns \ --domain-filterexample.org \ --domain-filter10.0.0.in-addr.arpa \ --sourcepod \ --pod-source-domainexample.org \ --create-ptr \ --rfc2136-zoneexample.org \ --rfc2136-zone10.0.0.in-addr.arpa各参数职责拆解参数作用--domain-filterexample.org只管理example.org域下的记录过滤掉无关域名--domain-filter10.0.0.in-addr.arpa同时管理10.0.0.0/24网段对应的反向查询域--sourcepod启用 pod source--pod-source-domainexample.org为每个 Pod 生成podName.example.org正向记录--create-ptr为每条记录同时创建对应的 PTR 反向记录--rfc2136-zoneexample.org指定正向记录写入的 RFC2136BIND 等DNS 区域--rfc2136-zone10.0.0.in-addr.arpa指定反向 PTR 记录写入的反向区域其中--create-ptr与--rfc2136-zone属于 rfc2136 provider 的能力--create-ptr让 external-dns 在生成 A/AAAA 记录的同时派生 PTR 记录而重复声明两个--rfc2136-zone则保证正向与反向记录被正确路由到对应的 zone 文件。有关 rfc2136 provider 的部署细节可参考 docs/tutorials/rfc2136.md 与 docs/advanced/ptr-records.md。运行效果示意假设集群中有名为web-0、Pod IP 为10.0.0.5的 Pod上述配置生效后 DNS 中会同时出现正向记录web-0.example.org. A 10.0.0.5反向记录5.0.0.10.in-addr.arpa. PTR web-0.example.org.此时在集群外执行nslookup 10.0.0.5 dig -x 10.0.0.5即可将来源 IP 反解为具体的工作负载名快速完成流量溯源。从源码看端点的生成链路理解 pod source 的完整工作流有助于排障与二次开发其核心链路如下source/pod.go启动阶段NewPodSource创建共享 informer factory注册 Pod 与 Node informer并为 Pod informer 挂载注解过滤器IndexSelectorWithAnnotationFilter、标签选择器IndexSelectorWithLabelSelector与控制器匹配条件IndexSelectorWithConditions同时注册事件处理器等待本地缓存同步完成后返回podSourcesource/pod.go。端点收集阶段Endpoints从 informer indexer 中列出全部 Pod对每个 Pod 依次执行endpointsFromPodAnnotations解析 Pod 注解internal-hostname / hostname / kops 兼容注解 / pod-source-domain生成端点source/pod.gotemplateEngine.ApplyFQDNTargetTemplate应用 FQDN/目标模板templateEngine.CombineWithEndpoints合并模板生成的端点endpoint.AttachRefObject为端点附加对象引用供事件系统使用source/pod.go。合并去重endpoint.MergeEndpoints汇总所有 Pod 的端点交由后续 plan/registry/provider 阶段处理。在生成端点时TTL 统一通过annotations.TTLFromAnnotations(pod.Annotations, fmt.Sprintf(pod/%s, pod.Name))从注解读取source/pod.go未设置时采用 provider 的默认 TTL。此外pod source 还保留了对kops-dns-controller兼容模式的支持当--compatibilitykops-dns-controller时会额外读取 kops 风格的 hostname 注解并生成对应记录source/pod.go。小结与验证建议Pod source 是 external-dns 中唯一直接以工作负载资源而非负载均衡/路由资源为驱动的核心数据源适用于需要为每个 Pod 建立可解析身份的场景。使用时把握三条主线即可过滤用--ignore-non-host-network-pods控制是否只关注 host networking Pod命名注解external-dns.alpha.kubernetes.io/hostname/internal-hostname逐 Pod 定制--pod-source-domain全局兜底组合结合--create-ptr与反向 zone 实现 Pod IP 的反向溯源。如需验证行为可直接运行仓库中的单元测试例如 source/pod_test.go 的TestPodSource覆盖了注解解析、节点地址解析、ignoreNonHostNetworkPods跳过逻辑与 skip 日志输出pkg/apis/externaldns/types_test.go 则验证了--ignore-non-host-network-pods与--pod-source-domainexample.org等命令行参数的解析。建议在测试环境先用 inmemory provider--providerinmemory验证生成的记录集合再切换到真实 DNS provider。赞分享云原生【免费下载链接】external-dnsConfigure external DNS servers dynamically from Kubernetes resources项目地址https://gitcode.com/gh_mirrors/ex/external-dns点击查看免费下载相关推荐微信聊天记录永久保存3步打造你的数字记忆保险箱微信聊天记录永久保存3步打造你的数字记忆保险箱 你是否曾因手机丢失、系统升级或误操作而丢失珍贵的微信聊天记录那些与家人的温馨对话、朋友的重要约定、工作的关键云原生终极界面字体解决方案Source Sans 3 专业使用指南终极界面字体解决方案Source Sans 3 专业使用指南 还在为现代用户界面字体选择而烦恼吗面对琳琅满目的字体库你是否曾因字体渲染不清晰、字重选择有限云原生构建专属数字人交互平台从零到一的轻量化实现方案构建专属数字人交互平台从零到一的轻量化实现方案 你是否曾想过拥有一个能与用户实时对话、表情生动的数字人助手在AI技术快速发展的今天打造个性化的数字人交互平云原生上一篇Qwen3-1.7B-FP8数据预处理训练数据格式要求详解下一篇Qwen2.5-7B-Instruct-GPTQ-Int4数学推理能力测试量化模型在数学任务上的表现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考