SpringCloud+eureka/zookeeper+robbin+hystrix+openFeign+zuul/gateway+SpringCloud config+RabbitMQ

本文章仅作为个人笔记

eureka的集成(注册中心)

新建springboot项目并在build.gradle文件添加相关依赖

ext {
    set('springCloudVersion', "Hoxton.SR4")
}

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-server'
}
dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
    }
}

在新建的eureka服务项目中配置相关文件(application.yml对应配置可自行更改，下面给的是单机配置)

eureka:
  instance:
    hostname: localhost
  # 是否向注册中心注册服务(如果单eureka服务则false/避免自己对自己注册服务)
  client:
    register-with-eureka: false
    # 是否去检索其它服务，
    fetch-registry: false
    # 指定服务注册中心的位置
    service-url:
        defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

在新建的eureka服务项目Application主类添加注解 @EnableEurekaServer
```
@EnableEurekaServer
public class EurekaServerApplication {
```
此时再启动新建的eureka服务项目便完成了单eureka服务注册中心的搭建

eureka集群的配置

配置文件(在项目中复制配置文件，并加后缀)

配置文件1

server:
  port: 8761
eureka:
  instance:
    hostname: eureka8761
  # 是否向注册中心注册服务(如果单eureka服务则false/避免自己对自己注册服务)
  client:
    register-with-eureka: false
    # 是否去检索其它服务，
    fetch-registry: false
    # 指定服务注册中心的位置
    service-url:
        defaultZone: http://eureka8762:eureka8762/eureka/

配置文件2

server:
  port: 8762
eureka:
  instance:
    hostname: eureka8762
  # 是否向注册中心注册服务(如果单eureka服务则false/避免自己对自己注册服务)
  client:
    register-with-eureka: false
    # 是否去检索其它服务，
    fetch-registry: false
    # 指定服务注册中心的位置
    service-url:
        defaultZone: http://eureka8761:eureka8761/eureka/

因为hostname改变了，但是本地并不能识别，因此需要更改本地host文件，添加本地配置
```
127.0.0.1 eureka8761
127.0.0.1 eureka8762
```

运行时命令

java -jar xxx.jar --spring.profiles.active=<服务名(eureka8761)>

eureka常用配置

// 服务心跳s
eureka.instance.lease-renewal-interval-in-seconds=2
// 服务判定故障时间s
eureka.instance.lease-expiration-duration-in-seconds=10

普通服务提供者/消费者接入eureka注册中心

提供者注册服务

为服务提供者项目的build.gradle项目添加eureka相关依赖

ext {
  set('springCloudVersion', "Hoxton.SR4")
}

dependencies {
  implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-client'
}
dependencyManagement {
  imports {
      mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
  }
}

为服务提供者项目的application.yml添加eureka相关配置(多配置时service-url以,分隔)

# 服务名称
spring:
  application:
    name: cloud-provider
# eureka注册中心连接方式
eureka:
  client:
    service-url: 
      defaultZone: http://localhost:8761/eureka,http://localhost:8762/eureka

在服务提供者项目的Application主类添加注解 @EnableEurekaClient/@EnableDiscoveryClient 以使配置文件生效并注册服务/表明以可以使用eureka服务
```
@EnableDiscoveryClient
public class CloudProviderApplication {
```
此时再启动服务提供者项目，服务便注册至eureka注册中心了

服务者的调用

为消费者项目的build.gradle项目添加eureka相关依赖

ext {
  set('springCloudVersion', "Hoxton.SR4")
}

dependencies {
  implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-client'
}
dependencyManagement {
  imports {
      mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
  }
}

为服务消费者项目的application.yml添加eureka相关配置(多配置时service-url以,分隔)

# 服务名称
spring:
  application:
    name: cloud-consumer
# eureka注册中心连接方式
eureka:
  client:
    service-url: 
      defaultZone: http://localhost:8761/eureka,http://localhost:8762/eureka

再在消费者RestTemplate bean注入的地方加入 @LoadBalanced 注解加入负载均衡功能
```
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
```

此时只需要将服务消费者的restTemplate.getForEntity方法里的host改为服务提供者名称即可(例：)

@RestController
public class ConsumerController {

  @Autowired
  RestTemplate restTemplate;
  
  @RequestMapping("/consumer/hello")
  public String hello() {
      // eureka注册服务调用方式 直接返回数据
      return restTemplate.getForObject("http://cloud-provider/provider/hello"
                  , String.class);
  }
}

ribbon负载均衡的使用
启动多个服务提供者并注册至注册中心(eureka)
在消费者RestTemplate bean注入的地方加入 @LoadBalanced 注解
```
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
```
ribbon负载均衡策略与配置
- 策略
  - RoundRobinRule 轮询策略(默认)
  - RandomRule 随机策略
  - RetryRule 重试策略,失败重试，错误过多访问其它服务
  - AvailabilityFilteringRule 过滤故障/并发连接超阈值服务，对剩下的服务轮询
  - BestAvailableRule 过滤访问过多故障的服务，返回并发量最小的服务
  - ZoneAvoidanceRule 综合判断性能/可用性，返回更优的服务

配置

配置bean注入

  @Bean
  public IRule iRule() {
      return new RandomRule();//根据自己的需求返回不同的rule实例
  }

Hystrix 集成(熔断器)

为项目的build.gradle项目添加hystrix相关配置

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-netflix-hystrix'
}

在项目的Application主类添加注解 @EnableCircuitBreaker

@EnableCircuitBreaker
public class CloudProviderApplication {

在项目的controller类中添加注解 @HystrixCommand 及方法错误时调用方法

@HystrixCommand(fallbackMethod = "error")
public String hystrix() {
    //业务处理
}

public String error() {
    //错误处理
    return "error";
}

同时 @SpringBootApplication/@EnableEurekaClient/@EnableCircuitBreaker 三个注解可用 @SpringCloudApplication 代替
@EnableDiscoveryClient 与 @EnableEurekaClient 相似
hystrix默认超时时间为1000ms

hystrix 常用配置

// 设置超时时间
@HystrixCommand(fallbackMethod = "error", commandProperties = {
            @HystrixProperty(name = "execution.isolation.thread.timeoutInMilliseconds", value = "1500")
    })

hystrix的服务降级(当某个服务产生了熔断，此服务将不再被调用)
hystrix的异常处理(当调用者自己抛出了异常，此时也会触发服务的降级，当我们自己发生异常时，只需要在服务降级方法中添加一个Throwable类型的参数就能够获取到抛出的异常类型)
```
public String error(Throwable throwable) {
    return "error:" + (throwable == null ? "null" : throwable.getMessage());
}
```

如果需要抛某些异常给用户，则直接在 @HystrixCommand 注解中添加 ignoreExceptions = {<忽略的异常类>}

@HystrixCommand(fallbackMethod = "error", commandProperties = {
            @HystrixProperty(name = "execution.isolation.thread.timeoutInMilliseconds", value = "1500")
    }, ignoreExceptions = {
            Exception.class
    })

hystrix自定义请求服务熔断

自定义类并继承 com.netflix.hystrix.HystrixCommand 类
覆写 run 方法执行业务逻辑并返回业务数据
覆写 getFallback 方法处理熔断逻辑
重载构造方法传入必要参数Setter及RestTemplate

下面给出示例:

  public class MyHystrixCommand extends HystrixCommand {
  
      private RestTemplate restTemplate;
  
      public MyHystrixCommand(Setter setter, RestTemplate restTemplate) {
          super(setter);
          this.restTemplate = restTemplate;
      }
  
      @Override
      protected String run() throws Exception {
  //        int b = 10 / 0;//异常模拟
          return restTemplate.getForObject("http://cloud-provider/provider/hello"
                  , String.class);
      }
  
      @Override
      protected String getFallback() {
          Throwable throwable = getExecutionException();
          return "error2:" + (throwable == null ? "null" : throwable.getMessage());
      }
  
  }

调用时则不再需要写注解，而是直接 new 自定义类，然后调用 execute 方法返回结果。

@RequestMapping("/consumer/hystrix2")
public String hystrix2() {
    //使用默认的setter
    MyHystrixCommand myHystrixCommand = new MyHystrixCommand(
            com.netflix.hystrix.HystrixCommand.Setter.withGroupKey(HystrixCommandGroupKey.Factory.asKey(""))
            , restTemplate);
    return myHystrixCommand.execute();
}

异步调用方法

MyHystrixCommand myHystrixCommand = new MyHystrixCommand(
        com.netflix.hystrix.HystrixCommand.Setter.withGroupKey(HystrixCommandGroupKey.Factory.asKey(""))
        , restTemplate);
Future future = myHystrixCommand.queue();
//可以在这里做一些其它逻辑
//阻塞方法
String result = future.get();
return result;

hystrix dashboard (hystrix仪表盘监控)接入
- 新建项目并为项目的build.gradle项目添加hystrix-dashboard相关配置
```
ext {
    set('springCloudVersion', "Hoxton.SR4")
}

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-netflix-hystrix-dashboard'
}

dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
    }
}
```
- 在项目的Application主类添加注解 @EnableHystrixDashboard
```
@EnableHystrixDashboard
public class HystrixDashboardApplication {
```
- 启动项目并访问 http://:/hystrix (http://localhost:3721/hystrix) 查看服务是否部署成功
- 为需要监控的项目的build.gradle文件添加依赖
```
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-actuator'
}
```
- 为需要监控的项目配置springboot监控端口的权限(用来暴露endpoints，由于endpoints包含很多敏感信息，默认只可访问 health 和 info 两个权限)
```
management:
  endpoints:
    web:
      exposure:
        include: hystrix.stream    
```
- 访问 http://:/actuator/hystrix.stream 查看是否部署成功 (例： http://localhost:8081/actuator/hystrix.stream ，记得先访问一个其它接口，否之返回的是ping...)
- 为消费者添加完监控依赖再访问 http://:/hystrix ，在title输入要监控的项目名称，点击 Monitor Stream 即可查看项目hystrix运行情况。

声明式服务消费 openFeign (hystrix + ribbon 的整合项目) 集成

为消费者项目的build.gradle文件添加依赖

dependencies {
    //本身须包含 spring-cloud-starter-netflix-eureka-client
    implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'
}

在项目的Application主类添加注解 @EnableFeignClients

@EnableFeignClients
public class FeignConsumerApplication {

在项目需要访问注册中心的service添加注解 @FeignClient("<服务名称,不区分大小写>")并为方法添加 @RequestMapping("<访问服务路径>")注解

/访问的服务名称
@FeignClient("cloud-provider")
public interface ProviderService {

    //访问的服务路径
    @RequestMapping("/provider/hello")
    public String hello();

}

为服务消费者项目的application.yml添加相关配置(多配置时service-url以,分隔)

# 服务名称
spring:
  application:
    name: feign-consumer
# eureka注册中心连接方式
eureka:
  client:
    service-url: 
      defaultZone: http://localhost:8761/eureka,http://localhost:8762/eureka

openFeign 开启熔断机制

在 application.yml 配置文件添加配置

  feign:
    hystrix:
      enabled: true

在Service的 @FeignClient 注解中添加 fallback 赋值

  @FeignClient(name = "cloud-provider", fallback = ProviderFallBack.class)
  public interface ProviderService {

自定义的 ProviderFallBack 须实现对应的Service接口，当熔断时调用实现的方法

  @Component
  public class ProviderFallBack implements ProviderService {
  
      @Override
      public String hello() {
          System.out.println("服务不可用时调用");
          return "fall back.";
      }
  }

openFeign获取服务熔断异常信息

在 @FeignClient 注解中赋值属性 fallbackFactory

  @FeignClient(name = "cloud-provider", fallbackFactory = ProviderFallBackFactory.class)

编写 ProviderFallBackFactory 类，实现 FallbackFactory 接口并重写相应方法，其中create方法里边的cause即报错信息。

  @Component
  public class ProviderFallBackFactory implements FallbackFactory {
  
      @Override
      public ProviderService create(Throwable cause) {
          return new ProviderService() {
              @Override
              public String hello() {
                  System.out.println("服务不可用时调用 factory.");
                  return cause.getMessage();
              }
          };
      }
  }

zuul 集成(api网关)

新建项目并为项目的build.gradle文件添加依赖

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-client'
    implementation 'org.springframework.cloud:spring-cloud-starter-netflix-zuul'
}

在项目的Application主类添加注解 @EnableZuulProxy 开启zuul功能
```
@EnableZuulProxy
public class ZuulServerApplication {
```
为项目的application.yml添加相关配置(多配置时service-url以,分隔)
```
# 服务名称
spring:
  application:
    name: zuul-server
# eureka注册中心连接方式
eureka:
  client:
    service-url: 
      defaultZone: http://localhost:8761/eureka,http://localhost:8762/eureka
# 经典路由配置(与简化配置2选1)
zuul:
  routes:
    <自定义名字>:
      path: /api-mys/**
      serviceId: cloud-provider
# 简化路由配置(与经典配置2选1)
zuul:
  routes:
    cloud-provider: /api-mys/**
```
- 其中自定义名字必须对应path和serviceId，意为serviceId指向path,其中serviceId为访问的服务名，path为项目中访问路径，当前规则为匹配所有 /api-mys/** 的请求，只要请求路径包含 /api-mys/ 则会被转发到cloud-provider上
- 如果什么配置都不写，默认也会帮我们做代理，默认为
```
zuul:
  routes:
    <服务名>: /<服务名>/**
```
- 访问host://:/<配置服务名>/<配置路径> 测试(例： http://localhost:8085/api-mys/provider/hello )

为zuul添加过滤器

创建 Filter 类并继承ZuulFilter类重写相应方法
filterType 方法表示当前filter在哪个生命周期运行 pre->routing->post error任意阶段错误执行
- pre 表示在路由之前执行
- post 表示请求完成后执行
- error 表示错误时执行
- route 表示环绕请求前后执行
- static 表示
- 最后还可以自定义
filterOrder 方法表示执行顺序，当filter很多时，根据这个值的大小进行排序，
shouldFilter 方法判断当前过滤器是否需要执行
run 方法则是具体过滤逻辑

示例代码:

  @Component
  public class AuthFilter extends ZuulFilter {
  
      @Override
      public String filterType() {
          return "pre";
      }
  
      @Override
      public int filterOrder() {
          return 10;
      }
  
      @Override
      public boolean shouldFilter() {
          return true;
      }
  
      @Override
      public Object run() throws ZuulException {
          RequestContext requestContext = RequestContext.getCurrentContext();
          HttpServletRequest request = requestContext.getRequest();
          String token = request.getParameter("token");
          if (token == null) {
              //是否转发
              requestContext.setSendZuulResponse(false);
              requestContext.setResponseStatusCode(401);
              requestContext.addZuulResponseHeader("content-type", "text/html;charset=utf-8");
              requestContext.setResponseBody("非法访问");
          }
          //目前返回值无意义，可以返回null
          return null;
      }
  }

忽略路由规则

在 application.yml 文件添加配置

忽略所有服务

  zuul:
      ignored-services: cloud-provider

忽略某个/某些路径

  zuul:
      ignored-patterns: /provider/hello

为路由添加前缀
```
  zuul:
    prefix: /api-mys
```

zuul错误处理

禁用默认错误处理器

zuul:
  SendErrorFilter:
    error:
      disable: true

创建 Filter 类并继承ZuulFilter类重写相应方法，与之前差异仅filterType返回"error"及run中的处理差异，下面给出示例：

@Component
public class ErrorFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "error";
    }

    @Override
    public int filterOrder() {
        return 10;
    }

    @Override
    public boolean shouldFilter() {
        return true;
    }

    @Override
    public Object run() throws ZuulException {
        try {
            RequestContext requestContext = RequestContext.getCurrentContext();
            ZuulException exception = (ZuulException) requestContext.getThrowable();
            System.out.println("系统异常拦截：" + exception);
            HttpServletResponse response = requestContext.getResponse();
            response.setContentType("application/json; charset=utf8");
            response.setStatus(exception.nStatusCode);
            PrintWriter writer = null;
            try {
                writer = response.getWriter();
                writer.println("{\"code\":" + exception.nStatusCode
                        + ",\"message\":\"" + exception.getMessage() + "\"}");
            } catch (IOException e) {
                e.printStackTrace();
            } finally {
                if (writer != null) {
                    writer.close();
                }
            }
        } catch (Exception e) {
            ReflectionUtils.rethrowRuntimeException(e);
        }
        //目前返回值无意义，可以返回null
        return null;
    }
}

自定义全局错误页面(与自定义错误处理不兼容)

自定义controller并实现 ErrorController 接口，实现相应方法，下面给出示例：

  @RestController
  public class AllErrorController implements ErrorController {
      @Override
      public String getErrorPath() {
          //访问哪个路径
          return "/error";
      }
  
      @RequestMapping("/error")
      public Object error() {
          RequestContext context = RequestContext.getCurrentContext();
          ZuulException exception = (ZuulException) context.getThrowable();
          //具体处理看个人需求
          return exception.nStatusCode + "--" + exception.getMessage();
      }
  
  }

Spring Cloud Config (分布式配置管理系统)
- Spring Cloud 默认情况使用git存放配置文件，也可使用svn/gitlab等
- SpringCloud Config 服务搭建
- Spring Cloud Config 服务端搭建(服务端作为中心)
  - 新建项目并为项目 build.gradle 添加相应依赖
```
  ext {
      set('springCloudVersion', "Hoxton.SR4")
  }
  
  dependencies {
      implementation 'org.springframework.cloud:spring-cloud-config-server'
  }
  
  dependencyManagement {
      imports {
          mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
      }
  }
```
  - 在项目的Application主类添加注解 @EnableConfigServer 开启功能
```
  @EnableConfigServer
  public class ConfigServerApplication {
```
  - 在项目的 application.yml 中配置git仓库信息 (这里使用的自己搭建的本地gitlab)
```
  spring:
    cloud:
      config:
        server:
          git:
            uri: http://git.woaizhuangbi.com/makai/springconfigdemo.git
            search-paths: config-center
            username: springconfigdemo
            password: admin1234
```
  - 此时再启动项目便配置好了配置服务中心
  - 为了测试可以在项目下创建文件以测试
    - 在根目录创建config-center文件夹
    - 在config-center文件夹下创建application.properties/application-dev.properties/application-test.properties/application-online.yml 文件
    - 在不同文件设置不同配置(支持.yml文件与.properties文件)
```
application.properties
  url=http://www.woaizhuangbi.com
application-test.properties
  url=http://test.woaizhuangbi.com
application-online.yml
  url:
      http://online.woaizhuangbi.com
application-dev.properties
  url=http://dev.woaizhuangbi.com
```
    - 配置文件大致取名规则
      - /{application}/{profile}[/{label}]
      - /{application}-{profile}.yml
      - /{label}/{application}-{profile}.yml
      - /{application}-{profile}.properties
      - /{label}/{application}-{profile}.properties
  - 访问指定路径获取指定配置 http://:/<配置文件前缀>/<配置文件中缀>/<分支> 例： http://localhost:3721/application/online/master
- Spring Cloud Config 客户端搭建(可以理解为所有需要获取动态配置的项目，可以是所有服务)
  - 为项目 build.gradle 添加相应依赖
```
  dependencies {
      implementation 'org.springframework.cloud:spring-cloud-starter-config'
  }
```
  - 创建 bootstrap.yml 文件并配置 name对应配置文件前缀，profile对应中缀，label对应分支，uri即根访问路径
```
  spring:
    application:
      name: config-client
    cloud:
      config:
        profile: dev
        label: master
        uri: http://localhost:3721/
```
  - 创建controller进行测试,可以直接使用 @Value("${配置名}") 的方式或者 @Environment 的方式进行数据获取，例：
```
  @RestController
  public class ConfigController {
  
      @Value("${url}")
      private String url;
  
      @Autowired
      private Environment environment;
  
      @RequestMapping("/cloud/url")
      public String url() {
          return environment.getProperty("url");
  //        return url;
      }
  
  }            
```
  - 这样就简单的完成配置的使用
SpringCloud Config 动态更新
- 客户端处理
  - 为config客户端项目的 build.gradle 添加相应依赖
```
  dependencies {
      implementation 'org.springframework.boot:spring-boot-starter-actuator'
  }
```
  - 在服务端项目的 bootstrap.yml 文件中添加暴露监控端点配置及服务注册配置
```
  management:
    endpoint:
      web:
        exposure:
          include: "*"
```
  - 在controller上面添加 @RefreshScope 注解
```
  @RefreshScope
  public class ConfigController {
```
  - 最后发送一个post请求给每个客户端，以动态刷新 curl -X POST "http://:/actuator/refresh" 例如：
    
    curl -X POST "http://localhost:3721/actuator/refresh"
  - 此时再请求发送过post请求的客户端就能获取最新的配置了
- SpringCloud Config 安全保护
  - 服务端处理
    - 为config服务端项目的 build.gradle 添加相应依赖
```
dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-security'
}
```
    - 在服务端项目的 application.yml 文件中配置用户名密码
```
spring:
  security:
    user:
      name: springconfigadmin
      password: admin1234
```
    - 此时再直接访问服务端的url便需要登录了
  - 客户端处理
    - 在客户端项目的 bootstrap.yml 文件中配置用户名密码
```
spring:
  cloud:
    config:
      username: springconfigadmin
      password: admin1234
```
rabbitMQ 安装(docker安装)
- 拉取镜像
```
docker pull rabbitmq
docker pull rabbitmq:management
```
- 运行镜像(这里仅单机,端口自定义指定,详细集群等这里不深究)
```
docker run -p 4369:4369 -p 5672:5672 -p 15672:15672 -p 25672:25672 --name rabbitmq -d rabbitmq:management
```
- 默认端口
  - 4369 -- erlang发现口
  - 5672 --client端通信口
  - 15672 -- 管理界面ui端口
  - 25672 -- server间内部通信口
- 默认访问地址 http://localhost:15672
- 默认用户名密码：
```
guest
guest
```
SpringCloud Bus 集成(消息总线/配合rabbitMQ或者kafka使用/这里使用rabbitMQ)
- 服务端处理
  - 为config服务端项目的 build.gradle 添加相应依赖
```
  dependencies {
      implementation 'org.springframework.cloud:spring-cloud-starter-bus-amqp'
  }
```
  - 在服务端项目的 application.yml 文件中配置rabbitmq相关配置及暴露bus刷新配置的端点配置
```
  spring:
    rabbitmq:
      host: 192.168.3.6
      port: 5672
      username: guest
      password: guest
  management:
    endpoints:
      web:
        exposure:
          include: 'bus-refresh'
```
- 客户端处理
  - 为config客户端项目的 build.gradle 添加相应依赖
```
  dependencies {
      implementation 'org.springframework.cloud:spring-cloud-starter-bus-amqp'
  }
```
  - 在客户端项目的 application.yml 文件中配置rabbitmq相关配置
```
  spring:
    rabbitmq:
      host: 192.168.3.6
      port: 5672
      username: guest
      password: guest
```
- 最后发送一个post请求给服务端，以动态刷新 curl -X POST "http://:/actuator/bus-refresh" 例如(这里如果开启了登录则会冲突)：
```
curl -X POST "http://localhost:3722/actuator/bus-refresh"
```
- 此时再请求所有的客户端就都能获取最新的配置了
- 动态刷新定点通知(只通知部分客户端)
- 指定某一个通知： http://:/actuator/bus-refresh/{destination} 例：
```
http://localhost:3721/actuator/bus-refresh/config-client:3722
```
zookeeper 的集成(注册中心)
- docker 常用命令
  - docker实例查看
```
docker ps -a
```
  - docker复制文件
```
docker cp  :
```
  - docker登录
```
docker exec -i -t  /bin/sh
```
- zookeeper 在 docker 下运行
- 拉取镜像
```
docker pull zookeeper
```
- 运行镜像(这里仅单机,端口自定义指定,详细集群等这里不深究)
```
docker run -p 8080:8080 -p 2181:2181 --name zookeeper -d zookeeper
```
- 访问 http://: 测试服务是否能正常访问

zookeeper 接入

注册服务至zookeeper
- 服务提供者项目的 build.gradle 添加相应依赖
```
  dependencies {
      implementation 'org.springframework.cloud:spring-cloud-starter-zookeeper-discovery'
  }
```
- 服务提供者项目的 application.yml 文件中添加相应配置
```
  spring:
    cloud:
      zookeeper:
        connect-string: 192.168.3.6:2181
```
- 在服务提供者项目的Application主类添加注解 @EnableDiscoveryClient 以使配置文件生效并注册服务
```
  @EnableDiscoveryClient
  public class CloudProviderApplication {
```
- 此时服务提供者的服务便注册至zookeeper了

服务消费者的接入

服务消费者项目的 build.gradle 添加相应依赖

  dependencies {
      implementation 'org.springframework.cloud:spring-cloud-starter-zookeeper-discovery'
  }

服务消费者项目的 application.yml 文件中添加相应配置

  spring:
    cloud:
      zookeeper:
        connect-string: 192.168.3.6:2181

(后面的流程与eureka无异)
再在消费者RestTemplate bean注入的地方加入 @LoadBalanced 注解加入负载均衡功能
```
  @Bean
  @LoadBalanced
  public RestTemplate restTemplate() {
```

此时只需要将服务消费者的restTemplate.getForEntity方法里的host改为服务提供者名称即可(例：)

  @RestController
  public class ConsumerController {
  
      @Autowired
      RestTemplate restTemplate;
      
      @RequestMapping("/consumer/hello")
      public String hello() {
          // eureka注册服务调用方式 直接返回数据
          return restTemplate.getForObject("http://cloud-provider/provider/hello"
                      , String.class);
      }
  }

gateway 集成(api网关)
- 基本概念 Predicate->Filter->Route
- 新建项目并为项目 build.gradle 添加相应依赖
```
ext {
    set('springCloudVersion', "Hoxton.SR4")
}

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-zookeeper-discovery'
}

dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
    }
}
```
- 在项目的Application主类添加注解 @EnableDiscoveryClient 将服务注册至注册中心
```
@EnableDiscoveryClient
public class GatewayServerApplication {
```
- 在项目的 application.yml 中配置相应的路由/服务/断言等(路由可多个)
```
spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true     # 开启从注册中心动态创建路由的功能，利用服务名进行路由
      routes:
        - id: cloud-provider            # 路由的id，没有固定规则但要求唯一，建议配合服务名
#          uri: http://localhost:8080    # 匹配提供服务的服务根地址
          uri: lb://cloud-provider    # 匹配后提供服务的路由地址
          predicates:
            - Path=/provider/**    # 断言，路径相匹配的进行路由
```
  - predicates这个配置除了Path还有其它参数
    - After 之前 - After=2020-05-23T15:15:21.234+08:00[Asia/Shanghai] # 指定时间之后可访问
    - Before 之前 - Before=2020-06-23T15:15:21.234+08:00[Asia/Shanghai] # 指定时间之前可以访问
    - Between 之间 - Between=2020-06-23T15:15:21.234+08:00[Asia/Shanghai],2020-07-23T15:15:21.234+08:00[Asia/Shanghai] # 指定时间之间可以访问
    - Cookie 带Cookie - Cookie=username,aabb # 带有Cookie且key为username，value为aabb
    - Header 带Header - Header=X-Request-Id, \d+ # 含X-Request-Id的头且为数字
    - Method 指定请求方式 - Method=GET # get请求
    - Path 路径匹配 - Path=/provider/** # 请求路径匹配 /provider 开头
    - Query 参数匹配 - Query=username, \d+ # 带username参数且参数值为数字
  - filter 官方有详细介绍
    - 局部过滤器
    - 全局过滤器
    - 自定义过滤器
      - GlobalFilter 全局过滤器
      - Ordered 权重
- 此时再启动项目便配置好了相关网关服务了
- 可以访问 http://:/<具体路径> 例: http://localhost:8087/provider/hello

SpringCloud Stream 绑定器(兼容所有MQ(目前仅支持RabbitMQ/Kafka))

常用注解
- @Input 注解标识输入通道，通过该通道接收到的消息进入应用程序
- @Output 注解标识输入通道，发布的消息将通过该通道离开应用程序
- @StreamListener 监听队列，用于消费者队列的消息接收
- @EnableBinding 指信道channel和exchange绑定在一起
消息提供者者相关

为消息提供者项目的build.gradle文件添加依赖(此处兼容rabbitMQ)

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-stream-rabbit'
}

为消息提供者项目的 application.yml 文档添加对应的配置

spring:
  cloud:
    stream:
      binders:
        defaultRabbit:
          type: rabbit
          environment:
            spring:
              rabbitmq:
                host: 192.168.3.6
                port: 5672
                username: guest
                password: guest
      bindings:
        output:
          destination: studyExchange
          content-type: application/json
          binder: defaultRabbit

创建service接口并实现，再在service实现类添加 @EnableBinding 注解并定义消息的推送管道，再注入消息发送管道 MessageChannel，使用时调用 output.send(MessageBuilder.withPayload().build()) 例：

@EnableBinding(Source.class) //定义消息的推送管道
public class MessageProviderImpl implements IMessageProvider {

    @Resource
    private MessageChannel output;//消息发送管道

    @Override
    public String send() {
        String serial = UUID.randomUUID().toString();
        output.send(MessageBuilder.withPayload(serial).build());
        System.out.println("send:" + serial);
        return serial;
    }

}

使用时直接注入IMessageProvider进行消息操作即可

消息消费者相关

为消息消费者项目的build.gradle文件添加依赖(此处兼容rabbitMQ)

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-stream-rabbit'
}

为消息消费者项目的 application.yml 文档添加对应的配置

spring:
  cloud:
    stream:
      binders:
        defaultRabbit:
          type: rabbit
          environment:
            spring:
              rabbitmq:
                host: 192.168.3.6
                port: 5672
                username: guest
                password: guest
      bindings:
        input:
          destination: studyExchange
          content-type: application/json
          binder: defaultRabbit

创建Controller并添加 @EnableBinding 注解定义管道类 Sink.class，创建消息方法添加 @StreamListener 注解定义类型，例：

@Component
@EnableBinding(Sink.class)
public class ReceiveMessageListenerController {

    @Value("${server.port}")
    private String serverPort;

    @StreamListener(Sink.INPUT)
    public void input(Message message) {
        System.out.println(serverPort + " receive message = " + message);
    }

}

使用时若收到消息即会调用 input(Message message) 方法
mq重复消费问题
- 默认消息生产者会发送给消息给每个用户，即多次消费。当我们的消息只需要被一个用户消费时，需要对多个消息消费者进行共同分组
- 在多个消费者项目配置文件里添加配置即可，例：
```
spring:
  cloud:
    stream:
      bindings:
        input:
          group: config-client
```
mq持久化
自定义分组的消息消费者掉线后再上线不会丢失错过的消息

本人创建一github demo，有需求可自行查看借鉴。

SpringCloud+eureka/zookeeper+robbin+hystrix+openFeign+zuul/gateway+SpringCloud config+RabbitMQ

本文章仅作为个人笔记

你可能感兴趣的:(SpringCloud+eureka/zookeeper+robbin+hystrix+openFeign+zuul/gateway+SpringCloud config+RabbitMQ)