一,概述
Zuul包含了对请求的路由和过滤两个最主要的功能:
其中路由功能负责将外部请求转发到具体的微服务实例上,是实现外部访问统一入口的基础。而过滤器功能则负责对请求的处理过程进行干预,是实现请求校验、服务聚合等功能的基础.
Zuul和Eureka进行整合,将Zuul自身注册为Eureka服务治理下的应用,同时从Eureka中获得其他微服务的消息,也即以后的访问微服务都是通过Zuul跳转后获得。
注意:Zuul服务最终还是会注册进Eureka
代理+路由+过滤三大功能
二,路由基本配置
2.1 pom.xml
新建Module模块servicecloud-zuul-gateway-9527,在pom.xml中加入Zuul坐标:
<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">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.lmc</groupId>
<artifactId>servicecloud</artifactId>
<version>0.0.1-SNAPSHOT</version>
</parent>
<artifactId>servicecloud-zuul-gateway-9527</artifactId>
<dependencies>
<!-- 自己定义的api -->
<dependency>
<groupId>com.lmc</groupId>
<artifactId>servicecloud-api</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 修改后立即生效,热部署 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>springloaded</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
</dependency>
<!-- Zuul相关 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>
<!-- Ribbon相关 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-ribbon</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-config</artifactId>
</dependency>
<!-- feign相关 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-feign</artifactId>
</dependency>
</dependencies>
</project>
2.2 application.yml
新增application.yml配置文件:
server:
port: 9527
spring:
application:
name: servicecloud-zuul-gateway
eureka:
client:
service-url:
defaultZone: http://eureka7001.com:7001/eureka,http://eureka7002.com:7002/eureka,http://eureka7003.com:7003/eureka
instance:
instance-id: gateway-9527.com
prefer-ip-address: true
info:
app.name: lmc-cloud
company.name: www.lmc.com
build.artifactId: $project.artifactId$
build.version: $project.version$
2.3 启动类
创建启动类,增加@EnableZeelProxy注解:
package com.lmc.springcloud;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;
@SpringBootApplication
@EnableZuulProxy
public class Zuul_9527_StartSpringCloudApp {
public static void main(String[] args) {
// TODO Auto-generated method stub
SpringApplication.run(Zuul_9527_StartSpringCloudApp.class, args);
}
}
2.4 测试
启动:
- 启动三个eureka集群
- 启动一个服务提供类servicecloud-provider-dept-8001
- 启动路由
访问:
- 不使用路由:http://localhost:8001/dept/get/2
- 使用路由:http://myzuul.com:9527/servicecloud-dept/dept/get/2
三,路由访问映射处理
3.1 代替服务名
由于在访问路径URL中会暴露服务提供者名称servicecloud-dept,为了保证安全性,我们可以使用代替名称来取代servicecloud-dept访问:
#以前访问
#http://myzuul.com:9527/servicecloud-dept/dept/get/2
zuul:
routes:
mydept.serviceId: servicecloud-dept #服务ID名称
mydept.path: /mydept/** #取代服务ID名称
#现在访问
#http://myzuul.com:9527/mydept/dept/get/1
3.2 关闭服务名
但此时原路径的访问依然是成功,要关闭还需再进行配置:
zuul:
ignored-services: servicecloud-dept #忽略的服务名称
routes:
mydept.serviceId: servicecloud-dept #服务ID名称
mydept.path: /mydept/** #取代服务ID名称
如果要忽略所有服务名称,可使用*代替:
zuul:
ignored-services: "*" #忽略所有服务名称
routes:
mydept.serviceId: servicecloud-dept #服务ID名称
mydept.path: /mydept/** #取代服务ID名称
3.3 使用前缀
如果要对访问使用前缀,要加入prefix配置:
zuul:
prefix: /lmc #统一前缀
ignored-services: "*" #忽略所有服务名称
routes:
mydept.serviceId: servicecloud-dept #服务ID名称
mydept.path: /mydept/** #取代服务ID名称
所以现在访问就变成了:http://myzuul.com:9527/lmc/mydept/dept/get/1