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
<?xml version="1.0" encoding="UTF-8"?>
<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.0</modelVersion>
<groupId>cn.yanghuisen</groupId>
<artifactId>Consul-Demo</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
<module>service-provider</module>
<module>service-consumer</module>
</modules>
<!-- 繼承 spring-boot-starter-parent 依賴 -->
<!-- 使用繼承方式,實現複用,符合繼承的都可以被使用 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.3.0.RELEASE</version>
</parent>
<!--
集中定義依賴組件版本號,但不引入,
在子工程中用到聲明的依賴時,可以不加依賴的版本號,
這樣可以統一管理工程中用到的依賴版本
-->
<properties>
<!-- Spring Cloud Hoxton.SR5 依賴 -->
<spring-cloud.version>Hoxton.SR5</spring-cloud.version>
</properties>
<!-- 項目依賴管理 父項目只是聲明依賴,子項目需要寫明需要的依賴(可以省略版本信息) -->
<dependencyManagement>
<dependencies>
<!-- spring cloud 依賴 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
</project>
2、Service-Provider:服務提供者
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<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-Demo</artifactId>
<groupId>cn.yanghuisen</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>service-provider</artifactId>
<name>service-provider</name>
<!-- FIXME change it to the project's website -->
<url>http://www.example.com</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<!-- 項目依賴 -->
<dependencies>
<!-- spring cloud consul 依賴 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-consul-discovery</artifactId>
</dependency>
<!-- spring boot actuator 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- spring boot web 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- lombok 依賴 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<scope>provided</scope>
</dependency>
<!-- spring boot test 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
</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:服務消費者
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<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-Demo</artifactId>
<groupId>cn.yanghuisen</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>service-consumer</artifactId>
<name>service-consumer</name>
<!-- FIXME change it to the project's website -->
<url>http://www.example.com</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<!-- 項目依賴 -->
<dependencies>
<!-- spring cloud consul 依賴 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-consul-discovery</artifactId>
</dependency>
<!-- spring boot actuator 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- spring boot web 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- lombok 依賴 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<scope>provided</scope>
</dependency>
<!-- spring boot test 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
</project>
application.yml
server:
port: 9090 # 端口
spring:
application:
name: service-consumer # 應用名稱
cloud:
# 配置 Consul 註冊中心
consul:
# 註冊中心的訪問地址
host: localhost
port: 8500
# 服務發現相關配置
discovery:
register: false # 是否需要註冊
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
實體類:Product.java
package cn.yanghuisen.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Product implements Serializable {
private Integer id;
private String productName;
private Integer productNum;
private Double productPrice;
}
實體類:Order.java
package cn.yanghuisen.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import java.util.List;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Order implements Serializable {
private Integer id;
private String orderNo;
private String orderAddress;
private Double totalPrice;
private List<Product> productList;
}
消費者服務接口:OrderService.java
package cn.yanghuisen.service;
import cn.yanghuisen.pojo.Order;
public interface OrderService {
/**
* 根據主鍵查詢訂單
*
* @param id
* @return
*/
Order selectOrderById(Integer id);
}
消費者服務接口:OrderServiceImpl.java
package cn.yanghuisen.service.impl;
import cn.yanghuisen.pojo.Order;
import cn.yanghuisen.pojo.Product;
import cn.yanghuisen.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.ParameterizedTypeReference;
import org.springframework.http.HttpMethod;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;
import java.util.List;
@Service
public class OrderServiceImpl implements OrderService {
@Autowired
private RestTemplate restTemplate;
/**
* 根據主鍵查詢訂單
*
* @param id
* @return
*/
@Override
public Order selectOrderById(Integer id) {
return new Order(id, "order-001", "中國", 22788D,
selectProductListByLoadBalancerAnnotation());
}
private List<Product> selectProductListByLoadBalancerAnnotation() {
// ResponseEntity: 封裝了返回數據
ResponseEntity<List<Product>> response = restTemplate.exchange(
"http://service-provider/product/list",
HttpMethod.GET,
null,
new ParameterizedTypeReference<List<Product>>() {
});
return response.getBody();
}
}
控制層:OrderController.java
package cn.yanghuisen.controller;
import cn.yanghuisen.pojo.Order;
import cn.yanghuisen.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/order")
public class OrderController {
@Autowired
private OrderService orderService;
/**
* 根據主鍵查詢訂單
*
* @param id
* @return
*/
@GetMapping("/{id}")
public Order selectOrderById(@PathVariable("id") Integer id) {
return orderService.selectOrderById(id);
}
}
消費者啓動類:ServiceConsumerApplication.java
package cn.yanghuisen;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;
@SpringBootApplication
public class ServiceConsumerApplication {
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
return new RestTemplate();
}
public static void main(String[] args) {
SpringApplication.run(ServiceConsumerApplication.class, args);
}
}
啓動消費者服務,訪問:http://localhost:9090/order/1