Nacos
第一节 Nacos
介绍
1. 什么是 Nacos
Nacos
致力于帮助您发现、配置和管理微服务。Nacos
提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
Nacos
帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos
是构建以“服务”为中心的现代应用架构 的服务基础设施。
2. Nacos
数据模型
第二节 Nacos
配置管理
1. 配置中心搭建
-
解压
nacos-server-1.4.2.tar.gz
-
进入bin 目录,找到
startup.cmd
,使用文本编辑器编辑set MODE="cluster" # 将cluster修改为standalone
-
双击
startup.cmd
启动Nacos
默认账号和密码均是nacos
2. Nacos
配置 GUI 介绍
命名空间
用于进行粗粒度的配置隔离。不同的命名空间下,可以存在相同的 Group 或 Data ID 的配置。Namespace
的常用场景之一是不同环境的配置的区分隔离,例如开发测试环境和生产环境的资源(如配置、服务)隔离等。
配置分组
Nacos
中的一组配置集,是组织配置的维度之一。通过一个有意义的字符串(如 Buy 或 Trade )对配置集进行分组,从而区分 Data ID 相同的配置集。当您在 Nacos
上创建一个配置时,如果未填写配置分组的名称,则配置分组的名称默认采用 DEFAULT_GROUP 。配置分组的常见场景:不同的应用或组件使用了相同的配置类型,如 database_url
配置和 MQ_topic
配置。
配置集 ID
Nacos
中的某个配置集的 ID。配置集 ID 是组织划分配置的维度之一。Data ID 通常用于组织划分系统的配置集。一个系统或者应用可以包含多个配置集,每个配置集都可以被一个有意义的名称标识。Data ID 通常采用类 Java 包(如 com.taobao.tc.refund.log.level
)的命名规则保证全局唯一性。此命名规则非强制。
配置
在系统开发过程中,开发者通常会将一些需要变更的参数、变量等从代码中分离出来独立管理,以独立的配置文件的形式存在。目的是让静态的系统工件或者交付物(如 WAR,JAR 包等)更好地和实际的物理运行环境进行适配。配置管理一般包含在系统部署的过程中,由系统管理员或者运维人员完成。配置变更是调整系统运行时的行为的有效手段。
配置项
一个具体的可配置的参数与其值域,通常以 param-key=param-value
的形式存在。例如我们常配置系统的日志输出级别(logLevel=INFO|WARN|ERROR
) 就是一个配置项。
配置管理
系统配置的编辑、存储、分发、变更管理、历史版本管理、变更审计等所有与配置相关的活动。
3. Nacos
配置信息获取
3.1 创建工程 spring-cloud-alibaba-demo
<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.qf</groupId>
<artifactId>spring-cloud-alibaba-demo</artifactId>
<version>1.0</version>
<modules>
<module>erp-user</module>
</modules>
<properties>
<java.version>1.8</java.version>
<spring.cloud.alibaba-version>2.2.5.RELEASE</spring.cloud.alibaba-version>
</properties>
<name>spring-cloud-alibaba-demo</name>
<packaging>pom</packaging>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.5.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<description>Demo project for Spring Boot</description>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>${spring.cloud.alibaba-version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
</project>
3.2 创建子工程 erp-user
<?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>spring-cloud-alibaba-demo</artifactId>
<groupId>com.qf</groupId>
<version>1.0</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>erp-user</artifactId>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
</dependencies>
</project>
3.3 编写测试类
package com.qf.spring.cloud.alibaba;
import com.alibaba.nacos.api.NacosFactory;
import com.alibaba.nacos.api.config.ConfigService;
import com.alibaba.nacos.api.exception.NacosException;
public class ErpUserApp {
public static void main(String[] args) throws NacosException {
//Nacos工厂根据提供的配置中心地址创建配置服务对象,默认读取public命名空间
ConfigService configService = NacosFactory.createConfigService("localhost:8848");
//配置服务读取给定的分组下的Data ID对应的配置文件,读取超时时间为3000毫秒
String config = configService.getConfig("com.qf.erp.user", "DEFAULT_GROUP", 3000);
System.out.println(config);
}
}
4. 获取命名空间中的配置
package com.qf.spring.cloud.alibaba;
import com.alibaba.nacos.api.NacosFactory;
import com.alibaba.nacos.api.config.ConfigService;
import com.alibaba.nacos.api.exception.NacosException;
import java.util.Properties;
public class ErpUserApp {
public static void main(String[] args) throws NacosException {
//这里填写初始化信息
Properties properties = new Properties();
//服务器地址
properties.put("serverAddr", "localhost:8848");
//命名空间必须填写命名空间的ID
properties.put("namespace", "aa2a4291-0dd3-4147-8fa2-e845c0411368");
//Nacos工厂根据提供的配置中心地址创建配置服务对象,默认读取public命名空间
ConfigService configService = NacosFactory.createConfigService(properties);
//配置服务读取给定的分组下的Data ID对应的配置文件,读取超时时间为3000毫秒
final String config = configService.getConfig("com.qf.erp.user", "DEFAULT_GROUP", 3000);
System.out.println(config);
}
}
5. 客户端感知配置信息更改
package com.qf.spring.cloud.alibaba;
import com.alibaba.nacos.api.NacosFactory;
import com.alibaba.nacos.api.config.ConfigService;
import com.alibaba.nacos.api.config.listener.Listener;
import com.alibaba.nacos.api.exception.NacosException;
import java.io.IOException;
import java.util.Properties;
import java.util.concurrent.Executor;
public class ErpUserApp {
public static void main(String[] args) throws NacosException, IOException {
//这里填写初始化信息
Properties properties = new Properties();
//服务器地址
properties.put("serverAddr", "localhost:8848");
//命名空间必须填写命名空间的ID
properties.put("namespace", "aa2a4291-0dd3-4147-8fa2-e845c0411368");
//Nacos工厂根据提供的配置中心地址创建配置服务对象,默认读取public命名空间
ConfigService configService = NacosFactory.createConfigService(properties);
//配置服务读取给定的分组下的Data ID对应的配置文件,读取超时时间为3000毫秒
final String config = configService.getConfig("com.qf.erp.user", "DEFAULT_GROUP", 3000);
System.out.println(config);
configService.addListener("com.qf.erp.user", "DEFAULT_GROUP", new Listener() {
@Override
public Executor getExecutor() {
return null;
}
@Override
public void receiveConfigInfo(String configInfo) {
System.out.println("配置文件发生了变化:" + configInfo);
}
});
System.in.read();
}
}
第三节 Nacos
作为配置中心
1. 修改 pom.xml
<!-- 增加如下依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
2. 新增bootstrap.yml
spring:
application:
name: erp-user #应用名称
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848 # 配置中心地址
username: nacos # 访问账号
password: nacos # 访问密码
file-extension: yaml # 配置文件后缀名
namespace: aa2a4291-0dd3-4147-8fa2-e845c0411368 # 命名空间ID,如果此项不配置,则读取public命名空间
group: DEFAULT_GROUP # 组名, 如果此项不配置,则读取DEFAULT_GROUP
name: com.qf.erp.user # Data ID, 如果此项不配置,则读取名称为应用名.后缀名。如这里的erp-user.yaml
3. 修改启动类
package com.qf.spring.cloud.alibaba;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class ErpUserApp {
public static void main(String[] args) {
SpringApplication.run(ErpUserApp.class, args);
}
}
4. 进入 Nacos
修改配置文件
server:
port: 50000
5. 启动测试
6. 配置文件刷新
-
进入
Nacos
修改配置文件server: port: 50000 content: abcde
-
编写控制器
package com.qf.spring.cloud.alibaba.controller; import org.springframework.beans.factory.annotation.Value; import org.springframework.cloud.context.config.annotation.RefreshScope; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController @RequestMapping("/user") @RefreshScope //配置文件刷新时生效 public class UserController { @Value("${content}") private String content; @GetMapping public String show(){ return content; } }
-
启动程序访问
-
修改配置文件中content的值
server: port: 50000 content: abcde
-
再次刷新页面,查看结果
第四节 Nacos
作为注册中心
1. Nacos
服务配置介绍
服务
通过预定义接口网络访问的提供给客户端的软件功能。
服务名
服务提供的标识,通过该标识可以唯一确定其指代的服务。
服务注册中心
存储服务实例和服务负载均衡策略的数据库。
服务发现
在计算机网络上,(通常使用服务名)对服务下的实例的地址和元数据进行探测,并以预先定义的接口提供给客户端进行查询。
元信息
Nacos
数据(如配置和服务)描述信息,如服务版本、权重、容灾策略、负载均衡策略、鉴权配置、各种自定义标签 (label),从作用范围来看,分为服务级别的元信息、集群的元信息及实例的元信息。
应用
用于标识服务提供方的服务的属性。
服务分组
不同的服务可以归类到同一分组。
2. Nacos注册中心搭建
1. 修改pom.xml
<!-- 增加如下依赖 -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
2. 修改启动类
package com.qf.spring.cloud.alibaba;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
@SpringBootApplication
@EnableDiscoveryClient //启用DiscoveryClient的实现,将自己注册到注册中心
public class ErpUserApp {
public static void main(String[] args) {
SpringApplication.run(ErpUserApp.class, args);
}
}
3. 修改 bootstrap.yml
配置
spring:
application:
name: erp-user #应用名称
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848 # 配置中心地址
# username: nacos # 访问账号
# password: nacos # 访问密码
file-extension: yaml # 配置文件后缀名
namespace: aa2a4291-0dd3-4147-8fa2-e845c0411368 # 命名空间ID,如果此项不配置,则读取public命名空间
group: DEFAULT_GROUP # 组名, 如果此项不配置,则读取DEFAULT_GROUP
name: com.qf.erp.user # Data ID, 如果此项不配置,则读取名称为应用名.后缀名。如这里的erp-user.yaml
username: nacos
password: nacos
discovery:
server-addr: 127.0.0.1:8848
namespace: aa2a4291-0dd3-4147-8fa2-e845c0411368 # 命名空间ID,如果此项不配置,则注册至public命名空间
group: chengdu # 组名, 如果此项不配置,则默认为DEFAULT_GROUP
第五节 Nacos
集群搭建
1. 创建数据库 nacos
然后在 nacos
库中执行nacos\conf\nacos-mysql.sql
2. 修改application.properties
server.port=8848
spring.datasource.platform=mysql
### Count of DB:
db.num=1
### Connect URL of DB:
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=root
db.password.0=root
3. 修改 cluster.conf.example
192.168.2.3:8848 # 这里注意不要使用localhost或者127.0.0.1,需要使用本机IP地址
192.168.2.3:8858 # 端口尽量相差10个以上,nacos内部还内置了其他服务,需要占用的端口与主端口相差10个
192.168.2.3:8868
将文件名修改为cluster.conf
4. 拷贝 nacos
文件夹 3 份
每一份中修改端口与步骤3的端口匹配