Ys2025

(三)SpringCloud之Consul注册中心

Consul注册中心

Consul介绍

Consul 是 HashiCorp 公司推出的开源工具，用于实现分布式系统的服务发现与配置。与其它分布式服务注册与发现的方案，Consul 的方案更“一站式”，内置了服务注册与发现框架、分布一致性协议实现、健康检查、Key/Value 存储、多数据中心方案，不再需要依赖其它工具（比如 ZooKeeper 等），使用起来也较为简单。

Consul 使用 Go 语言编写，因此具有天然可移植性（支持Linux、Windows 和 Mac OS）；安装包仅包含一个可执行文件，方便部署，与 Docker 等轻量级容器可无缝配合。

Consul特性

Raft算法
服务发现
健康检查
Key/Value储存
多数据中心
支持Http和Dns协议接口
官方提供Web管理界面

Consul角色

Client

客户端，无状态，将Htpp和DNS接口请求转发给局域网内的服务端集群。

Server

服务端，保存配置信息，高可用集群，每个书中心的server数量推荐3个或5个。

Consule安装

1、下载Consul

https://www.consul.io/downloads

2、安装

Consul的安装及其简单，下载后的Consul程序只有一个exe文件，只需要在cmd命令下执行相应命令即可。

3、启动Consul

Consul可执行文件同级目录下执行

# -dev表示开发模式运行，也可以使用-server，表示服务模式运行 -client=0.0.0.0，绑定客户端接口的ip
consul agent -dev -client=0.0.0.0

为了方便启动，避免每次启动都要执行上述命令，可以编写一个批处理脚本

run.bat

:: -dev表示开发模式运行，也可以使用-server，表示服务模式运行 -client=0.0.0.0，绑定客户端接口的ip
consul agent -dev -client=0.0.0.0
pause

访问管理页面：http://localhost:8500/，如下图表示启动成功

Consul的入门使用

1、创建Maven聚合项目

Consul-Demo：父项目
service-consumer：子项目-服务消费者
service-provier：子项目-服务提供者

父项目：pom.xml


<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0modelVersion>

    <groupId>cn.yanghuisengroupId>
    <artifactId>Consul-DemoartifactId>
    <packaging>pompackaging>
    <version>1.0-SNAPSHOTversion>
    <modules>
        <module>service-providermodule>
        <module>service-consumermodule>
    modules>
    
    
    <parent>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-parentartifactId>
        <version>2.3.0.RELEASEversion>
    parent>

    
    <properties>
        
        <spring-cloud.version>Hoxton.SR5spring-cloud.version>
    properties>

    
    <dependencyManagement>
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-dependenciesartifactId>
                <version>${spring-cloud.version}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
        dependencies>
    dependencyManagement>

project>

2、Service-Provider：服务提供者

pom.xml



<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>Consul-DemoartifactId>
        <groupId>cn.yanghuisengroupId>
        <version>1.0-SNAPSHOTversion>
    parent>
    <modelVersion>4.0.0modelVersion>

    <artifactId>service-providerartifactId>

    <name>service-providername>
    
    <url>http://www.example.comurl>

    <properties>
        <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
        <maven.compiler.source>1.8maven.compiler.source>
        <maven.compiler.target>1.8maven.compiler.target>
    properties>

    
    <dependencies>
        
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-starter-consul-discoveryartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-actuatorartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
        
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
            <scope>providedscope>
        dependency>

        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <scope>testscope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintagegroupId>
                    <artifactId>junit-vintage-engineartifactId>
                exclusion>
            exclusions>
        dependency>
    dependencies>
project>

application.yml

server:
  port: 7070 # 端口

spring:
  application:
    name: service-provider # 应用名称
  cloud:
    # 配置 Consul 注册中心
    consul:
      # 注册中心的访问地址
      host: localhost
      port: 8500
      # 服务发现相关配置
      discovery:
        register: true                                # 是否需要注册
        instance-id: ${spring.application.name}-01    # 注册实例 id（必须唯一）
        service-name: ${spring.application.name}      # 服务名称
        port: ${server.port}                          # 服务端口
        prefer-ip-address: true                       # 是否使用 ip 地址注册
        ip-address: ${spring.cloud.client.ip-address} # 服务请求 ip

服务提供者启动类：ServiceProviderApplication.java

package cn.yanghuisen;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @author admin
 * @version 1.0
 * @date 2020/6/16 20:09
 * @Description 服务提供者启动类
 */
@SpringBootApplication
public class ServiceProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(ServiceProviderApplication.class);
    }
}

实体类：Product.java

package cn.yanghuisen.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.io.Serializable;

@Data                       // lombok生成set、get方法
@NoArgsConstructor          // lombok生成无参构造器
@AllArgsConstructor         // lombok生成全参构造器
public class Product implements Serializable {

    private Integer id;
    private String productName;
    private Integer productNum;
    private Double productPrice;

}

服务接口：ProductService.java

package cn.yanghuisen.service;


import cn.yanghuisen.pojo.Product;

import java.util.List;

/**
 * 商品服务
 */
public interface ProductService {

    /**
     * 查询商品列表
     *
     * @return
     */
    List<Product> selectProductList();

}

服务接口实现类：ProductServiceImpl.java

package cn.yanghuisen.service.impl;

import cn.yanghuisen.pojo.Product;
import cn.yanghuisen.service.ProductService;
import org.springframework.stereotype.Service;

import java.util.Arrays;
import java.util.List;

/**
 * 商品服务
 */
@Service
public class ProductServiceImpl implements ProductService {

    /**
     * 查询商品列表
     *
     * @return
     */
    @Override
    public List<Product> selectProductList() {
        return Arrays.asList(
                new Product(1, "华为手机", 1, 5800D),
                new Product(2, "联想笔记本", 1, 6888D),
                new Product(3, "小米平板", 5, 2020D)
        );
    }

}

控制层：ProductController.java

package cn.yanghuisen.controller;

import cn.yanghuisen.pojo.Product;
import cn.yanghuisen.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
@RequestMapping("/product")
public class ProductController {

    @Autowired
    private ProductService productService;

    /**
     * 查询商品列表
     *
     * @return
     */
    @GetMapping("/list")
    public List<Product> selectProductList() {
        return productService.selectProductList();
    }

}

启动项目，查看服务提供者是否成功注册到Consul注册中心。

访问：http://localhost:8500/

按照创建provider的方式创建provider02，并修改配置文件的端口和实例ID

server:
  port: 7071 # 端口

spring:
  application:
    name: service-provider # 应用名称
  cloud:
    # 配置 Consul 注册中心
    consul:
      # 注册中心的访问地址
      host: localhost
      port: 8500
      # 服务发现相关配置
      discovery:
        register: true                                # 是否需要注册
        instance-id: ${spring.application.name}-02    # 注册实例 id（必须唯一）
        service-name: ${spring.application.name}      # 服务名称
        port: ${server.port}                          # 服务端口
        prefer-ip-address: true                       # 是否使用 ip 地址注册
        ip-address: ${spring.cloud.client.ip-address} # 服务请求 ip

启动provider02，访问：http://localhost:8500/

3、Service-Consumer：服务消费者