注册配置治理兼容 Nacos SDK 接入

使用场景
如果您希望使用 Polaris（北极星）代替 Nacos 作为新的注册配置中心，Polaris（北极星）提供了兼容 Nacos SDK 的接入方式，您仅需要更改应用中的 nacos-client 的服务端接入地址即可。无需修改代码或者 pom 依赖。
使用限制
1. 不同 Polaris（北极星）实例版本兼容的 Nacos SDK 开源版本及接入协议
Polaris（北极星）实例版本
兼容的 Nacos SDK 开源版本
备注
2.0.2以前版本（不含开发版）
不兼容
﻿
2.0.2（不含开发版）
兼容 Nacos SDK 2.x 使用 gRPC 协议接入
2.4及以后版本部分接口不支持，详见下述接口范围
2.1.0及更新版本（不含开发版）
兼容 Nacos SDK 2.x 使用 gRPC协议、HTTP 协议接入
兼容 Nacos SDK 1.x 使用 HTTP 协议接入
2.4及以后版本部分接口不支持，详见下述接口范围
2. Polaris（北极星）兼容的Nacos SDK 接口范围如下。
Nacos客户端接口
﻿
gRPC 协议
HTTP 协议
配置中心
获取配置
✔
✔
﻿
监听配置
✔
✔
﻿
删除监听
✔
✔
﻿
发布配置
✔
✔
﻿
删除配置
✔
✔
﻿
带监听配置的获取配置
×
-
﻿
带CAS的发布配置
×
-
注册中心
注册实例
✔
✔
﻿
注销实例
✔
✔
﻿
获取全部实例
✔
✔
﻿
获取健康或不健康实例列表
✔
✔
﻿
获取一个健康实例
✔
✔
﻿
监听服务
✔
✔
﻿
取消监听服务
✔
✔
﻿
批量注册服务实例
×
-
﻿
批量注销服务实例
×
-
﻿
带选择器的监听服务
×
-
﻿
取消带选择器的监听服务
×
-
﻿
分页获取服务列表
×
-
﻿
获取当前客户端所监听的服务列表
×
-
3. 功能点差异。
功能点
差异
备注
鉴权能力
默认写鉴权，读不鉴权
﻿
注册能力
Polaris（北极星）注册都会写入数据库
﻿
                         服务模型
Polaris（北极星）没有group概念
Polaris（北极星）服务名称由 Nacos group 字段值和 Nacos service 字段值拼接而成。
控制台
Nacos和Polaris（北极星）控制台存在差异。
﻿
使用说明
本文通过服务注册和配置管理两个场景介绍Polaris（北极星）接入的使用说明。
服务注册
1. Nacos 服务名和Polaris（北极星）服务名映射关系
Nacos 字段
Nacos 字段值
Polaris（北极星）字段
Polaris（北极星）字段值描述
namespace
默认命名空间/非默认命名空间 ID
namespace
default/命名空间名称。
group
DEFAULT_GROUP
service
Polaris（北极星）服务名称由 Nacos group 字段值和 Nacos service 字段值拼接而成。${group}__${service} 为最终的Polaris（北极星）服务名, 如果 group == DEFAULT_GROUP，则服务名为 ${service}。
service
DEFAULT_GROUP
service
﻿
cluster
DEFAULT
instance.metadata
作为实例标签的一部分, 实例标签 key 为 internal-nacos-cluster。
2. 修改服务端接入地址。
Spring Cloud Alibaba
原生 Nacos-Client
Dubbo
1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
spring.cloud.nacos.username="可任意值，如：username"
spring.cloud.nacos.password="Polaris（北极星）用户/用户组的资源访问凭据 Token"
spring.cloud.nacos.discovery.server-addr="Polaris（北极星）服务端 IP:8848"
spring.cloud.nacos.discovery.namespace="Polaris（北极星）命名空间名称"
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏权限控制 ，选择用户或者用户组，单击查看Token 。
﻿
3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏引擎管理，在实例信息页可以查看IP地址。
﻿
1. 原生Nacos Client修改：Polaris（北极星）服务端地址和服务端访问账密：
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "Polaris（北极星）服务端IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "Polaris（北极星）命名空间名称");
properties.put(PropertyKeyConst.USERNAME, "可任意值");
properties.put(PropertyKeyConst.PASSWORD, "Polaris（北极星）用户/用户组的资源访问凭据 Token");
﻿
// 创建注册发现客户端
NamingService namingService = NacosFactory.createNamingService(properties);
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在 服务治理中心 下，点击侧边栏 权限控制 ，选择目标Polaris（北极星）引擎实例。
选择 用户 或者 用户组，点击 查看Token 。
﻿
3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在 服务治理中心 下，点击侧边栏 实例列表 ，点击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。
﻿
1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
dubbo
 registry
   address: nacos://Polaris（北极星）服务端IP:8848?username=可任意值&password=Polaris（北极星）用户/用户组的资源访问凭据 Token
   parameters.namespace: Polaris（北极星）命名空间名称
  metadata-report
    address: nacos://Polaris（北极星）服务端IP:8848
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏权限控制 ，选择目标Polaris（北极星）引擎实例。
选择用户或者用户组，单击查看Token 。
﻿
3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏实例列表 ，单击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。
﻿
配置管理
1. Nacos 配置信息和Polaris（北极星）配置信息映射关系
Nacos 字段
Nacos 字段值
Polaris（北极星）字段
Polaris（北极星）字段值描述
namespace
默认命名空间/非默认命名空间 ID
namespace
default/命名空间名称
group
DEFAULT_GROUP
group
Polaris（北极星）配置分组名称
dataId
application.yaml
file_name
Polaris（北极星）配置文件名称
2. 修改服务端接入地址
Spring Cloud Alibaba
原生 Nacos-Client
Dubbo
1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
spring.cloud.nacos.username="可任意值"
spring.cloud.nacos.password="Polaris（北极星）用户/用户组的资源访问凭据 Token"
spring.cloud.nacos.config.namespace="Polaris（北极星）命名空间名称"
spring.cloud.nacos.config.server-addr="Polaris（北极星）服务端IP:8848"
spring.cloud.nacos.config.group="Polaris（北极星）配置分组名称"
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏权限控制 ，选择用户或者用户组，单击查看Token 。
﻿
3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏引擎管理，在实例信息页可以查看IP地址。
﻿
1. 原生Nacos Client修改：Polaris（北极星）服务端地址和服务端访问账密：
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "Polaris（北极星）服务端IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "Polaris（北极星）命名空间名称");
properties.put(PropertyKeyConst.USERNAME, "可任意值");
properties.put(PropertyKeyConst.PASSWORD, "Polaris（北极星）用户/用户组的资源访问凭据 Token");
﻿
// 注册配置客户端
ConfigService configService = new NacosConfigService(properties);
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏权限控制 ，选择目标Polaris（北极星）引擎实例。
选择用户或者用户组，单击查看Token 。
﻿
3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏实例列表 ，单击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。
﻿
﻿
1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
dubbo
  config-center
    address: nacos://Polaris（北极星）服务端IP:8848
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏权限控制 ，选择目标Polaris（北极星）引擎实例。
选择用户或者用户组，单击查看Token 。
﻿
3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏实例列表 ，单击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。
﻿
﻿

Polaris（北极星）实例版本	兼容的 Nacos SDK 开源版本	备注
2.0.2以前版本（不含开发版）	不兼容
2.0.2（不含开发版）	兼容 Nacos SDK 2.x 使用 gRPC 协议接入	2.4及以后版本部分接口不支持，详见下述接口范围
2.1.0及更新版本（不含开发版）	兼容 Nacos SDK 2.x 使用 gRPC协议、HTTP 协议接入兼容 Nacos SDK 1.x 使用 HTTP 协议接入	2.4及以后版本部分接口不支持，详见下述接口范围

Nacos客户端接口			gRPC 协议	HTTP 协议
配置中心	获取配置	✔	✔
		监听配置	✔	✔
		删除监听	✔	✔
		发布配置	✔	✔
		删除配置	✔	✔
		带监听配置的获取配置	×	-
		带CAS的发布配置	×	-
注册中心	注册实例	✔	✔
		注销实例	✔	✔
		获取全部实例	✔	✔
		获取健康或不健康实例列表	✔	✔
		获取一个健康实例	✔	✔
		监听服务	✔	✔
		取消监听服务	✔	✔
		批量注册服务实例	×	-
		批量注销服务实例	×	-
		带选择器的监听服务	×	-
		取消带选择器的监听服务	×	-
		分页获取服务列表	×	-
		获取当前客户端所监听的服务列表	×	-

功能点	差异	备注
鉴权能力	默认写鉴权，读不鉴权
注册能力	Polaris（北极星）注册都会写入数据库
服务模型	Polaris（北极星）没有group概念	Polaris（北极星）服务名称由 Nacos group 字段值和 Nacos service 字段值拼接而成。
控制台	Nacos和Polaris（北极星）控制台存在差异。

Nacos 字段	Nacos 字段值	Polaris（北极星）字段	Polaris（北极星）字段值描述
namespace	默认命名空间/非默认命名空间 ID	namespace	default/命名空间名称。
group	DEFAULT_GROUP	service	Polaris（北极星）服务名称由 Nacos group 字段值和 Nacos service 字段值拼接而成。${group}__${service} 为最终的Polaris（北极星）服务名, 如果 group == DEFAULT_GROUP，则服务名为 ${service}。
service	DEFAULT_GROUP	service
cluster	DEFAULT	instance.metadata	作为实例标签的一部分, 实例标签 key 为 internal-nacos-cluster。

兼容 Nacos SDK 接入

本页目录：

使用场景

使用限制

使用说明

服务注册

配置管理