＜六＞spring-cloud Hoxton.SR2 网关组件zuul搭建使用

<六>spring-cloud Hoxton.SR2 网关组件zuul搭建使用

本地项目的基础环境

环境	版本
jdk	1.8.0_201
maven	3.6.0
Spring-boot	2.2.4.RELEASE
Spring-cloud	Hoxton.SR2

本次例子是基于上一次构建的badger-spring-cloud-api项目的基础上，使用的；

《<一>spring-cloud Hoxton.SR2版 服务注册与发现–eureka搭建以及集群搭建》

《<二>spring-cloud Hoxton.SR2 负载均衡ribbon搭建使用》

《<三>spring-cloud Hoxton.SR2 负载均衡openfeign搭建使用》

《<四>spring-cloud Hoxton.SR2 断路器hystrix搭建使用》

《<五>spring-cloud Hoxton.SR2 hystrix Dashboard监控搭建使用》

具体代码信息，可以查看《码云》

1、项目搭建

1.1、搭建新的项目badger-spring-cloud-zuul，pom文件如下

主要是新增注册中心eureka的包spring-cloud-starter-netflix-eureka-client，网关zuul的包spring-cloud-starter-netflix-zuul

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.4.RELEASE</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.badger</groupId>
    <artifactId>badger-spring-cloud-zuul</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>badger-spring-cloud-zuul</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
        <maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
        <spring-cloud.version>Hoxton.SR2</spring-cloud.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

1.2、主类上加网关注解@EnableZuulProxy和eureka的注解@EnableEurekaClient

/**
 * @EnableEurekaClient 标记为eureka的客户端
 * @EnableZuulProxy 开启zuul网关代理
 * @author liqi
 *
 */
@SpringBootApplication
@EnableEurekaClient
@EnableZuulProxy
public class ZuulApplication {

    public static void main(String[] args) throws Exception {
        SpringApplication.run(ZuulApplication.class, args);
    }
}

1.3、yaml的配置文件

server:
  port: 9000
eureka:
  client:
    serviceUrl:
      defaultZone: http://172.16.2.50:8761/eureka/
  instance:
    instance-id: ${spring.cloud.client.ip-address}:${server.port}
    prefer-ip-address: true
spring:
  application:
    name: '@project.name@'
zuul:
  prefix: /badger  #前缀，默认为空的字符串
  ignored-services: '*' #隐藏（忽略）其他的没有被网关暴露的其他的所有的路径
  routes:
    api: #应用的别名
      path: /api/** #服务的路径的映射名字
      service-id: badger-spring-cloud-api #被访问的应用

到这里，项目就搭建完成了

2、项目启动，测试使用

启动步骤如下：

1. 启动eureka的服务，端口8761；
2. 修改yaml的配置文件，启动端口为7001，启动服务的提供者badger-spring-cloud-api；
3. 启动服务的消费者badger-spring-cloud-zuul，端口为9000；

访问地址http://localhost:9000/badger/api/demo可以看到结果

我的地址是-->172.16.2.50:7001；表示测试成功

解释下访问地址http://localhost:9000/badger/api/demo的路由，配合上述的yaml的配置文件一起观察

badger：在zuul.prefix=/badger 表示访问的前缀，默认为空字符串

api：在zuul.routes.api.path=/api/** 表示被访问的应用（eureka中注册的名称）badger-spring-cloud-api的访问路径；

demo：表示应用badger-spring-cloud-api的controller的访问路由

最后说下zuul.ignored-services='*'属性的意义

既然我们能使用zuul.routes.api.path=/api/**的api替换应用的badger-spring-cloud-api，那么可以直接使用badger-spring-cloud-api访问？答案是可以的，访问地址如下

http://localhost:9000/badger/badger-spring-cloud-api/demo

可以看到，访问不成功；找不到访问的路由；

主要是原因，就是zuul.ignored-services='*'属性，隐藏（忽略）其他的没有被网关暴露的其他的所有的路径；我们把这个属性注释掉，重启zuul的项目，再次访问，就可以成功了；

具体代码信息，可以查看《码云》