/spring-cloud-wii

An easy way to integrate polyglot apps for Spring Cloud.

Primary LanguageJava

Spring Cloud Wii

wii

LOGO制作网站:http://www.uugai.com/

Spring Cloud Wii是一个用来 快速整合 Spring Cloud 与 异构微服务 的框架,灵感来自 Spring Cloud Netflix Sidecar 。目前支持的服务发现组件:

  • Nacos
  • Consul

术语

异构微服务

非Spring Cloud应用,统称异构微服务。比如你的遗留项目,或者非JVM应用。

“完美整合”的三层含义

  • 享受服务发现的优势
  • 有负载均衡
  • 有断路器

为什么要造这个轮子?

原因有两点:

  • Spring Cloud子项目 Spring Cloud Netflix Sidecar 是可以快速整合异构微服务的。然而,Sidecar只支持使用Eureka作为服务发现,如果使用其他服务发现组件就抓瞎了
  • Sidecar是基于Zuul 1.x的,Spring Cloud官方明确声明,未来将会逐步淘汰Zuul。今年早些时候,我有给Spring Cloud官方提出需求,希望官方实现一个基于Spring Cloud Gateway的新一代Sidecar,然而官方表示并没有该计划。详见:spring-cloud/spring-cloud-gateway#735

既然没有,索性自己写了。

原理

  • Wii根据配置的异构微服务的IP、端口等信息,将异构微服务的IP/端口注册到服务发现组件上
  • Wii实现了 健康检查 ,Wii会定时检测异构微服务是否健康。如果发现异构微服务不健康,Wii会自动将代表异构微服务的Wii实例下线;如果异构微服务恢复正常,则会自动上线。最长延迟是30秒,详见 WiiChecker#check

要求

  • 【必须】你的异构微服务需使用HTTP通信。这一点严格来说不算要求,因为Spring Cloud本身就是基于HTTP的;
  • 【可选】如果微服务配置了 wii.health-check-url ,则表示开启了Wii的健康检查,此时,你的异构微服务需实现健康检查(可以是空实现,只要暴露一个端点,返回类似 {"status": "UP"} 的字符串即可)。

使用示例

  • 如使用Nacos作为服务发现组件,详见 examples/spring-cloud-wii-example-nacos
  • 如使用Consul作为服务发现组件,详见 examples/spring-cloud-wii-example-consul

示例代码(以Nacos服务发现为例)

  • 依赖管理:Spring Cloud Alibaba版本必须是2.1.x+,否则会报错。这主要是因为Spring Cloud Alibaba修改了包名命名…不同版本的类名包结构不同,而Wii使用了Nacos的类,所以版本必须保持一致。

    <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>
        <dependency>
          <groupId>com.alibaba.cloud</groupId>
          <artifactId>spring-cloud-alibaba-dependencies</artifactId>
          <version>2.1.0.RELEASE</version>
          <type>pom</type>
          <scope>import</scope>
        </dependency>
      </dependencies>
    </dependencyManagement>
  • 加依赖:

    <dependency>
      <groupId>com.itmuch</groupId>
      <artifactId>spring-cloud-wii</artifactId>
      <version>0.0.1-SNAPSHOT</version>
    </dependency>
  • 写配置:

    server:
      port: 8070
    spring:
      cloud:
        nacos:
          discovery:
            server-addr: localhost:8848
        gateway:
          discovery:
            locator:
              enabled: true
      application:
        name: wii-node-service
    wii:
      # 异构微服务的IP
      ip: 127.0.0.1
      # 异构微服务的端口
      port: 8060
      # 异构微服务的健康检查URL
      health-check-url: http://localhost:8060/health.json

    配置比较简单,就是把Wii注册到Nacos上,然后添加了几行wii的配置。

异构微服务

我这里准备了一个NodeJS编写的简单微服务。

var http = require('http');
var url = require("url");
var path = require('path');

// 创建server
var server = http.createServer(function(req, res) {
    // 获得请求的路径
    var pathname = url.parse(req.url).pathname;
    res.writeHead(200, { 'Content-Type' : 'application/json; charset=utf-8' });
    // 访问http://localhost:8060/,将会返回{"index":"欢迎来到首页"}
    if (pathname === '/') {
        res.end(JSON.stringify({ "index" : "欢迎来到首页" }));
    }
    // 访问http://localhost:8060/health,将会返回{"status":"UP"}
    else if (pathname === '/health.json') {
        res.end(JSON.stringify({ "status" : "UP" }));
    }
    // 其他情况返回404
    else {
        res.end("404");
    }
});
// 创建监听,并打印日志
server.listen(8060, function() {
    console.log('listening on localhost:8060');
});

测试

测试1:Spring Cloud微服务完美调用异构微服务

你的Spring Cloud项目整合Ribbon,只需构建 http://wii-node-service 就可以请求到异构微服务了。

示例:

Ribbon请求 http://wii-node-service/ 会请求到 http://localhost:8060/ 以此类推。

至于断路器,正常为你的Spring Cloud微服务整合Sentinel或者Hystirx、Resilience4J即可 。

测试2:异构微服务完美调用Spring Cloud微服务

由于Wii基于Spring Cloud Gateway,而网关自带转发能力啊。

示例:

如果你有一个Spring Cloud微服务叫做 spring-cloud-microservice ,那么NodeJS应用只需构建 http://localhost:8070/spring-cloud-microservice/** ,Wii就会把请求转发到 spring-cloud-microservice/**

而Spring Cloud Gateway是整合了Ribbon的,所以实现了负载均衡;Spring Cloud Gateway还可以整合Sentinel或者Hystirx、Resilience4J,所以也带有了断路器。

Wii优缺点分析

Wii的设计和Sidecar基本一致,优缺点和Sidecar的优缺点也是一样的。

优点:

  • 接入简单,几行代码就可以将异构微服务整合到Spring Cloud生态
  • 不侵入原代码

缺点:

  • 每接入一个异构微服务实例,都需要额外部署一个Wii实例,增加了部署成本(虽然这个成本在Kubernetes环境中几乎可以忽略不计(只需将Wii实例和异构微服务作为一个Pod部署即可));
  • 异构微服务调用Spring Cloud微服务时,本质是把Wii当网关在使用,经过了一层转发,性能有一定下降。