简介
Nacos 是 Dynamic Naming and Configuration Service 的首字母简称,一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
Nacos 致力于帮助你发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集,帮助你快速实现动态服务发现、服务配置、服务元数据及流量管理。
Nacos 帮助你更敏捷和容易地构建、交付和管理微服务平台。
运行前准备
数据库初始化
将 nacos-mysql.sql 在自己的数据库初始化
本地jar运行
下载及运行
下载地址
包含源码和打包好的压缩包,运行nacos-server中的 start.cmd
需要配置 JAVA_HOME
环境变量,实际运行的是target下的server.jar,最终运行的是nacos-console中的Nacos类。
运行遇到的问题
问题1
"nacos is starting with cluster"
Error occurred during initialization of VM
Could not reserve enough space for 2097152KB object heap
内存不足,需要2G,可以修改start.cmd中的启动参数
set "NACOS_JVM_OPTS=-server -Xms1g -Xmx1g -Xmn1g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m -XX:-OmitStackTraceInFastThrow -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=%BASE_DIR%\logs\java_heapdump.hprof -XX:-UseLargePages"
将Xms2g改为Xms1g。
问题2
ErrMsg:jmenv.tbsite.net
默认是集群运行,需要单机运行
start.cmd -m standalone
问题3
UnsupportedOperationException:Cannot determin JNI Library name for ARCH='x86' OS='windows 10' name='rocksdb'
本地的jdk版本有问题,使用的是32位的版本,需要使用64位的。
源码运行
修改数据库连接参数
nacos-console下的application.properties文件
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://xxx:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=10000&autoReconnect=true
db.user=xxx
db.password=xxx
添加启动参数 -Dnacos.standalone=true,运行nacos-console子项目下的Nacos启动类。
nacos默认使用内置数据库apache的derby数据库。如果配置了spring.datasource.platform=mysql,就使用外部数据库mysql。具体逻辑判断在 DynamicDataSource 和 PropertyUtil 类中。NacosDefaultPropertySourceEnvironmentPostProcessor 会查找META-INF\nacos-default.properties文件,其中包含很多默认属性,如服务器端口server.port=8848,如果设置了自定义配置,就会覆盖默认的。
源码编译错误
Error:(21, 44) java: 程序包com.alibaba.nacos.consistency.entity不存在
IDEA中通过protobuf插件编译一下
通过docker运行
下载镜像
docker pull nacos/nacos-server:2.0.2
运行
docker run -d --name nacos-server \
-e MODE=standalone \
-e SPRING_DATASOURCE_PLATFORM=mysql \
-e MYSQL_SERVICE_HOST=ip \
-e MYSQL_SERVICE_PORT=port \
-e MYSQL_SERVICE_DB_NAME=nacos \
-e MYSQL_SERVICE_USER=root \
-e MYSQL_SERVICE_PASSWORD=pwd \
-e MYSQL_DATABASE_NUM=1 \
-e JVM_XMS=128m \
-e JVM_XMX=128m \
-p 8848:8848 nacos/nacos-server:2.0.2
启动参数可以参考nacos-server-docker镜像仓库
后台操作
开启服务器防火墙的 8848 端口限制,浏览器访问 http://ip:8848/nacos
,默认账号密码 nacos/nacos。
给客户端添加配置
- namespace: 相当于环境,可以为dev,test,pro等
- dataId: 相当于项目,例如myadmin
- group: 相当于项目的分组,基本不用
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
<version>2.2.1.RELEASE</version>
</dependency>
bootstrap.yml
spring:
application:
name: myadmin
cloud:
nacos:
config:
server-addr: http://localhost:8848
namespace: 2a055716-5400-4fd5-b580-afc1eacfec91 #命名空间ID
file-extension: yaml
enabled: true
name: ${spring.application.name}
开启客户端鉴权
nacos-console的application.properties中
nacos.core.auth.enabled=true
先创建用户,再给用户创建角色,再给角色绑定权限(命名空间)
客户端
spring:
application:
name: demo1
cloud:
nacos:
config:
server-addr: http://ip:8848
namespace: d8b0df04-aa58-4a5b-b582-7d133b9e8b2c #命名空间ID
username: nacos
password: nacos
extension-configs:
- data-id: server.yaml
refresh: true
原理
客户端读取配置
- NacosConfigBootstrapConfiguration注入NacosPropertySourceLocator类(具体读取配置),是为了兼容spring-cloud的读取配置中心的规则。
- NacosPropertySourceLocator类内部通过NacosConfigService类来发送请求读取配置
http://localhost:8848/nacos/v1/cs/configs
自动刷新
@Data
@Component
@RefreshScope
public class UserProperties {
@Value("${myuser.name}")
private String name;
}
@RestController
@RequestMapping("/test")
@Api(tags = "测试接口")
@Slf4j
public class TestController {
@Autowired
private UserProperties userProperties;
@GetMapping("/testRefreshQuery")
@ApiOperation("测试刷新对象查询")
public String testRefreshQuery() {
return userProperties.getName();
}
}
客户端
主要原理就是客户端定时通过长轮训去服务端拉取数据。
- NacosContextRefresher监听ApplicationReadyEvent事件,注册Nacos配置改变的事件监听器(AbstractSharedListener的匿名子类)
- NacosConfigService中的ClientWorker会开启一个定时任务
- LongPollingRunnable为具体的长轮训任务,具体为checkUpdateDataIds()方法
- 请求头Long-Pulling-Timeout设置超时时间30秒。
- 获取到配置改变之后就会通知监听器
- 监听器发布RefreshEvent时间
- RefreshEventListener处理此事件,调用ContextRefresher的refresh()方法。
- 之后就是SpringCloud的自动刷新机制了(@RefreshScope注解)。
http://localhost:8848/nacos/v1/cs/configs/listener
Nacos配置中心集群原理及源码分析
Nacos配置中心原理