externalname 是 kubernetes 中通过 dns cname 实现外部服务别名映射的轻量方式，不经过 kube-proxy 或集群网络，仅依赖 coredns 解析；其 spec.clusterip 恒为 none，不支持 selector 和端口映射，externalname 必须为合法 dns 域名。
ExternalName 是 Kubernetes 中最轻量、最直接的访问外部服务的方式，它不创建代理、不占用端口、不走 iptables/ipvs 转发，纯粹靠 DNS CNAME 实现服务别名映射。只要集群 DNS（通常是 CoreDNS）正常工作，Pod 就能像调用内部服务一样访问外部域名。
ExternalName 的核心原理
它本质是一条 DNS 记录：当你定义一个 ExternalName 类型的 Service，CoreDNS 会为该 Service 名生成一条 CNAME 记录，指向你指定的 externalName 域名。Pod 发起请求时，DNS 解析直接返回目标域名，后续连接由客户端（如 curl、Redis client）自行完成，流量完全绕过 kube-proxy 和集群网络。
- 不涉及 ClusterIP，所以
spec.clusterIP始终为None - 不支持
selector，也不需要关联 Pod 或 Endpoints - 端口信息仅用于文档和客户端提示，不参与转发或改写；实际连接端口由客户端决定
- externalName 必须是合法 DNS 名称（如
redis-prod.example.com），不能是 IP 地址或带协议前缀（如http://）
标准配置与常见写法
以下是最常用、最稳妥的 YAML 模板：
apiVersion: v1
kind: Service
metadata:
name: redis-external
namespace: app-team
spec:
type: ExternalName
externalName: redis-prod.mycompany.com
ports:
- name: redis
port: 6379
-
name和namespace决定了该服务在集群内的可访问路径，例如 Pod 可通过redis-external.app-team.svc.cluster.local或同命名空间内简写redis-external访问 -
externalName必须可被集群 DNS 解析（建议提前用nslookup或dig验证） -
ports字段非必需，但强烈建议填写——它让开发者一眼看清预期端口，部分 SDK（如 Spring Cloud Kubernetes）也会读取该字段做自动配置
跨命名空间调用与环境解耦
这是 ExternalName 最实用的场景之一：避免硬编码全域名。比如中间件团队维护的 Redis 在 middleware 命名空间，业务应用在 business 命名空间。
- 错误做法：业务代码里写死
redis-service.middleware.svc.cluster.local - 正确做法：在
business命名空间创建 ExternalName Service：
apiVersion: v1 kind: Service metadata: name: redis namespace: business spec: type: ExternalName externalName: redis-service.middleware.svc.cluster.local
这样业务 Pod 只需连接 redis，迁移中间件或更换命名空间时，只需更新这一处 externalName 值，所有调用方零修改。
注意事项与避坑点
-
不支持端口映射：ExternalName 不处理端口转换。若外部服务监听 6380，客户端必须显式指定端口（如
redis://redis:6380），Service 中的port: 6380不会自动生效 -
无法解析 IP 地址字符串：externalName 不能设为
192.168.1.100或10.0.0.1，否则 CoreDNS 会忽略该记录。如需直连 IP，请改用 Headless Service + Endpoints - DNS 缓存影响：CoreDNS 默认缓存 CNAME 结果（TTL 由上游 DNS 决定）。若外部域名变更 IP，可能需等待缓存过期或手动重启 CoreDNS Pod
- 无健康检查/重试逻辑：失败完全由客户端承担，Kubernetes 不介入。生产环境建议搭配客户端重试、超时和熔断机制
