未完成撰写的文档，因为版本迭代过快，跟新版本会存在一定差异，后续会进行补充完善。

本任务使用 samples/moviereview 示例。

1. 创建命名空间

kubectl create ns moviereview
kubectl label namespace moviereview dubbo-injection=enabled

2. 部署服务

kubectl apply -f samples/moviereview/deployment.yaml

配置灰度流量

同一个父 Service 只保留本任务的 HTTPRoute。如果刚执行过流量路由任务，旧的 reviews-routing 也会绑定 reviews，grpc-outbound 会继续看到旧权重。

kubectl get httproute -n moviereview
kubectl -n moviereview delete httproute moviepage-routing reviews-routing

将 reviews 的 63% 流量分配到 v1，37% 流量分配到 v2：

cat <<EOF | kubectl apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: reviews-canary
  namespace: moviereview
spec:
  parentRefs:
  - group: ""
    kind: Service
    name: reviews
    port: 9080
  rules:
  - backendRefs:
    - name: reviews-v1
      port: 9080
      weight: 63
    - name: reviews-v2
      port: 9080
      weight: 37
EOF

这里没有写 matches，因此该规则是默认兜底规则。dubbod 默认提供 proto.XDSTestService/ForwardHTTP 测试入口，用来按控制面下发的路由发送真实请求。

验证

先把 17171 转发到本地：

kubectl -n dubbo-system port-forward deploy/dubbod 17171:17171

确认真实请求进入 reviews v1 和 reviews v2：

grpcurl -plaintext \
  -d '{"url":"xds:///reviews.moviereview.svc.cluster.local:9080","count":5}' \
  :17171 proto.XDSTestService/ForwardHTTP | jq -r '.output | join("")'

预期会连续打印真实响应，例如：

reviews v1
reviews v2
reviews v1
reviews v1
reviews v2

也可以刷新 frontend 页面验证。页面里的 moviepage 会通过本地 reviews-grpc-outbound 调用 reviews，连续刷新时版本应只在 v1 和 v2 之间变化。

如果要观察热更新，再指定请求次数和间隔；这只是采样参数，不是路由配置。先在一个终端持续发请求，另一个终端里更新 HTTPRoute 权重。同一个 ForwardHTTP 请求会继续使用同一条 xDS stream，后续请求会按新权重切换。

grpcurl -plaintext \
  -d '{"url":"xds:///reviews.moviereview.svc.cluster.local:9080","count":200,"requestInterval":"200ms"}' \
  :17171 proto.XDSTestService/ForwardHTTP | jq -r '.output | join("")'

把流量改成 v1 20%、v2 80%：

kubectl -n moviereview patch httproute reviews-canary --type='merge' -p '
{
  "spec": {
    "rules": [
      {
        "backendRefs": [
          {
            "name": "reviews-v1",
            "port": 9080,
            "weight": 20
          },
          {
            "name": "reviews-v2",
            "port": 9080,
            "weight": 80
          }
        ]
      }
    ]
  }
}'

清理

kubectl -n moviereview delete httproute reviews-canary
kubectl delete -f samples/moviereview/deployment.yaml
kubectl delete ns moviereview