rnacos是一个用rust实现的nacos服务。
rnacos是一个轻量、 快速、稳定、高性能的服务；包含注册中心、配置中心、web管理控制台功能，支持单机、集群部署。
rnacos设计上完全兼容最新版本nacos面向client sdk 的协议（包含1.x的http OpenApi，和2.x的grpc协议）, 支持使用nacos服务的应用平迁到 rnacos。
rnacos相较于java nacos来说，是一个提供相同功能，启动更快、占用系统资源更小、性能更高、运行更稳定的服务。
详细说明可以看 rnacos book
一方面自己学习 rust 后想，写个中间件实践rust网络并发编程。
另一方面，自己开发应用有用到 nacos，个人云服务部署一个nacos太重，本地开发测试开nacos也比较重。
本人能读java源码又能写rust，分析确认开发可行性后，决定先写一个最小功能集给自己用。
自己写完后用下来整体体验很顺畅，就想开源出来给有需要的人使用。
最开始只兼容v1.x sdk协议，没有配置控制台，后面补上v2.x协议和控制台发才放出来。
- 开发测试环境使用nacos，nacos服务可以换成rnacos。启动更快，秒启动。
- 个人资源云服务部署的 nacos，可以考虑换成rnacos。资源占用率低: 包10M 出头，不依赖 JDK；运行时 cpu 小于0.5% ，小于5M（具体和实例有关）。
- 使用非订制nacos服务 ，希望能提升服务性能与稳定性，可以考虑迁移到 rnacos。
【单机部署】
方式1：从 github release 下载对应系统的应用包，解压后即可运行。
linux 或 mac
# 解压
tar -xvf rnacos-x86_64-apple-darwin.tar.gz
# 运行
./rnacoswindows 解压后直接运行 rnacos.exe 即可。
方式2: 通过docker 运行
#stable是最新正式版本号，也可以指定镜像版本号，如： qingpan/rnacos:v0.3.0
docker pull qingpan/rnacos:stable
docker run --name mynacos -p 8848:8848 -p 9848:9848 -d qingpan/rnacos:stable
docker 的容器运行目录是 /io，会从这个目录读写配置文件
方式3：通过 cargo 编译安装
# 安装
cargo install rnacos
# 运行
rnacos
方式4: 下载源码编译运行
git clone https://github.com/heqingpan/rnacos.git
cd rnacos
cargo build --release
cargo run
测试、试用推荐使用第1、第2种方式，直接下载就可以使用。
在linux下第1、第2种方式默认是musl版本(性能比gnu版本差一些)，在生产服务对性能有要求的可以考虑使用第3、第4种在对应环境编译gnu版本部署。
启动配置:
| 参数KEY | 内容描述 | 默认值 | 示例 | 开始支持的版本 |
|---|---|---|---|---|
| RNACOS_HTTP_PORT | rnacos监听http端口 | 8848 | 8848 | 0.1.x |
| RNACOS_GRPC_PORT | rnacos监听grpc端口 | 默认是 HTTP端口+1000 | 9848 | 0.1.x |
| RNACOS_HTTP_WORKERS | http工作线程数 | cpu核数 | 8 | 0.1.x |
| RNACOS_CONFIG_DB_FILE | 配置中心的本地数据库文件地址【0.2.x后不在使用】 | config.db | config.db | 0.1.x |
| RNACOS_CONFIG_DB_DIR | 配置中心的本地数据库sled文件夹, 会在系统运行时自动创建 | nacos_db | nacos_db | 0.2.x |
| RNACOS_RAFT_NODE_ID | 节点id | 1 | 1 | 0.3.0 |
| RNACOS_RAFT_NODE_ADDR | 节点地址Ip:GrpcPort,单节点运行时每次启动都会生效；多节点集群部署时，只取加入集群时配置的值 | 127.0.0.1:GrpcPort | 127.0.0.1:9848 | 0.3.0 |
| RNACOS_RAFT_AUTO_INIT | 是否当做主节点初始化,(只在每一次启动时生效) | 节点1时默认为true,节点非1时为false | true | 0.3.0 |
| RNACOS_RAFT_JOIN_ADDR | 是否当做节点加入对应的主节点,LeaderIp:GrpcPort；只在第一次启动时生效 | 空 | 127.0.0.1:9848 | 0.3.0 |
| RUST_LOG | 日志等级:debug,info,warn,error;所有http,grpc请求都会打info日志,如果不观注可以设置为error减少日志量 | info | error | 0.3.0 |
启动配置方式可以参考： 运行参数说明
【集群部署】
集群部署参考： 集群部署
服务启动后，即可运行原有的 nacos 应用。
# 设置配置
curl -X POST 'http://127.0.0.1:8848/nacos/v1/cs/configs' -d 'dataId=t001&group=foo&content=contentTest'
# 查询
curl 'http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=t001&group=foo'
# 注册服务实例
curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance' -d 'port=8000&healthy=true&ip=192.168.1.11&weight=1.0&serviceName=nacos.test.001&groupName=foo&metadata={"app":"foo","id":"001"}'
curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance' -d 'port=8000&healthy=true&ip=192.168.1.12&weight=1.0&serviceName=nacos.test.001&groupName=foo&metadata={"app":"foo","id":"002"}'
curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance' -d 'port=8000&healthy=true&ip=192.168.1.13&weight=1.0&serviceName=nacos.test.001&groupName=foo&metadata={"app":"foo","id":"003"}'
# 查询服务实例
curl "http://127.0.0.1:8848/nacos/v1/ns/instance/list?&namespaceId=public&serviceName=foo%40%40nacos.test.001&groupName=foo&clusters=&healthyOnly=true"
具体的用法参考 nacos.io 的用户指南。
nacos-client
<dependency>
<groupId>com.alibaba.nacos</groupId>
<artifactId>nacos-client</artifactId>
<version>${nacos.version}</version>
</dependency>| 协议 | 验证过版本 | 推荐版本 |
|---|---|---|
| grpc协议(2.x) | 2.1.0 | >2.1.x |
| http协议(1.x) | 1.4.1 | >1.4.x |
启动服务后可以在浏览器通过 http://127.0.0.1:8848/ 访问rnacos控制台。
主要包含命名空间管理、配置管理、服务管理、服务实例管理。
1、配置管理
配置列表管理
新建、编辑配置
2、服务列表管理
3、服务实例管理
4、命名空间管理
这里把 nacos 服务的功能分为三块 1、面向 SDK 的功能 2、面向控制台的功能 3、面向部署、集群的功能
每一块做一个对nacos服务的对比说明。
访问认证：
- 有提供获取认证token的接口
- 实际请求暂不支持认证，都算认证通过。
配置中心：
- 支持配置中心的基础功能、支持维护配置历史记录
- 兼容配置中心的SDK协议
- 暂不支持灰度发布、暂不支持tag隔离
注册中心：
- 支持注册中心的基础功能
- 兼容配置中心的SDK协议
- 暂不支持1.x的 udp 实例变更实时通知，只支持 2.x 版本grpc实例变更实时通知 。最开始的版本也有支持过udp实例变更 通知，后面因支持 grpc 的两者不统一，就暂时去掉，后继可以考虑加回去。
访问认证： 暂时不开启认证
命名空间：
- 支持管理命名空间列表
- 支持切换命名空间查询配置、服务数据。
配置中心：
- 支持配置中心信息管理
- 支持配置导入、导出,其文件格式与nacos兼容
- 支持配置历史记录查看与恢复
- 暂不支持tag的高级查询
- 暂不支持查询配置监听记录
服务中心：
- 支持注册中心的服务、服务实例管理
- 暂不支持查询监听记录
- 支持单机部署
- 支持集群部署。集群部署配置中心数据使用raft+节点本地存储组成的分布式存储，不需要依赖mysql。具体参考 集群部署说明
| 模块 | 场景 | 单节点qps | 集群qps | 总结 |
|---|---|---|---|---|
| 配置中心 | 配置写入,单机模式 | 1.5万 | 1.5万 | |
| 配置中心 | 配置写入,集群模式 | 1.8千 | 1.5千 | 接入raft后没有充分优化,待优化,理论上可接近单机模式 |
| 配置中心 | 配置查询 | 8万 | n*8万 | 集群的查询总qps是节点的倍数 |
| 注册中心 | 服务实例注册,http协议 | 1.2万 | 1.0万 | 注册中心单机模式与集群模式写入的性能一致 |
| 注册中心 | 服务实例注册,grpc协议 | 1.2万 | 1.2万 | grpc协议压测工具没有支持，目前没有实际压测，理论不会比http协议低 |
| 注册中心 | 服务实例心跳,http协议 | 1.2万 | 1.0万 | 心跳是按实例计算和服务实例注册一致共享qps |
| 注册中心 | 服务实例心跳,grpc协议 | 8万以上 | n*8万 | 心跳是按请求链接计算,且不过注册中心处理线程,每个节点只需管理当前节点的心跳，集群总心跳qps是节点的倍数 |
| 注册中心 | 查询服务实例 | 3万 | n*3万 | 集群的查询总qps是节点的倍数 |
注： 具体结果和压测环境有关
详细信息可以参考 性能与容量说明
- 配置中心
- 控制台支持导出
- 查询配置历史变更记录
- 支持历史记录回滚。
- 回滚时支持配置内容比较。
- 支持灰度发布与tag配置隔离 (优先级暂定晚于支持集群部署功能)
- 支持查询服务监听列表
- 注册中心 8. [ ] 支持服务路由类型的设置(这部分涉及插件,暂定不支持) 9. [ ] 支持查询服务监听列表
- 配置中心数据支持sled + raft存储
- 注册中心支持集群
- 支持开启请求认证
- 集群用户信息同步
- 集群认证token同步
- 请求token校验
单实例：
前端应用因依赖nodejs,所以单独放到另一个项目 rnacos-console-web ,再通过cargo 把打包好的前端资源引入到本项目,避免开发rust时还要依赖nodejs。
rnacos架构设计参考： 架构