spring cloud 服务网关ZUUL

路由是微服务架构中不可或缺的一部分。比如，/ 可能需要映射到你的web应用, /api/users 映射到用户服务, /api/shop 映射到商城服务. Zuul是Netflix出品的一个基于JVM路由和服务端的负载均衡器。

可以通过Zuul实现下列业务：

认证和安全
测试监控
动态路由
限流
静态响应处理

反向代理

在Spring Boot main函数上通过注解 @EnableZuulProxy 来开启. 根据请求URL匹配，Ribbon从注册中心Eureka获取服务ID做负载均衡，请求都在Hystrix的command中执行。

路由规则可以在配置文件中指定，可以像nginx一样根据URL正则匹配请求。示例 application.yml

 zuul:
  routes:
    users:
      path: /users/**
      serviceId: users_service

这个意味着HTTP请求"/users"开头的URL,会被转发到"users_service"服务. 路由必须配置一个可以被指定为ant风格表达式的"path", /users/*只能匹配一个层级, 但/users/**可以匹配多级。后端的配置既可以是"serviceId"(对于服务发现中的服务而言), 也可以是"url"(对于物理地址)

 zuul:
  ignoredPatterns: /**/admin/**
  routes:
    users: /users/**

“/users/101"的请求会跳转到"users"服务的”/101", 但包含"/admin/“的请求将不被处理.

动态绑定 可以通过regexmapper提供serviceId和routes之间的绑定. 它使用正则表达式组来从serviceId提取变量, 然后注入到路由表达式中。示例： ApplicationConfiguration.java

@Bean
public PatternServiceRouteMapper serviceRouteMapper() {
    return new PatternServiceRouteMapper(
        "(?<name>^.+)-(?<version>v.+$)",
        "${version}/${name}");
}

这个意思是说"users-v1"将会匹配路由”/v1/users/"，任何正则表达式都可以, 但是所有组必须存在于servicePattern和routePattern之中. 如果servicePattern不匹配服务ID，则使用默认行为，这个功能默认是关闭的，并且仅适用于服务注册的服务。前缀如果api中有前缀如/v2/user/, /api/user/**，可以设置zuul.prefix，通过zuul.stripPrefix=false关闭。

REST API 动态获取和修改: 如果你使用 @EnableZuulProxy 同时引入了Spring Boot Actuator, 你将默认增加一个endpoint, 提供http服务的 /routes. 一个GET请求将返回路由匹配列表. 一个POST请求将强制刷新已存在的路由。

Cookies和敏感HTTP头

X-Forwarded-Host默认在跳转是自动添加，可以通过zuul.addProxyHeaders = false 关闭。如果希望某些HTTP HEADER不泄露到下游服务，可以配置为敏感头。

zuul:
  routes:
    users:
      path: /myusers/**
      sensitiveHeaders: Cookie,Set-Cookie,Authorization
      url: https://downstream

可以这样对不同服务设置不同敏感头，也可以设置全局默认敏感头：zuul.sensitiveHeaders =

窒息模式和本地跳转

旧接口迁移到新接口的过程,可以如下，把一部分接口用老接口，一部分迁移的方式。有点像rewrite。

zuul:
  routes:
    first:
      path: /first/**
      url: http://first.example.com
    second:
      path: /second/**
      url: forward:/second
    third:
      path: /third/**
      url: forward:/3rd
    legacy:
      path: /**
      url: http://legacy.example.com

通过Zuul上传文件

如果使用 @EnableZuulProxy , 可以使用代理路径上传文件, 对于小文件可以正常使用即可，对于大文件，还有可选路径”/zuul/，通过它绕过Spring DispatcherServlet (避免处理multipart). 比如对于 zuul.routes.customers=/customers/* ,使用 /zuul/customers/*去上传大文件. Servlet路径通过 zuul.servletPath 指定. 如果使用Ribbon负载均衡器的代理路由, 在处理非常大的文件时, 仍然需要提高超时配置。

application.yml
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 60000
ribbon:
  ConnectTimeout: 3000
  ReadTimeout: 60000

注意: 对于大文件的上传流, 你应该在请求中使用块编码. (有些浏览器默认不这么做). 比如在命令行中:

$ curl -v -H "Transfer-Encoding: chunked" \
-F "file=@mylarge.iso" localhost:9999/zuul/simple/file

Menu

spring cloud 服务网关ZULL