容器与云原生 / 系统课时
理解 Istio 服务发现与主机匹配
理解 Istio 服务发现与主机匹配
Istio 路由生效前,必须先确定网格中有哪些可用服务,再判断请求主机匹配哪组规则以及最终转发到哪个上游。本课把 Kubernetes Service、EndpointSlice、VirtualService.spec.hosts 与 destination.host 串起来,重点识别短主机名造成的命名空间错配。
学习目标
- 说明 Kubernetes Service 与 EndpointSlice 如何构成 Istio 可用的服务和端点视图
- 区分
VirtualService.spec.hosts与route.destination.host的职责 - 判断短主机名在跨命名空间场景下为何容易指向错误服务
服务发现先决定可用上游
在 Kubernetes 环境中,Istio 从平台服务注册信息中获得 Service 及其后端端点,并据此生成数据面需要的服务发现配置。以 shop 命名空间中的 reviews 为例,其完整服务名通常是 reviews.shop.svc.cluster.local,可用后端则来自与该 Service 关联的 EndpointSlice。
Service 定义稳定的服务身份、端口以及通常用于选择工作负载的 selector;EndpointSlice 记录实际可达的后端地址。它们解决“有哪些上游可以访问”,而按 Header、路径或权重进行 HTTP 分流属于 Istio 路由配置的职责。外部服务若需要纳入 Istio 服务注册表,可以通过 ServiceEntry 显式声明主机、端口以及解析方式或端点。

hosts 与 destination.host 分工不同
VirtualService.spec.hosts 声明这组路由规则适用于哪些目标主机,也就是请求首先要被识别成发往哪个服务或域名。对于绑定到 Gateway 的 VirtualService,hosts 还需要与 Gateway 接受的主机范围相容。某条 HTTP 路由命中后,route.destination.host 才指定实际转发到哪个服务注册表中的目标。
下面是片段示例,假设 VirtualService 与 reviews Service 都位于 shop 命名空间:
apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
name: reviews-route
namespace: shop
spec:
hosts:
- reviews.shop.svc.cluster.local
http:
- route:
- destination:
host: reviews.shop.svc.cluster.local这段配置表示:发往 reviews.shop.svc.cluster.local 且命中默认 HTTP 路由的流量,继续转发到同名服务。这里没有定义 subset,因此由该服务当前可用端点承接流量。排查时要分别确认请求目标、spec.hosts 和 destination.host,不能把它们当成同一个字段的重复写法。
短主机名按配置命名空间解析
Istio 允许在这些 host 字段中使用 reviews 这样的短名,但短名不是跨命名空间的全局别名。对于 Kubernetes,Istio 会根据配置规则所在的命名空间补全短名。例如 VirtualService 位于 default 时,其中的 reviews 会被解释为 reviews.default.svc.cluster.local,不会因为 shop 中存在同名 Service 就自动指向它。
可以直接核对目标 Service 对应的完整名称:
kubectl -n shop get service reviews -o jsonpath='{.metadata.name}{"."}{.metadata.namespace}{".svc.cluster.local"}{"\n"}'预期输出:
reviews.shop.svc.cluster.local实际集群中的服务名或命名空间可能不同,应以命令结果为准。若这个名称与 VirtualService 中按短名推导出的名称不一致,就应先修正主机引用,而不是继续调整路由权重。
按服务身份逐层定位
遇到“Service 存在,但流量没有按 VirtualService 规则走”时,可以按服务身份从注册信息向路由规则逐层检查:
- 确认目标 Service 存在,并检查关联的 EndpointSlice 是否包含可用端点。
- 确认客户端实际访问的服务主机和命名空间符合预期。
- 确认
VirtualService.spec.hosts覆盖该请求对应的目标主机。 - 确认命中路由中的
destination.host指向正确的注册服务,而不是另一个命名空间中的同名服务。
服务发现回答“哪些上游存在以及端点在哪里”,hosts 回答“这组规则处理哪个目标主机的流量”,destination.host 回答“规则命中后把流量发往哪里”。把这三层身份分别核对,比直接修改权重、重试或超时配置更容易定位主机匹配问题。