3. 升级窗口概念：定义升级窗口、窗口类型与策略选择

升级窗口是云原生网关在版本变更期间，允许流量切换、服务重启或配置重载的特定时间范围与操作集合。它定义了“何时变、怎么变、变多少”三个核心维度，是防护验证的前提条件。

3.1 升级窗口的定义与要素

一个完整的升级窗口由以下要素构成：

3.2 三种核心窗口类型

云原生网关支持三种升级窗口类型，分别对应不同的风险等级与流量切换策略。

3.2.1 滚动升级（Rolling Update）

按顺序逐个或逐批替换网关实例，新版本实例逐步接管流量，旧版本实例逐步下线。适用于无状态网关、配置变更或补丁升级。

• 优点：资源占用低，无需额外副本；对整体流量影响最小。
• 缺点：回滚速度慢（需反向滚动）；无法隔离灰度流量。
• 适用场景：常规补丁、安全修复、配置热更新。

3.2.2 蓝绿部署（Blue/Green Deployment）

同时维护两套完整的网关环境（蓝环境为当前版本，绿环境为新版本），通过流量路由规则一次性或逐步切换。适用于重大版本升级、架构重构。

• 优点：切换瞬间完成，回滚只需切回原环境；可提前验证绿环境。
• 缺点：资源成本翻倍；数据库或状态依赖需要兼容处理。
• 适用场景：大版本发布、协议升级、证书轮换。

3.2.3 金丝雀发布（Canary Release）

将小部分流量（如 5%–10%）导向新版本网关实例，观察运行指标后再逐步放量。适用于高风险变更、A/B 测试、渐进式交付。

• 优点：风险最低，可精确控制爆炸半径；支持自动回滚。
• 缺点：发布周期较长；需要精细的流量路由与指标监控能力。
• 适用场景：核心路由变更、插件升级、TLS 版本切换。

3.3 窗口策略选择矩阵

在实际生产环境中，选择哪种升级窗口类型需要综合考虑变更类型、业务影响、基础设施能力等因素。以下选择矩阵可作为决策参考：

3.4 窗口策略的自动化实现

在 Kubernetes 原生网关（如 Istio Ingress Gateway、Kong、APISIX）中，升级窗口策略通常通过 Deployment 策略、Service Mesh 流量路由 或 网关 Admin API 实现。以下是一个基于 Kubernetes Deployment 的滚动升级策略配置示例：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: api-gateway
spec:
  replicas: 5
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1          # 允许超出期望副本数的最大实例数
      maxUnavailable: 1    # 允许不可用实例的最大数量
  template:
    spec:
      containers:
      - name: gateway
        image: gateway:2.1.0
        readinessProbe:
          httpGet:
            path: /healthz
            port: 8080
          initialDelaySeconds: 5
          periodSeconds: 10

对于金丝雀发布，可以使用 Flagger、Argo Rollouts 或 Istio VirtualService 实现精细化的流量分割：

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: gateway-canary
spec:
  hosts:
  - api.example.com
  gateways:
  - gateway
  http:
  - match:
    - headers:
        x-canary:
          exact: "true"
    route:
    - destination:
        host: gateway-canary
        port:
          number: 80
      weight: 100
  - route:
    - destination:
        host: gateway-stable
        port:
          number: 80
      weight: 95
    - destination:
        host: gateway-canary
        port:
          number: 80
      weight: 5