3. 灰度发布核心原则：渐进式、可观测、可回滚、最小影响面、自动化

高频行情API的灰度发布并非简单的流量切换，而是一套严谨的风险控制体系。其核心原则可概括为五个关键词：渐进式、可观测、可回滚、最小影响面、自动化。这五项原则共同构成了灰度发布的“安全网”，确保在引入新版本API时，即使出现异常，也能将损失控制在最小范围，并快速恢复。

3.1 五项原则详解

3.2 灰度发布决策流程（SVG）

下图展示了基于五项原则的灰度发布自动化决策流程。系统通过持续监控灰度组的健康指标，自动判断是否继续扩大灰度比例或触发回滚。

3.3 灰度策略与影响面控制

“最小影响面”原则要求灰度策略必须具备高度的灵活性。以下是高频行情API中常用的几种灰度策略及其影响范围对比：

3.4 自动化与可观测的协同（SVG）

自动化并非简单的“一键发布”，而是与可观测深度绑定的闭环系统。下图展示了自动化灰度发布中，监控指标如何驱动决策引擎。

3.5 自动化灰度发布脚本示例

以下是一个基于Shell和curl的简化版灰度发布脚本片段，展示了自动化流量切换与健康检查的逻辑。实际生产环境中，建议使用更成熟的发布平台（如Spinnaker、Argo Rollouts）。

#!/bin/bash
# 自动化灰度发布示例 - 高频行情API
# 依赖：jq, curl, kubectl (或直接调用网关API)

GATEWAY_API="http://api-gateway:8080/admin"
NEW_VERSION="v2.1.0"
OLD_VERSION="v2.0.9"
STEP=5   # 每次扩大5%

# 1. 初始灰度：分配5%流量到新版本
echo "=== 步骤1: 分配 ${STEP}% 流量到新版本 ==="
curl -X POST "${GATEWAY_API}/traffic/shift" \
  -H "Content-Type: application/json" \
  -d '{"new_version": "'${NEW_VERSION}'", "old_version": "'${OLD_VERSION}'", "percentage": '${STEP}'}'

# 2. 健康检查循环
for i in {1..6}; do
  echo "=== 等待30秒进行第 ${i} 轮健康检查 ==="
  sleep 30

  # 采集新版本指标
  METRICS=$(curl -s "http://monitor:9090/api/v1/query?query=histogram_quantile(0.99,rate(api_latency_seconds_bucket{version=\"${NEW_VERSION}\"}[1m]))")
  P99_LATENCY=$(echo $METRICS | jq -r '.data.result[0].value[1]')
  ERROR_RATE=$(curl -s "http://monitor:9090/api/v1/query?query=sum(rate(api_errors_total{version=\"${NEW_VERSION}\"}[1m]))/sum(rate(api_requests_total{version=\"${NEW_VERSION}\"}[1m]))" | jq -r '.data.result[0].value[1]')

  echo "新版本 P99延迟: ${P99_LATENCY}s, 错误率: ${ERROR_RATE}"

  # 3. 决策：是否继续扩大
  if (( $(echo "$P99_LATENCY > 0.05" | bc -l) )) || (( $(echo "$ERROR_RATE > 0.001" | bc -l) )); then
    echo "!!! 指标异常，触发自动回滚 !!!"
    curl -X POST "${GATEWAY_API}/traffic/rollback" \
      -H "Content-Type: application/json" \
      -d '{"version": "'${OLD_VERSION}'"}'
    exit 1
  fi

  # 4. 扩大灰度比例
  STEP=$((STEP + 10))
  [ $STEP -gt 100 ] && STEP=100
  echo "=== 扩大流量到 ${STEP}% ==="
  curl -X POST "${GATEWAY_API}/traffic/shift" \
    -H "Content-Type: application/json" \
    -d '{"new_version": "'${NEW_VERSION}'", "old_version": "'${OLD_VERSION}'", "percentage": '${STEP}'}'

  if [ $STEP -eq 100 ]; then
    echo "=== 全量发布完成 ==="
    break
  fi
done