4. 灰度发布架构设计：整体架构分层与路由策略

高频行情数据规则灰度发布的核心在于可控、可观测、可回滚。架构设计需将流量从接入到分发的全链路进行分层解耦，确保灰度规则仅影响指定流量，不影响生产主链路。本节从整体架构分层、灰度流量标识、灰度路由策略三个维度展开。

4.1 整体架构分层：接入层、规则层、分发层

架构采用三层解耦设计，每层职责清晰，灰度逻辑集中在规则层，接入层和分发层仅做流量标识与转发，不感知规则细节。

4.2 灰度流量标识：标签体系与传递机制

灰度流量标识是路由决策的依据。标识必须在接入层完成，并随行情数据在整个链路中透传，不得丢失或篡改。

4.2.1 标识维度

• 用户维度：按用户ID、机构ID、交易员ID进行灰度分组，适用于面向特定客户的规则验证。
• 行情维度：按合约代码、产品类型、交易所源进行灰度，适用于新品种或新交易所接入测试。
• 时间维度：按时间段（如开盘前30分钟、特定交易日）进行灰度，适用于时间敏感型规则。
• 随机采样：按百分比随机抽取流量，适用于大规模A/B测试。

4.2.2 标识传递机制

4.3 灰度路由策略：规则匹配与分发决策

灰度路由策略决定了灰度流量在规则层和分发层如何被处理。策略需支持动态调整，无需重启服务。

4.3.1 路由策略类型

• 白名单路由：仅对白名单内的流量执行灰度规则，其余走生产规则。适用于小范围验证。
• 百分比路由：按流量百分比随机路由到灰度规则组。适用于A/B测试和容量评估。
• 条件路由：基于行情属性（如合约、价格区间、买卖方向）进行路由。适用于特定场景规则验证。
• 复合路由：组合多种策略，如“白名单 + 百分比”或“条件 + 时间窗口”。适用于复杂灰度场景。

4.3.2 路由决策流程

1. 标签解析：从行情消息头或上下文中提取灰度标签。
2. 策略匹配：按优先级依次匹配白名单、条件、百分比策略。
3. 规则选择：命中灰度策略的流量进入灰度规则链，否则进入生产规则链。
4. 分发决策：灰度流量路由到灰度分发通道，生产流量路由到生产分发通道。
5. 监控记录：记录路由决策结果，用于灰度效果评估和问题排查。

4.4 灰度发布配置示例

以下是一个基于YAML的灰度发布配置示例，展示了策略定义、规则映射和通道配置。

# gray_release_config.yaml
gray_release:
  enabled: true
  # 灰度流量标识定义
  traffic_tags:
    - name: "user_whitelist"
      type: "user_id"
      values: ["10001", "10002", "10005"]
    - name: "contract_test"
      type: "contract_code"
      values: ["BTC.USDT", "ETH.USDT"]
    - name: "percentage_5pct"
      type: "random_sample"
      rate: 0.05  # 5% 流量
  # 路由策略（按优先级）
  routing_policy:
    - priority: 1
      match: "user_whitelist"
      target: "gray_rule_chain_v2"
    - priority: 2
      match: "contract_test"
      target: "gray_rule_chain_v2"
    - priority: 3
      match: "percentage_5pct"
      target: "gray_rule_chain_v2"
    - default: "production_rule_chain"
  # 分发通道
  channels:
    gray:
      topic: "marketdata.gray"
      group: "gray_consumer_group"
      qos: 1
    production:
      topic: "marketdata.prod"
      group: "prod_consumer_group"
      qos: 2

4.5 灰度发布架构设计检查清单