使用场景
使用限制
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-ClientDubbo
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-ClientDubbo
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（北极星）引擎实例。
·在引擎详情页的实例信息页面，可以查看到引擎的访问地址。