介绍
Zuul 包含了对请求的路由和过滤两个最重要的功能:
其中路由功能服务将外部请求转发到具体的微服务实例上,是实现外部访问统一入口的基础。而过滤的功能则负责对请求的处理过程进行干预,是实现请求校验、服务聚合等功能的基础。
Zuul 和 Eureka 进行整合,将 Zuul 自身注册为 Eureka 服务治理下的应用,同时从 Eureka 中获得其它微服务的消息,之后的微服务访问都是通过 Zuul 转发。
Zuul 提供了代理、路由、过滤三大功能。
使用
路由转发使用
1、新建名为 "microservicecloud-zuul-gateway-9527" 的子工程,依赖如下:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>microservicecloud</artifactId> <groupId>zze.springcloud</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>microservicecloud-zuul-gateway-9527</artifactId> <dependencies> <!--Eureka 客户端依赖 ps : Zuul 也要注册到 Eureka--> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka</artifactId> </dependency> <!--Zuul 依赖--> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-zuul</artifactId> </dependency> <!--监控--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <!--Hystrix--> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-hystrix</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-config</artifactId> </dependency> <dependency> <groupId>zze.springcloud</groupId> <artifactId>microservicecloud-api</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jetty</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> </dependency> <!--热部署--> <dependency> <groupId>org.springframework</groupId> <artifactId>springloaded</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> </dependency> </dependencies> </project>
pom.xml
2、配置如下:
server: port: 9527 spring: application: name: microservicecloud-zuul-gateway-9527 eureka: client: service-url: defaultZone: http://www.eurekaserver1.com:7001/eureka,http://www.eurekaserver2.com:7002/eureka,http://www.eurekaserver3.com:7003/eureka instance: instance-id: microservicecloud-zuul-gateway-9527 prefer-ip-address: true
application.yml
3、新建主启动类,使用注解开启 Zuul 代理:
package zze.springcloud; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.netflix.zuul.EnableZuulProxy; @SpringBootApplication @EnableZuulProxy // 开启 Zuul 代理 public class Application_9527 { public static void main(String[] args) { SpringApplication.run(Application_9527.class, args); } }
zze.springcloud.Application_9527
4、测试:
1、启动 7001、7002、7003 Eureka 集群 2、启动 "microservicecloud-provider-dept-8001" Provider 服务 3、启动 "microservicecloud-zuul-gateway-9527" Zuul 代理服务 4、访问 http://localhost:8001/dept/list 正常返回数据 5、访问 http://localhost:9527/microservicecloud-provider-dept/dept/list 通过 Zuul 转发获取到 microservicecloud-provider-dept 服务的数据
即 Zuul 完成了路由转发 转发规则为:Zuul服务地址/注册到Eureka的服务名称/对应服务访问路径 Zuul服务地址:localhost:9527 注册到Eureka的服务名称:microservicecloud-provider-dept 对应服务访问路径:/dept/list
test
配置路由映射
修改 "microservicecloud-zuul-gateway-9527" 子工程的配置文件,新增服务映射关系:
# 路由映射配置 zuul: routes: dept.serviceId: microservicecloud-provider-dept dept.path: /mydept/** # 访问路径匹配该规则的请求都会被转发到 microservicecloud-provider-dept 服务
重启 Zuul 服务,此时也可以通过 localhost:9527/mydept/dept/list 访问到 microservicecloud-provider-dept 服务,并且原来 localhost:9527/microservicecloud-provider-dept/dept/list 微服务全名这种方式也不受影响能正常访问。
如果要忽略原来通过微服务全名方式转发的方式,那么可以添加如下配置:
zuul.ignored-services: microservicecloud-provider-dept # microservicecloud-provider-dept 为忽略的服务名称,还可通过 * 代指所有的服务名称,即禁用所有服务以服务名称方式访问转发
还可以添加统一前缀,只需要添加如下属性:
zuul.prefix: /zze # 此时访问路径就变为 localhost:9527/zze/mydept/dept/list