Nacos使用记录

Nacos安装

环境

1. 64bit操作系统，支持linux/unix/mac/windows，推荐使用linux/unix/mac
2. 64bit java开发包-jdk1.8+
3. maven 3.2.x+

下载方式

1. 方式一： 源码打包

git clone https://github.com/alibaba/nacos.git
# 此处可替换为从gitee镜像获取源码
# https://gitee.com/mirrors/Nacos
cd nacos/
mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U  
# 打包好的可执行文件在 ./distribution/target/ 下
# 进入当前版本文件下
cd distribution/target/nacos-server-$version/nacos/bin

2. 方式二： 下载编译后的压缩包

# 从github下载当前稳定版本
# 版本地址
https://github.com/alibaba/nacos/releases
# 下载地址  https://github.com/alibaba/nacos/releases/tag/1.4.1
# 根据操作系统需要选择 nacos-server-1.4.1.tar.gz 或者 nacos-server-1.4.1.zip
# 解压缩
unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz
# 进入可执行文件
cd nacos/bin

服务启动、停止

linux/unix/mac

# 启动
sh startup.sh -m standalone  # 其中standalone表示单机模式，不加该模式标识直接启动需要配置支持（db）
# 停止
sh shutdown.sh

windows

# 启动
cmd startup.cmd -m standalone   # powerShell方式

# 启动
startup.cmd -m standalone   # 命令提示符窗口cmd方式启动

# 停止
cmd shutdown.cmd 
# 或者双击该文件

管理Console

管理地址

启动了Nacos后，启动日志会显示当前console的管理地址
一般为： http://127.0.0.1:8848/nacos/index.html
默认账号密码： nacos/nacos

管理项

命名空间管理-资源

可查看当前命名空间列表。
通过输入空间id（可自动生成）、命名空间名（e.g. Pulic)、描述新增命名空间
可查看、编辑、删除命名空间
该命名空间名称即为角色所对应的的资源

用户与角色管理

用户管理

支持用户列表查看
支持增加、删除用户
支持修改用户密码

角色管理

支持查看角色列表
支持自定义增加角色名与用户绑定关系

权限管理

支持查看权限里诶包
支持输入角色名绑定资源以及对该资源的只读、只写、读写控制
资源只可选择

集群管理-有命名空间属性

可管理该集群下的所有节点信息，可输入节点IP查询搜索

e.g.

节点IP：  192.168.1.x:8848
节点状态： UP
节点元数据：
{
    "lastRefreshTime": 1611553300935,
    "raftPort": "7848",
    "version": "1.4.1"
}

服务管理-有命名空间属性

• 服务列表管理

支持查看服务列表： 服务名、分组、集群数目、实例数、健康实例数、出发保护阈值等
支持对服务进行操作： 
支持服务名称、分组名称检索；支持隐藏空服务
支持创建服务： 服务名、保护阈值、分组（默认DEFAULT_GROUP）、元数据、服务路由类型等设定

• 订阅者列表

支持查看订阅者列表： 地址、客户端版本、应用名
支持服务名与分组名称检索

配置管理-有命名空间属性

1. 配置列表

支持查看配置雷柏啊： dataId、group、归属应用、操作
支持dataId、group检索；高级检索： 归属应用、标签
支持导出、导入配置
支持新增配置： DataId、group、（高级选项：归属应用、标签）、描述、格式（支持text/json/xml/yaml/html/properties）、配置内容体设置
支持操作配置：

2. 历史版本

支持30天内的版本历史查询以及DataId、group检索
操作记录
支持详情查看与回滚

3. 监听查询

支持DataId、group、 以及查询纬度（配置、Ip）检索

服务注册&发现和配置管理-Nacos Open API

服务注册

curl -X POST "http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=com.pulc.test&ip=192.168.1.26&port=8888"

# 正常返回： ok

该服务注册后可通过服务列表正常查询到
一定时间？后变为控服务
一定时间？后该服务从服务列表移除

服务发现

curl -X GET "http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=com.pulc.test"
# 正常服务状态返回结果：
{
    "hosts": [
        {
            "ip": "192.168.1.26",
            "port": 8888,
            "valid": true,
            "healthy": true,
            "marked": false,
            "instanceId": "192.168.1.26#8888#DEFAULT#DEFAULT_GROUP@@com.pulc.test",
            "metadata": {},
            "enabled": true,
            "weight": 1,
            "clusterName": "DEFAULT",
            "serviceName": "com.pulc.test",
            "ephemeral": true
        }
    ],
    "dom": "com.pulc.test",
    "name": "DEFAULT_GROUP@@com.pulc.test",
    "cacheMillis": 3000,
    "lastRefTime": 1611557666927,
    "checksum": "a2d0bed90828c86ee36ba768b60175ea",
    "useSpecifiedURL": false,
    "clusters": "",
    "env": "",
    "metadata": {}
}

# 空服务状态返回结果：
{
    "dom": "com.pulc.test",
    "name": "DEFAULT_GROUP@@com.pulc.test",
    "cacheMillis": 3000,
    "lastRefTime": 1611557515555,
    "checksum": "5edd28e8357bf86cc6f513729ef5dc80",
    "useSpecifiedURL": false,
    "clusters": "",
    "env": "",
    "hosts": [],
    "metadata": {}
}

# 自动从服务列表移除后返回：（已移除）
{"name":"DEFAULT_GROUP@@com.pulc.test","clusters":"","cacheMillis":3000,"hosts":[]}

发布配置

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=com.pulc.cfg.dataId&group=testGroup&content=IncredibleV2"

# 返回 true

获取配置

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

# 返回： 发布时的content键的Value值

其他api能力-见Open-API指南

nacos Open-API指南

参考：
nacos官方文档
nacos Open-API指南