Spring Cloud Alibaba Nacos简单实战

一、概述

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service的首字母简称，一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。

Nacos致力于解决微服务中的统一配置，服务的注册与发现等问题，它提供了一组简单易用的特性集，帮助开发者快速实现动态服务发现、服务配置、服务元数据及流量管理。

Nacos 的关键特性包括:

• 服务发现和服务健康监测

  Nacos 支持基于 DNS 和基于 RPC 的服务发现。服务提供者使用 原生SDK、OpenAPI、或一个独立的Agent TODO注册 Service 后，服务消费者可以使用DNS TODO 或HTTP&API查找和发现服务。

  Nacos 提供对服务的实时的健康检查，阻止向不健康的主机或服务实例发送请求。Nacos 支持传输层 (PING 或 TCP)和应用层 (如 HTTP、MySQL、用户自定义）的健康检查。 对于复杂的云环境和网络拓扑环境中（如 VPC、边缘网络等）服务的健康检查，Nacos 提供了 agent 上报模式和服务端主动检测2种健康检查模式。Nacos 还提供了统一的健康检查仪表盘，帮助开发者根据健康状态管理服务的可用性及流量。

• 动态配置服务

  动态配置服务可以让您以中心化、外部化和动态化的方式管理所有环境的应用配置和服务配置。

  动态配置消除了配置变更时重新部署应用和服务的需要，让配置管理变得更加高效和敏捷。

  配置中心化管理让实现无状态服务变得更简单，让服务按需弹性扩展变得更容易。

  Nacos 提供了一个简洁易用的UI (控制台样例 Demo) 帮助您管理所有的服务和应用的配置。Nacos 还提供包括配置版本跟踪、金丝雀发布、一键回滚配置以及客户端配置更新状态跟踪在内的一系列开箱即用的配置管理特性，帮助您更安全地在生产环境中管理配置变更和降低配置变更带来的风险。

• 动态 DNS 服务

  动态 DNS 服务支持权重路由，让您更容易地实现中间层负载均衡、更灵活的路由策略、流量控制以及数据中心内网的简单DNS解析服务。动态DNS服务还能让您更容易地实现以 DNS 协议为基础的服务发现，以帮助您消除耦合到厂商私有服务发现 API 上的风险。

  Nacos 提供了一些简单的 DNS APIs TODO 帮助您管理服务的关联域名和可用的 IP:PORT 列表.

• 服务及其元数据管理

  Nacos 能让您从微服务平台建设的视角管理数据中心的所有服务及元数据，包括管理服务的描述、生命周期、服务的静态依赖分析、服务的健康状态、服务的流量管理、路由及安全策略、服务的 SLA 以及最首要的 metrics 统计数据。

二、安装Nacos

Nacos的安装方式有两种，一种是源码安装、一种是直接使用已经编译好的安装包（从官网下载对应的jar包即可）

下载源码

1）、从github上克隆项目源码

git clone https://github.com/alibaba/nacos.git
cd nacos/
mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U  
ls -al distribution/target/

// change the $version to your actual path
cd distribution/target/nacos-server-$version/nacos/bin

2）从 最新稳定版本 下载 nacos-server-$version.zip 包。

unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz

三、常用API

Nacos服务端提供只提供了REST接口来完成服务注册与发现等操作，常用API如下：

• 服务注册

接口：/nacos/v1/ns/instance

方法：POST

参数：serviceName （服务名称）

​ ip（服务实例ip）

​ port（服务实例端口）

curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'

• 服务发现

接口：/nacos/v1/ns/instance/list

方法：GET

参数：serviceName （服务名称）

curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'

• 发布配置

接口：/nacos/v1/cs/configs

方法：POST

参数：dataId (数据id)

​ group（分组）

​ content（配置内容）

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"

• 获取配置

接口：/nacos/v1/cs/configs

方法：GET

参数：dataId（数据Id）

​ group（分组）

curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"

四、SpringCloud集成Nacos注册中心与配置中心

工程使用的SpringBoot版本为2.2.1.RELEASE

<parent>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-parentartifactId>
    <version>2.2.1.RELEASEversion>
    <relativePath/> 
parent>

1、SpringCloud Nacos Config的基本使用

1）、引入Nacos的SpringCloud依赖包

<dependency>
    <groupId>com.alibaba.cloudgroupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-configartifactId>
    <version>2.1.1.RELEASEversion>
dependency>

2)、配置Nacos服务端地址，由于在加载远程配置之前，需要读取Nacos配置中心的服务地址信息，所以Nacos服务地址等属性配置需要放在bootstrap文件中。

spring:
  application:
    name: spring-cloud-nacos-config-demo
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yaml

在 Nacos Spring Cloud 中，dataId 的完整格式如下：

${prefix}-${spring.profiles.active}.${file-extension}

• prefix 默认为 spring.application.name 的值，也可以通过配置项 spring.cloud.nacos.config.prefix来配置。

• spring.profiles.active 即为当前环境对应的 profile，详情可以参考 Spring Boot文档。

  注意：当 spring.profiles.active 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成 ${prefix}.${file-extension}

• file-exetension 为配置内容的数据格式，可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。

根据以上规则，在Nacos服务端创建好对应的配置文件，这里DataId与客户端的spring.application.name配置的值一致。

3）、在客户端获取Nacos Config的配置项

这里在服务端配置了server.port和application.name两个配置，然后通过@Value注解从配置中心获取这两个配置

@RestController
public class NacosConfigController {

    @Value("${application.name}")
    private String applicationName;

    @Value("${server.port}")
    private String port;

    @GetMapping("application/info")
    public String getApplicationInfo() {
        return applicationName + ":" + port;
    }
}

启动工程后，访问对应的接口，可以从Nacos配置中心上获取到对应的配置

2、Nacos注册中心的基本使用

1)、服务端配置，以上面的示例作为服务方，将其注册到nacos注册中心上，在原来的配置上增加相关依赖和配置

<dependency>
      <groupId>com.alibaba.cloudgroupId>
      <artifactId>spring-cloud-starter-alibaba-nacos-discoveryartifactId>
      <version>2.1.1.RELEASEversion>
dependency>

spring:
  application:
    name: spring-cloud-nacos-config-demo
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848 #配置中心地址
        file-extension: yaml
      discovery:
        server-addr: 127.0.0.1:8848 #服务注册地址

完成基础配置后，需要使用@EnableDiscoveryClient打开服务注册与发现的功能

@EnableDiscoveryClient
@SpringBootApplication
public class SpringCloudNacosDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringCloudNacosDemoApplication.class, args);
    }

}

2)、消费方开发，消费方会通过Feign调用服务方的接口，消费方在服务注册配置与服务方的配置一样，在此基础上增加Feign相关的代码，实现微服务调

@FeignClient("spring-cloud-nacos-config-demo")
public interface FeignService {

    @GetMapping("application/info")
    String getApplicationInfo();
}

在Controller注入Feign客户端，调用服务方的application/info接口

@RestController
public class TestController {

    @Autowired
    private FeignService feignService;

    @GetMapping("feign/test")
    public String test(){
        return feignService.getApplicationInfo();
    }
}

3)、启动服务方和消费方后，可以在nacos注册中心看到两个服务的注册信息

调用消费方的接口，可以正常通过feign调用服务方接口，结果如下：

五、Nacos高可用部署

在分布式架构中，任何中间件或者应用都不允许单点存在，所以一般开源组件都会自己支持高可用集群解决方案。Nacos提供了类似于Zookeeper的集群架构，包含一个Leader和多个Follower节点，它采用Raft算法来保证数据的一致性。

1）集群部署配置

nacos的集群化部署很简单，在conf目录下，有个cluster.conf.example文件，该文件是集群配置的样例文件，将此文件重命名为cluster.conf，然后文件里配置nacos相关服务的地址即可，集群里，nacos实例的集群配置需要一致。

192.168.31.38:8848
192.168.31.38:8849
192.168.31.38:8850

2）配置数据库

nacos默认会使用Derby数据库，它是一种文件类型的数据库，在使用上有一定的局限性，这里我们将数据库调整为MySQL。

在conf目录下，有个nacos-mysql.sql文件，可以使用此脚本创建nacos所需的数据库和表。

初始化完数据库后，分别修改集群中所有nacos实例的application.properties文件，增加连接MySQL的配置

spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/learn_sql?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=root
db.password.0=xxxx

3）分别启动三个nacos

sh ./startup.sh

这样便完成了nacos的集群化部署。

原文《Nacos简单介绍与实战》

更多好文，请关注微信公众号【DevUnion】获取。