跟我学Spring Cloud(Finchley版)-17-Zuul路由配置详解
上一节( 跟我学Spring Cloud(Finchley版)-16-Zuul )中,已经实现用Zuul转发到Eureka上的微服务。默认的路由规则是:访问$ZUUL_URL/指定为服务/**
会被转发到指定微服务
的/**
。
但在实际项目中,往往需要自己定义路由规则,Zuul的路由配置非常灵活、简单,本节详细讲解Zuul的路由配置。
一、自定义指定微服务的访问路径
配置zuul.routes.指定微服务的serviceId = 指定路径
即可。例如:
1 | zuul: |
这样设置,microservice-provider-user微服务就会被映射到/user/**路径。
二、忽略指定微服务
忽略服务非常简单,可以使用zuul.ignored-services
配置需要忽略的服务,多个用逗号分隔。例如:
1 | zuul: |
这样就可让Zuul忽略microservice-provider-user和microservice-consumer-movie微服务,只代理其他微服务。
三、忽略所有微服务,只路由指定的微服务
很多场景下,我们可能只想要让Zuul代理指定的微服务,此时可以将zuul.ignored-services
设为’*’
1 | zuul: |
这样就可以让Zuul只路由microservice-provider-user微服务。
四、同时指定微服务的serviceId和对应路径
例如:
1 | zuul: |
本例配置的效果同示例(1)。
五、同时指定path和URL,例如:
1 | zuul: |
这样就可以将/user/**
映射到http://localhost:8000/**
。
需要注意的是,使用这种方式配置的路由不会作为HystrixCommand执行,同时也不能使用Ribbon来负载均衡多个URL。例(6)可解决该问题。
六、同时指定path和URL,并且不破坏Zuul的Hystrix、Ribbon特性。
1 | zuul: |
这样就可以既指定path与URL,又不破坏Zuul的Hystrix与Ribbon特性了。
七、使用正则表达式指定Zuul的路由匹配规则
借助PatternServiceRouteMapper,实现从微服务到映射路由的正则配置。例如:
1 |
|
通过这段代码即可实现将诸如microservice-provider-user-v1这个微服务,映射到/v1/microservice-provider-user/**这个路径。
八、路由前缀
示例1:
1 | zuul: |
这样,访问Zuul的/api/microservice-provider-user/1路径,请求将会被转发到microservice-provider-user的/api/1
示例2:
1 | zuul: |
这样访问Zuul的/user/1路径,请求将会被转发到microservice-provider-user的/user/1
TIPS:
① 可参考该Issue辅助理解: https://github.com/spring-cloud/spring-cloud-netflix/issues/1365
九、忽略某些路径
上文我们讲解了如何忽略微服务,但有时我们还需要更细粒度的路由控制。例如,我们想让Zuul代理某个微服务,同时又想保护该微服务的某些敏感路径。此时,可使用ignoredPatterns,指定忽略的正则。例如:
1 | zuul: |
这样就可将microservice-provider-user微服务映射到/user/**路径,但会忽略该微服务中所有包含/admin/的路径。
小技巧
读者如无法掌握Zuul路由的规律,可将com.netflix包的日志级别设为DEBUG。这样,Zuul就会打印转发的具体细节,从而帮助我们更好地理解Zuul的路由配置,例如:
1 | logging: |
评论系统未开启,无法评论!