容器与云原生 / 系统课时

定义版本子集与目标端点

定义版本子集与目标端点

一个 Kubernetes Service 可以同时发现多个版本,Istio 再用 DestinationRule 的 subset 按标签切分已发现端点。本文保留 v1/v2 实验,重点理清 Service、工作负载标签与 subset 的关系,并通过 VirtualService 和真实请求验证最终落点。

学习目标

  • 能解释 Service、工作负载标签和 subset 的映射关系。
  • 能定义 v1/v2 两个 subset,并在 VirtualService 中选择目标版本。
  • 能通过实际请求确认路由最终落到正确端点。

subset 如何映射到端点

DestinationRule 的 subsets[].labels 不会创建 Pod,也不会改变 Kubernetes Service 的发现结果。Istio 先获得目标 Service 的端点集合,再按标签筛选出 subset;只有当 VirtualService 的 destination 显式指定 subset 时,请求才会被限制到对应版本集合。

Service、subset 与版本端点的映射关系

常见做法是让 Kubernetes Service 只按稳定标签(例如 app=catalog)选择所有版本,而把 version=v1、version=v2 留给 Istio subset。这样逻辑服务地址保持不变,版本切换只发生在网格路由层。

准备两个可发现版本

下面创建独立实验命名空间,并启动两个返回不同文本的 Pod。命名空间开启自动 sidecar 注入;两个 Pod 都带 app=catalog,但 version 不同。

bash
kubectl create namespace mesh-lab
kubectl label namespace mesh-lab istio-injection=enabled --overwrite
kubectl run catalog-v1 -n mesh-lab \
  --image=hashicorp/http-echo:1.0.0 \
  --labels=app=catalog,version=v1 -- \
  -listen=:8080 -text=v1
kubectl run catalog-v2 -n mesh-lab \
  --image=hashicorp/http-echo:1.0.0 \
  --labels=app=catalog,version=v2 -- \
  -listen=:8080 -text=v2
kubectl expose pod catalog-v1 -n mesh-lab \
  --name=catalog --port=80 --target-port=8080 \
  --selector=app=catalog

预期输出

text
namespace/mesh-lab created
namespace/mesh-lab labeled
pod/catalog-v1 created
pod/catalog-v2 created
service/catalog exposed

这里的 Service selector 故意不包含 version,否则 Kubernetes 会先排除某个版本,Istio 的 subset 也就没有完整端点集合可筛选。

定义 subset 并选择版本

创建 routing.yaml。DestinationRule 为同一个 host 定义 v1/v2 两个 subset;VirtualService 把 /v2 请求改写为 / 后送往 v2,其余请求固定到 v1。

yaml
apiVersion: networking.istio.io/v1
kind: DestinationRule
metadata:
  name: catalog-versions
  namespace: mesh-lab
spec:
  host: catalog.mesh-lab.svc.cluster.local
  subsets:
    - name: v1
      labels:
        version: v1
    - name: v2
      labels:
        version: v2
---
apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
  name: catalog-route
  namespace: mesh-lab
spec:
  hosts:
    - catalog.mesh-lab.svc.cluster.local
  http:
    - match:
        - uri:
            prefix: /v2
      rewrite:
        uri: /
      route:
        - destination:
            host: catalog.mesh-lab.svc.cluster.local
            subset: v2
            port:
              number: 80
    - route:
        - destination:
            host: catalog.mesh-lab.svc.cluster.local
            subset: v1
            port:
              number: 80

应用配置。

bash
kubectl apply -f routing.yaml

预期输出

text
destinationrule.networking.istio.io/catalog-versions created
virtualservice.networking.istio.io/catalog-route created

DestinationRule.spec.host、VirtualService.spec.hosts 与 route destination 的 host 最好保持同一服务身份,避免短名称在不同命名空间中解析成不同服务,造成“规则存在但 subset 不生效”。

从网格内验证目标端点

创建一个带 sidecar 的客户端 Pod 并等待就绪,然后分别请求默认路径和 /v2。代码块中的 URL 必须是原始 HTTP URL,不能写成 Markdown 链接,否则 curl 会把方括号和括号当作参数内容。

bash
kubectl run client -n mesh-lab \
  --image=curlimages/curl:8.10.1 \
  --restart=Never --command -- sleep 3600
kubectl wait -n mesh-lab --for=condition=Ready pod/client --timeout=90s
kubectl exec -n mesh-lab client -c client -- sh -c \
  'curl -s http://catalog.mesh-lab.svc.cluster.local/; echo; curl -s http://catalog.mesh-lab.svc.cluster.local/v2'

预期输出

text
pod/client created
pod/client condition met
v1
v2

如果某个 subset 的标签没有匹配任何可用端点,请求可能返回 503。此时先检查目标 Pod 的 version 标签和 Service 的端点发现,再检查 subset 名称是否与 VirtualService 中的 destination.subset 完全一致。subset 是“已发现端点上的命名过滤器”,不是独立服务,也不会自动参与路由。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义版本子集与目标端点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通