Zuul 简介
Zuul是Netflix开源的微服务网关,他可以和Eureka,Ribbon,Hystrix等组件配合使用。Zuul组件的核心是一系列的过滤器,这些过滤器可以完成以下功能:
- 身份认证和安全: 识别每一个资源的验证要求,并拒绝那些不符的请求
- 审查与监控:
- 动态路由:动态将请求路由到不同后端集群
- 压力测试:逐渐增加指向集群的流量,以了解性能
- 负载分配:为每一种负载类型分配对应容量,并弃用超出限定值的请求
- 静态响应处理:边缘位置进行响应,避免转发到内部集群
- 多区域弹性:跨域AWS Region进行请求路由,旨在实现ELB(ElasticLoad Balancing)使用多样化
Spring Cloud对Zuul进行了整合和增强。目前,Zuul使用的默认是Apache的HTTP Client,也可以使用Rest Client,可以设置ribbon.restclient.enabled=true.
创建模块 spring-cloud-zuul
- 创建模块过程略
- pom.xml 增加eureka及zuul依赖
- Zuul 1.3.x ,1.4.x的版本,可以在1.5.x版本的spring-boot环境下使用
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
<version>1.3.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zuul</artifactId>
<version>1.3.5.RELEASE</version>
</dependency>
- application.yml
server:
port: 9000
spring:
application:
name: api-geteway
zuul:
routes:
hello-service:
path: /hello-service/**
serviceId: eureka-client-users
eureka:
client:
service-url:
defaultZone: http://127.0.0.1:8001/eureka/,http://127.0.0.1:8002/eureka/
- hello-service 标识你服务的名字,这里可以自己定义,一般方便和规范来讲还是跟自己服务的名字一样
- path: /hello-service/**
服务映射的路径,通过这路径就可以从外部访问你的服务了,目的是为了不爆露你机器的IP,面向服务的路由了,给你选一个可用的出来,
这里zuul是自动依赖hystrix,ribbon的,不是面向单机 - serviceId: eureka-client-users,eureka-client-users为服务提供者的名字,必须保持一致
- defaultZone: http://127.0.0.1:8001/eureka/,http://127.0.0.1:8002/eureka/
这两个地址为eureka-server的两个地址,eureka-server 已集群部署,详见之前的博客
- SpringCloudZuulApplication.java
@SpringBootApplication
@EnableZuulProxy
public class SpringCloudZuulApplication {
public static void main(String[] args) {
SpringApplication.run(SpringCloudZuulApplication.class, args);
}
}
- @EnableZuulProxy 重点标注,启用Zuul 代理
启动 eureka-server 服务,详见eureka-server集群demo
启动 用户服务
- 创建两个用户模块,过程略
- application.properties
模块一
spring.application.name=eureka-client-users
server.port=8005
eureka.client.serviceUrl.defaultZone=http://127.0.0.1:8001/eureka/,http://127.0.0.1:8002/eureka/
模块二
spring.application.name=eureka-client-users
server.port=8006
eureka.client.serviceUrl.defaultZone=http://127.0.0.1:8001/eureka/,http://127.0.0.1:8002/eureka/
- spring.application.name=eureka-client-users
spring.application.name 对应的是 serviceId
- 在两个模块中分别创建 HelloWordController.java
模块一
@RestController
@RequestMapping(path = "/user")
public class HelloWordController {
@RequestMapping(value = "/hello", method = RequestMethod.GET)
public String demo(String name){
return " 000 "+name;
}
}
模块二
@RestController
@RequestMapping(path = "/user")
public class HelloWordController {
@RequestMapping(value = "/hello", method = RequestMethod.GET)
public String demo(String name){
return " 111 "+name;
}
}
- 主程序中增加 @EnableEurekaClient
@SpringBootApplication
@EnableEurekaClient
public class EurekaClientUsersApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaClientUsersApplication.class, args);
}
}
- 分别启动两个用户服务后,在eureka-server中查看服务,如图
启动 Zuul 服务
- 访问 http://localhost:9000/hello-service/user/hello
- 输出 : 000
- 再次刷新:输出 111
可以看到zuul进行了请求分发了,它是根据你的服务名字hello-servie来映射到具体的机器上的。
默认路由
Zuul 系统默认按照serviceId 声明
- 删除 application.yml 文件中部分内容,如下代码块
zuul:
routes:
hello-service:
path: /hello-service/**
serviceId: eureka-client-users
- 重新启动项目后,访问如下URL ,依然可以访问
http://localhost:9000/eureka-client-users/user/hello - 关闭所有路由
zuul:
ignored-services: *
- 增加前缀
zuul:
routes:
hello-service:
path: /hello-service/**
serviceId: eureka-client-users
prefix: /api/**
- prefix: 指定URL前缀,访问URL 时,需在前面增加api 前缀
- 屏蔽指定的URL
zuul:
routes:
hello-service:
path: /hello-service/**
serviceId: eureka-client-users
prefix: /api/**
ignored-patterns: /user/**
- ignored-patterns: 配置的是屏蔽掉的URL