SpringCloud Zuul（二）之简单用法

红太狼 2022-10-29 09:28 2阅读 0赞

### 一、引用Zuul ###

要将Zuul引用在项目中，请使用组ID为`org.springframework.cloud`和工件ID为的启动器`spring-cloud-starter-netflix-zuul`。

<dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
                <version>2.1.3.RELEASE</version>
            </dependency>

### 二、嵌入Zuul反向代理 ###

Spring Cloud嵌入Zuul代理，以简化UI应用程序要对一个或多个后端服务进行代理调用的常见用例的开发。此功能对于用户界面代理所需的后端服务很有用，从而避免了为所有后端独立管理CORS和身份验证问题的需求。

要启用它，请使用注释Spring Boot主类`@EnableZuulProxy`。这样做会导致将本地请求转发到适当的服务。

按照惯例，ID为`users`的服务从位于的代理`/users`（去掉前缀）接收请求。代理使用功能区来定位要通过发现转发到的实例。所有请求均在[hystrix命令][hystrix]中执行，因此失败会显示在Hystrix指标中。一旦电路断开，代理就不会尝试与服务联系。

注：

**Zuul启动器不包括服务发现的客户端，对于使用服务ID作为转发的路由，您还需要在类路径上提供服务发现的客户端（Eureka是其中的一种选择）。**

（1）zuul.ignored-services与routes

想要跳过自动配置服务路由的步骤，请设置`zuul.ignored-services`为服务ID模式的列表。如果服务与被忽略但仍包含在显式配置的路由映射中的模式匹配，则将其忽略，如以下示例所示：

**application.yml**

zuul:
      ignoredServices: '*'
      routes:
        users: /myusers/**

在上面的例子中，所有的服务都将被忽略，**除了**为`users`。

要增加或更改代理路由，可以添加外部配置，如下所示：

**application.yml**

zuul:
      routes:
        users: /myusers/**

前面的示例意味着HTTP调用要`/myusers`转发到`users`服务（例如`/myusers/101`转发到`/101`）。

要对路由进行更细粒度的控制，可以分别指定路径和serviceId，如下所示：

**application.yml**

zuul:
      routes:
        users:
          path: /myusers/**
          serviceId: users_service

前面的示例意味着HTTP调用将`/myusers`转发到该`users_service`服务。路由必须具有`path`可以指定为ant风格模式的，因此`/myusers/*`只能匹配一个级别，但可以`/myusers/**`分层匹配。

后端的位置可以指定为`serviceId`（用于发现服务）或`url`（物理位置），如以下示例所示：

**application.yml**

zuul:
      routes:
        users:
          path: /myusers/**
          url: https://example.com/users_service

（2） hystrix.command和ribbon

这些简单的url-routes不会以的形式执行`HystrixCommand`，也不会使用Ribbon负载均衡多个URL。为了实现这些目标，您可以指定一个`serviceId`带有静态服务器列表的，如下所示：

**application.yml**

zuul:
      routes:
        echo:
          path: /myusers/**
          serviceId: myusers-service
          stripPrefix: true
    
    hystrix:
      command:
        myusers-service:
          execution:
            isolation:
              thread:
                timeoutInMilliseconds: ...
    
    myusers-service:
      ribbon:
        NIWSServerListClassName: com.netflix.loadbalancer.ConfigurationBasedServerList
        listOfServers: https://example1.com,http://example2.com
        ConnectTimeout: 1000
        ReadTimeout: 3000
        MaxTotalHttpConnections: 500
        MaxConnectionsPerHost: 100

另一种方法是指定服务路由并配置一个Ribbon客户端`serviceId`（这样做需要在Ribbon中禁用Eureka支持-[有关更多信息][Link 1]，请参见[上文][Link 1]），如以下示例所示：

**application.yml**

zuul:
      routes:
        users:
          path: /myusers/**
          serviceId: users
    
    ribbon:
      eureka:
        enabled: false
    
    users:
      ribbon:
        listOfServers: example.com,google.com

（3）PatternServiceRouteMapper

您可以使用来提供`serviceId`和之间的约定正则映射。它使用正则表达式命名组从中提取变量`serviceId`并将其注入路由模式，如以下示例所示：

**ApplicationConfiguration.java**

@Bean
    public PatternServiceRouteMapper serviceRouteMapper() {
        return new PatternServiceRouteMapper(
            "(?<name>^.+)-(?<version>v.+$)",
            "${version}/${name}");
    }

上面的示例指的是`serviceId`的`myusers-v1`被映射到路线`/v1/myusers/**`。可以接受任何正则表达式，但所有命名组都必须同时存在于`servicePattern`和中`routePattern`。如果`servicePattern`与不匹配`serviceId`，则使用默认行为。在前面的示例中，`serviceId`of`myusers`映射到“ / myusers / \*\*”路由（未检测到版本）。默认情况下，此功能是禁用的，仅适用于发现的服务。

（4）zuul.prefix

要为所有映射添加前缀，请设置`zuul.prefix`一个值，例如`/api`。默认情况下，代理前缀会从请求中剥离，然后再转发请求（您可以使用来关闭此行为`zuul.stripPrefix=false`）。您还可以关闭从单个路由中剥离特定于服务的前缀，如以下示例所示：

**application.yml**

zuul:
      routes:
        users:
          path: /myusers/**
          stripPrefix: false

`注：zuul.stripPrefix`仅适用于中设置的前缀`zuul.prefix`。它对给定路由中定义的前缀没有任何影响`path`。

（5）zuul.retryable

在前面的例子中，请求到 `/myusers/101`转发到 `/myusers/101`在 `users`服务。

这些`zuul.routes`条目实际上绑定到类型的对象`ZuulProperties`。如果查看该对象的属性，则可以看到它也有一个`retryable`标志。设置该标志以`true`使功能区客户端自动重试失败的请求。您还可以将该标志设置为何`true`时需要修改使用功能区客户端配置的重试操作的参数。

（6）zuul.addProxyHeaders

默认情况下，`X-Forwarded-Host`标头被添加到转发的请求中。要关闭它，请设置`zuul.addProxyHeaders = false`。默认情况下，前缀路径被剥离，并且后端的请求选择一个`X-Forwarded-Prefix`标头（`/myusers`在前面显示的示例中）。

（7）默认路由（/）

如果设置默认路由（`/`），则具有的应用程序`@EnableZuulProxy`可以充当独立服务器。例如，`zuul.route.home: /`将所有流量（“ / \*\*”）路由到“ home”服务。

如果需要更细粒度的忽略，则可以指定要忽略的特定模式。这些模式在路线定位过程开始时进行评估，这意味着模式中应包含前缀以保证匹配。被忽略的模式跨越所有服务，并取代任何其他路由规范。以下示例显示了如何创建忽略的模式：

**application.yml**

zuul:
      ignoredPatterns: /**/admin/**
      routes:
        users: /myusers/**

前面的示例意味着所有呼叫（例如`/myusers/101`）都被转发到`/101`该`users`服务上。但是，包括在内的呼叫`/admin/`无法解决。

注：**如果需要保留路由的顺序，则需要使用YAML文件，因为使用properties文件时顺序会丢失。**

以下示例显示了这样的YAML文件：

**application.yml**

zuul:
      routes:
        users:
          path: /myusers/**
        legacy:
          path: /**

如果要使用properties 文件，则该`legacy`路径可能会终止于该`users` 路径的前面，从而导致该`users`路径不可访问。

[hystrix]: https://docs.spring.io/spring-cloud-netflix/docs/2.2.7.RELEASE/reference/html/#hystrix-fallbacks-for-routes
[Link 1]: https://docs.spring.io/spring-cloud-netflix/docs/2.2.7.RELEASE/reference/html/#spring-cloud-ribbon-without-eureka