envoy 中文参考文档
  • 首页
  • 简介
    • Envoy是什么
    • 架构介绍
      • 术语
      • 线程模型
      • 监听器
      • L3/L4网络过滤器
      • HTTP连接管理
      • HTTP过滤器
      • HTTP路由
      • gRPC
      • WebSocket支持
      • 集群管理
      • 服务发现
      • 健康检查
      • 连接池
      • 负载均衡
      • 异常检测
      • 熔断
      • 全局限速
      • TLS
      • 统计
      • 运行时配置
      • 跟踪
      • TCP代理
      • 访问日志
      • MongoDB
      • DynamoDB
      • Redis
      • 热重启
      • 动态配置
      • 初始化
      • 逐出
      • 脚本
    • 部署
    • 业界对比
    • 获得帮助
    • 历史版本
  • 编译安装
    • 编译
    • 参考配置
    • 演示沙箱
      • 前端代理
      • Zipkin跟踪
      • Jaeger跟踪
      • gRPC桥接
      • 构建Envoy Docker镜像
    • 工具
  • 配置参考
    • V1 API 概述
    • V2 API 概述
    • 监听器
    • 网络过滤器
      • TLS客户端身份认证
      • Echo
      • Mongo代理
      • 速率限制
      • Redis代理
      • TCP代理
    • HTTP连接管理器
      • 路由匹配
      • 流量转移/分流
      • HTTP头部操作
      • HTTP头部清理
      • 统计
      • 运行时设置
      • 路由发现服务
    • HTTP过滤器
      • 缓存
      • CORS过滤器
      • 故障注入
      • DynamoDB
      • gRPC HTTP/1.1 桥接
      • gRPC-JSON 转码过滤器
      • gRPC-Web 过滤器
      • 健康检查
      • 速率限制
      • 路由
      • Lua
    • 集群管理
      • 统计
      • 运行时设置
      • 集群发现服务
      • 健康检查
      • 熔断
    • 访问日志
    • 限速服务
    • 运行时配置
    • 路由表检查工具
  • 运维管理
    • 命令行选项
    • 热重启
    • 管理接口
    • 统计概述
    • 运行时配置
    • 文件系统
  • 自定义扩展示例
  • V1 API参考
    • 监听器
    • 网络过滤器
      • TLS客户端身份认证
      • Echo
      • HTTP连接管理
      • Mongo代理
      • 速率限制
      • Redis代理
      • TCP代理
    • HTTP路由配置
      • 虚拟主机
      • 路由
      • 虚拟集群
      • 速率限制配置
      • 路由发现服务
    • HTTP过滤器
      • 缓存
      • CORS过滤器
      • DynamoDB
      • 故障注入
      • gRPC HTTP/1.1 桥接
      • gRPC-JSON 转码过滤器
      • gRPC-Web 过滤器
      • 健康检查
      • Lua
      • 速率限制
      • 路由
    • 集群管理
      • 集群
        • 健康检查
        • 熔断
        • TLS上下文
        • 异常值检测
        • HASH环负载均衡配置
      • 异常检测
      • 集群发现服务
      • 服务发现服务
    • 访问日志
    • 管理接口
    • 限速服务
    • 运行时配置
    • 跟踪
  • V2 API参考
    • 启动引导
    • 监听&监听发现
    • 集群&集群发现
    • 服务发现
    • 健康检查
    • HTTP路由管理&发现
    • TLS配置
    • 通用的类型
    • 网络地址
    • 协议选项
    • 发现API
    • 限速组件
    • 过滤器
      • 网络过滤器
        • TLS客户端身份认证
        • HTTP连接管理
        • Mongo代理
        • 速率限制
        • Redis代理
        • TCP代理
      • HTTP过滤器
        • 缓存
        • 故障注入
        • 健康检查
        • Lua
        • 速率限制
        • 路由
        • gRPC-JSON转码器
      • 常见访问日志类型
      • 常见故障注入类型
  • FAQ
    • Envoy有多快?
    • 我在哪里获得二进制文件?
    • 我如何设置SNI?
    • 如何设置区域感知路由?
    • 我如何设置Zipkin跟踪?
Powered by GitBook
On this page
  • 流量转移/分流
  • 上游主机间的流量转移
  • 多上游主机的流量分流
  • 返回

Was this helpful?

  1. 配置参考
  2. HTTP连接管理器

流量转移/分流

流量转移/分流

注意:本文是为v1 API编写的,但这些概念也适用于v2 API。它将在未来版本的v2 API中重新描述。

Envoy路由器支持将流量分发到两个或更多上游虚拟主机群集的路由。有两种常见的场景。

  1. 版本升级:到一条路由的流量逐渐从一个集群转移到另一个集群。更详细地描述参见流量转移部分。

  2. A/B测试或多重测试:同时测试两个或更多版本的相同服务。流向路由的流量必须在运行不同版本相同服务的集群之间进行拆分。更详细地描述参见流量分流部分。

上游主机间的流量转移

在路由运行时配置对象中,确定选择指定路由(以及它的集群)的概率。通过使用运行时配置,虚拟主机中指定路由的流量可逐渐从一个集群转移到另一个集群。参考以下配置示例,其中名为helloworld的服务,在Envoy配置文件中声明helloworld_v1和helloworld_v2两个版本。

{
  "route_config": {
    "virtual_hosts": [
      {
        "name": "helloworld",
        "domains": ["*"],
        "routes": [
          {
            "prefix": "/",
            "cluster": "helloworld_v1",
            "runtime": {
              "key": "routing.traffic_shift.helloworld",
              "default": 50
            }
          },
          {
            "prefix": "/",
            "cluster": "helloworld_v2",
          }
        ]
      }
    ]
  }
}

Envoy匹配策略是匹配第一个路由。如果路由具有运行时配置对象,则会根据使用运行时值进行匹配(如果没有指定值,则为默认值)。因此,通过在上面的例子中紧挨着的两条路由配置,通过在第一个路由中指定一个运行时对象,并且改变随着时间推移,修改该运行时对象的值来实现流量转移。以下是完成任务所需的大致操作顺序。

  1. 在开始时,将routing.traffic_shift.helloworld设置为100,以便所有对helloworld服务的请求,都与v1的路由匹配,并由helloworld_v1集群提供服务。

  2. 要开始将流量转移到helloworld_v2集群时,请将routing.traffic_shift.helloworld设置为0<x<100范围内。例如,设置90,对helloworld虚拟主机的每10个请求中,有1个将不匹配v1的路由,并将落入v2路由,由helloworld_v2集群提供服务。

  3. 逐渐设置routing.traffic_shift.helloworld中的值变小,以便更大比例的请求匹配到v2路由。

  4. 当routing.traffic_shift.helloworld设置为0时,对helloworld虚拟主机的请求将不会匹配v1路由。现在所有的流量都会流向v2路由,并由helloworld_v2集群提供服务。

多上游主机的流量分流

再次参考helloworld的例子,现在有三个版本(v1,v2和v3),而不是两个。 要在三个版本(即33%,33%,34%)之间平均分配流量,可以使用weighted_clusters选项指定每个上游群集的权重。

与前面的例子不同,一个路由条目就足够了。路由中的weighted_clusters配置可用于指定多个上游群集以及引导每个发送到上游群集的流量百分比权重。

{
  "route_config": {
    "virtual_hosts": [
      {
        "name": "helloworld",
        "domains": ["*"],
        "routes": [
          {
            "prefix": "/",
            "weighted_clusters": {
              "runtime_key_prefix" : "routing.traffic_split.helloworld",
              "clusters" : [
                { "name" : "helloworld_v1", "weight" : 33 },
                { "name" : "helloworld_v2", "weight" : 33 },
                { "name" : "helloworld_v3", "weight" : 34 }
              ]
            }
          }
        ]
      }
    ]
  }
}

可以使用以下运行时变量动态调整分配给每个群集的权重: routing.traffic_split.helloworld.helloworld_v1 routing.traffic_split.helloworld.helloworld_v2 routing.traffic_split.helloworld.helloworld_v3。

返回

Previous路由匹配NextHTTP头部操作

Last updated 5 years ago

Was this helpful?

上一级
首页目录