SpringBoot2 整合Nacos組件及環境搭建和入門案例解析

Posted on by

本文源碼：GitHub·點這裡 || GitEE·點這裡

一、Nacos基礎簡介

1、概念簡介

Nacos 是構建以“服務”為中心的現代應用架構，如微服務范式、雲原生范式等服務基礎設施。聚焦於發現、配置和管理微服務。Nacos提供一組簡單易用的特性集，幫助開發者快速實現動態服務發現、服務配置、服務元數據及流量管理。敏捷構建、交付和管理微服務平臺。

2、關鍵特性

  • 動態配置服務
  • 服務發現和服務健康監測
  • 動態 DNS 服務
  • 服務及其元數據管理

3、專業術語解釋

  • 命名空間

用於進行租戶粒度的配置隔離。不同的命名空間下，可以存在相同的 Group 或 Data ID 的配置。

  • 配置集

一組相關或者不相關的配置項的集合稱為配置集。在系統中，一個配置文件通常就是一個配置集，包含瞭系統各個方面的配置。

  • 配置集 ID

Nacos 中的某個配置集的ID。配置集ID是組織劃分配置的維度之一。DataID通常用於組織劃分系統的配置集。

  • 配置分組

Nacos 中的一組配置集，是組織配置的維度之一。通過一個有意義的字符串對配置集進行（Group）分組，從而區分 Data ID 相同的配置集。

  • 配置快照

Nacos 的客戶端 SDK 會在本地生成配置的快照。當客戶端無法連接到 Nacos Server 時，可以使用配置快照顯示系統的整體容災能力。

  • 服務註冊

存儲服務實例和服務負載均衡策略的數據庫。

  • 服務發現

使用服務名對服務下的實例的地址和元數據進行探測，並以預先定義的接口提供給客戶端進行查詢。

  • 元數據

Nacos數據（如配置和服務）描述信息，如服務版本、權重、容災策略、負載均衡策略等。

4、Nacos生態圈

Nacos 無縫支持一些主流的開源框架生態：

  • Spring Cloud 微服務框架 ;
  • Dubbo RPC框架 ;
  • Kubernetes 容器應用 ;

二、Nacos環境搭建

1、環境版本

這裡在Windos環境下搭建Nacos單個服務。

  • Nacos版本：官方推薦的穩定版本為1.1.4。
  • 基礎環境：JDK 1.8+；Maven 3.2.x

2、環境包下載

這裡直接下載打包好的文件，也可以下載源碼自己打包。

https://github.com/alibaba/nacos/releases

下載文件：nacos-server-1.1.4.zip

3、啟動環境啟動文件地址：

  • 啟動文件地址：nacos\bin
  • 啟動文件：startup.cmd
  • 關閉文件：shutdown.cmd

啟動後登陸，賬戶密碼默認：nacos/nacos ;首頁效果如下：

三、整合SpringBoot2

註意：版本 0.2.x.RELEASE 對應的是 Spring Boot 2.x 版本，版本 0.1.x.RELEASE 對應的是 Spring Boot 1.x 版本。

1、新建配置

2、核心依賴

<!-- Nacos 組件依賴 -->
<dependency>
    <groupId>com.alibaba.boot</groupId>
    <artifactId>nacos-discovery-spring-boot-starter</artifactId>
    <version>0.2.3</version>
</dependency>
<dependency>
    <groupId>com.alibaba.boot</groupId>
    <artifactId>nacos-config-spring-boot-starter</artifactId>
    <version>0.2.3</version>
</dependency>

3、Yml配置文件

這裡把項目作為服務註冊到Nacos中。

nacos:
  config:
    server-addr: 127.0.0.1:8848
  discovery:
    server-addr: 127.0.0.1:8848

4、啟動類配置

啟動類關聯配置中心的dataId標識。

@EnableSwagger2
@SpringBootApplication
@NacosPropertySource(dataId = "WARE_ID", autoRefreshed = true)
public class Application7017 {
    public static void main(String[] args) {
        SpringApplication.run(Application7017.class,args) ;
    }
}

5、核心配置類

import com.alibaba.nacos.api.annotation.NacosInjected;
import com.alibaba.nacos.api.exception.NacosException;
import com.alibaba.nacos.api.naming.NamingService;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import javax.annotation.PostConstruct;
@Configuration
public class NacosConfig {
    @Value("${server.port}")
    private int serverPort;
    @Value("${spring.application.name}")
    private String applicationName;
    @NacosInjected
    private NamingService namingService;
    @PostConstruct
    public void registerInstance() throws NacosException {
        namingService.registerInstance(applicationName, "127.0.0.1", serverPort);
    }
}

啟動成功後查詢服務列表：

6、基礎API用例

這裡演示兩個基礎用法：上述步驟1的配置內容讀取，步驟4的服務列表讀取。基於swagger2管理測試接口。

@Api("Nacos接口管理")
@RestController
@RequestMapping("/nacos")
public class NacosController {

    @NacosValue(value = "${MyName:null}", autoRefreshed = true)
    private String myName;
    @NacosValue(value = "${project:null}", autoRefreshed = true)
    private String project;
    @ApiOperation(value="查詢配置信息")
    @GetMapping(value = "/info")
    public String info () {
        return myName+":"+project;
    }
    @NacosInjected
    private NamingService namingService;
    @ApiOperation(value="查詢服務列表")
    @GetMapping(value = "/getServerList")
    public List<Instance> getServerList (@RequestParam String serviceName) {
        try {
            return namingService.getAllInstances(serviceName) ;
        } catch (Exception e){
            e.printStackTrace();
        }
        return null ;
}

四、源代碼地址

GitHub·地址
https://github.com/cicadasmile/middle-ware-parent
GitEE·地址
https://gitee.com/cicadasmile/middle-ware-parent

到此這篇關於SpringBoot2 整合Nacos組件，環境搭建和入門案例詳解的文章就介紹到這瞭,更多相關SpringBoot2 整合Nacos內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：