Gateway网关简介
学习一门新技术首先要知道它是什么
Gateway网关是什么
Spring Cloud Gateway是Spring官方基于Spring 5.0,Spring Boot 2.0和Project Reactor等技术开发的网关,它旨在为微服务架构提供一种简单而有效的统一的API路由管理方式。
Spring Cloud Gateway作为Spring Cloud生态系中的网关,目标是替代ZUUL,为了提高网关的性能,SpringCloud Gateway是基于WebFlux框架实现的,而WebFlux框架底层则使用了高性能的Reactor模式通信框架Netty
SpringCloud Gateway的目标提供统一的路由方式且基于Filter链的方式提供了网关基本的功能,例如:安全,监控/埋点,和限流等。
Gateway能干嘛
- 反向代理
- 鉴权
- 流量控制
- 熔断
- 日志监控
Gateway在微服务中的所在位置
Gateway的三大核心概念
- Route(路由):路由是构建网关的基本模块,它由ID,目标URI,一系列的断言和过滤器组成,如断言为true则匹配该路由
*Predicate(断言) :参考的是Java8的java.util.function.Predicate开发人员可以匹配HTTP请求中的所有内容(例如请求头或请求参数),如果请求与断言相匹配则进行路由 - Filter(过滤):指的是Spring框架中GatewayFilter的实例,使用过滤器,可以在请求被路由前或者之后对请求进行修改.
Gateway工作流程
客户端向SpringCloud Gateway发出请求,然后在Gateway Handler Mapping中找到与请求相匹配的路由,将其发送到Gateway Web Handler.
Handler再通过指定的过滤器链来将请求发送到我们实际的服务执行业务逻辑,然后返回。
过滤器之间用虚线分开是因为过滤器可能发生在发送代理请求之前“pre”或者之后“post”执行业务逻辑。
Filter再“pre”类型的过滤器可以做参数校验、权限校验、流量监控、日志输出、协议转换等。
在“post”类型的过滤器中可以做相应内容、响应头的修改,日志的输出,流量监控等。
总结起来就是:路由转发加过滤
Gateway的配置
POM导入
通过官网可知要导入spring-cloud-starter-gateway
依赖
修改yml
通过时间匹配
Spring 是通过 ZonedDateTime 来对时间进行的对比,ZonedDateTime 是 Java 8 中日期时间功能里,用于表示带时区的日期与时间信息的类,ZonedDateTime 支持通过时区来设置时间,中国的时区是:Asia/Shanghai。
以下为官网的相关信息
spring:
cloud:
gateway:
routes: #路由路径
- id: after_route #路由的ID,没有固定规则但要求唯一,建议配合服务名
uri: https://example.org #匹配后提供服务的路由地址
predicates: #断言,路径相匹配的进行路由
- After=2017-01-20T17:42:47.789-07:00[Asia/Shanghai]
#时间断言,判定是在指定时间之后才能进入,否则报错
spring:
cloud:
gateway:
routes:
- id: before_route
uri: https://example.org
predicates:
- Before=2017-01-20T17:42:47.789-07:00[Asia/Shanghai]
spring:
cloud:
gateway:
routes:
- id: between_route
uri: https://example.org
predicates:
- Between=2017-01-20T17:42:47.789-07:00[Asia/Shanghai], 2017-01-21T17:42:47.789-07:00[America/Denver]
通过Cookie方式匹配
Cookie Route Predicate 可以接收两个参数,一个是 Cookie name , 一个是正则表达式,路由规则会通过获取对应的 Cookie name 值和正则表达式去匹配,如果匹配上就会执行路由,如果没有匹配上则不执行。
spring:
cloud:
gateway:
routes:
- id: cookie_route
uri: https://example.org
predicates:
- Cookie=chocolate, ch.p
使用cmd命令行测试
curl http://localhost:9527/payment/lb --cookie "chocolate=ch.p"
通过Header匹配
spring:
cloud:
gateway:
routes:
- id: header_route
uri: https://example.org
predicates:
- Header=X-Request-Id, \d+
测试:
curl http://localhost:9527/** -H "X-Request-Id:666666"
通过Host匹配
Host Route Predicate 接收一组参数,一组匹配的域名列表,这个模板是一个 ant 分隔的模板,用.号作为分隔符。它通过参数中的主机地址作为匹配规则。
spring:
cloud:
gateway:
routes:
- id: host_route
uri: https://example.org
predicates:
- Host=**.somehost.org,**.anotherhost.org
**表示任意
测试:
curl http://localhost:9527 -H "Host: www.somehost.org"
curl http://localhost:9527 -H "Host: md.anotherhost.org"
通过请求方式匹配
可以通过是 POST、GET、PUT、DELETE 等不同的请求方式来进行路由匹配。
spring:
cloud:
gateway:
routes:
- id: method_route
uri: https://example.org
predicates:
- Method=GET,POST
组合使用
除了以上几种方式以外还有许多匹配方式,这里就不一一例举,直接给个最全的组合使用
spring:
cloud:
gateway:
routes:
- id: host_foo_path_headers_to_httpbin
uri: http://ityouknow.com
predicates:
- Path=/headers
- Host=**.foo.org
- Method=GET
- Header=X-Request-Id, \d+
- Query=ccc
- Cookie=chocolate, ch.p
- After=2018-01-20T06:06:06+08:00[Asia/Shanghai]
这时要访问的话必须要符合每一个的路由规则,否则路由访问失败
若一个请求同时满足多个路由时(即该请求有多个规则且同时满足了多个路由路径时),请求只会被首个成功匹配的路由转发。