Spring Cloud 微服务一：Consul注册中心

1. Consul介绍　　
   • 　Consul is a service mesh solution providing a full featured control plane with service discovery, configuration, and segmentation functionality. Each of these features can be used individually as needed, or they can be used together to build a full service mesh. Consul requires a data plane and supports both a proxy and native integration model. Consul ships with a simple built-in proxy so that everything works out of the box, but also supports 3rd party proxy integrations such as Envoy.　以上是官网介绍，大概意思是：Consul是一个service mesh 解决方案，包含服务发现、配置、外部服务；这些功能可以按需单独使用。
   • Consul核心能力包括：服务发现、健康检查、KV存储、安全通信、多数据中心。本章主要使用服务发现功能。Consul官网：https://www.consul.io/

2. Consul安装有两种方式：原生安装，docker安装，本例主要采用docker方式

• 　　docker安装：安装方法参考：https://github.com/JensenShao/consul 。以单机模式安装Consul，第一步，获取镜像：docker pull wdijkerman/consul；第二步，docker宿主机上创建文件

  {
  	"data_dir": "/consul/data",
  	"log_level": "INFO",
  	"client_addr": "0.0.0.0",
  	"ports": {
  		"dns": 53
  	},
  	"ui": true,
  	"server": true,
      "bootstrap_expect": 1,
  	"disable_update_check": true
  }；第三步，启动镜像：docker run -u root -p 8400:8400 -p 8500:8500 -p 8600:53/udp -h server1 -v /root/shaozj/consul/config/my_config.json:/consul/config/my_config.json:ro  --privileged=true wdijkerman/consul；更多参数配置可参考上面链接地址。

• 原生安装方式参考：https://www.consul.io/docs/install/index.html

3.spring 集成，springcloud对Consul的基本操作进行了封装，我们可以方便地使用consul的功能，本文中主要是使用consul的服务发现功能，客户端使用Springcloud feign做http客户端以及负载均衡，以用户管理为例描述服务发现功能。

• 环境准备：本机安装Maven，JDK1.8，Intellij Idea环境；spring环境：spring boot使用2.0.8.RELEASE版本，spring cloud使用Finchley.SR2, 具体版本间的兼容关系请参考spring官网:http://spring.io/projects/spring-cloud,里面有明确说明
• 创建工程骨架：创建父工程parent，创建三个module：user-api，user-service，user-consumer；其中user-api中定义了服务接口，user-service和user-consumer都会依赖这个接口；user-service是对于user-api中接口的实现；user-consumer主要通过feign来调用服务
• 编写user-api代码：首先，由于api工程中会用到web的一些注解，需要pom中依赖spring-boot-starter-web。创建实体类User.java, 属性有id，name，创建接口UserService：

  public interface UserService{
      @GetMapping("/all")
      List<User> getAllUsers();
  }

  这样一个接口就完成了

  • 接下来编写user-service，主要是对user-api接口的实现，是服务的提供方。首先，pom中需要依赖user-api，另外需要依赖spring cloud consul服务发现组件：spring-cloud-starter-consul-discovery。创建UserService实现类UserServiceImpl：

    @RestController
    public class UserServiceImpl implements UserService{
        @Override
        public List<User> getAllUsers(){
            // 模拟DAO
            List<User> userList = new ArrayList<>();
            userList.add(new User(1, "consul"));
            userList.add(new User(1, "feign"));
    
            return userList;
        }
    }

    此处还需要添加一个springboot的启动类UserServiceApplication用于启动，

    @SpringBootApplication
    @EnableDiscoveryClient
    public class UserServiceApplication{
        public static void main(String[] args){
            SpringApplication.run(UserServiceApplication.class, args);
        }
    }

    其中@EnableDiscoveryClient注解作用是让注册中心能够发现并扫描该服务。最后添加spring配置application.yml：

    spring:
    	application:
    		name: user-service
    	cloud:
            consul:
                host: 127.0.0.1
                port: 8500
                discovery:
                    register: true
                    hostname: 127.0.0.1
    
    server:
        port: 10086

    其中register表示该工程下的服务会注册到注册中心

• 实现user-consumer，该工程主要是服务的调用方。同样先在pom中添加依赖包：user-api, 同时需要依赖spring cloud feign：spring-cloud-starter-openfeign, 还需要依赖：spring-cloud-starter-consul-discovery作为http客户端。首先定义一个接口UserServiceClient继承UserService（此处为feign的使用方式）：

  //其中@FeignClient注解表示要调用的微服务
  @FeignClient(value="user-service")
  public UserServiceClient extends UserService{}

  创建UserController调用服务：

  @RestController
  public class UserController{
      //自动注入feign客户端
      @Autowired
      private UserServiceClient userServiceClient;
  
      @GetMapping("/users")
      public List<User> getAllUsers(){
          //调用微服务
          return userServiceClient.getAllUsers();
      }
  }

  创建springboot启动类UserConsumerApplication：

  //@EnableFeignClients表示启用feign客户端，通过此注解可以使用feign
  @EnableFeignClients
  @SpringBootApplication
  public class UserConsumerApplication{
      public static void main(String[] args){
          SpringApplication.run(UserConsumerApplication.class, args);
      }
  }

  创建spring配置文件application.yml:

  spring:
      application:
          name: user-consumer
      cloud:
          consul:
              host: 127.0.0.1
              port: 8500
              discovery:
              # false表示该工程下的服务不会被注册
                  register: false
  
  server:
      port: 10080

• 分别启动user-service，user-consumer应用，在浏览器访问：http://localhost:10080/users,能够返回用户列表即表示成功