有奖:语音产品征文挑战赛火热进行中> HOT

使用场景

如果您希望使用北极星代替 Nacos 作为新的注册中心,北极星提供了协议兼容的方式,您仅需要更改应用中的 nacos-client 的服务端接入地址即可。无需修改代码或者 pom 依赖。该能力目前开白使用,如需使用,可提工单,联系腾讯云助手协助。

前提条件

已创建 PolarisMesh 北极星网格,请参见 创建 PolarisMesh 治理中心

使用说明

本文通过服务注册和配置管理两个场景介绍北极星接入的使用说明。

服务注册

1. Nacos 服务名和北极星服务名映射关系
Nacos 字段
Nacos 字段值
北极星字段
北极星字段值描述
namespace
默认命名空间/非默认命名空间 ID
namespace
default/命名空间名称。
group
DEFAULT_GROUP
service
北极星服务名称由 nacos group 字段值和 nacos service 字段值拼接而成。${group}__${service} 为最终的北极星服务名, 如果 group == DEFAULT_GROUP,则服务名为 ${service}。
service
DEFAULT_GROUP
service
cluster
DEFAULT
instance.metadata
作为实例标签的一部分, 实例标签 key 为 internal-nacos-cluster。
2. 修改服务端接入地址。
Spring Cloud Alibaba
原生 Nacos-Client
Dubbo
1. 修改应用配置文件:北极星服务端地址和服务端访问账密:
spring.cloud.nacos.username="可任意值,如:username"
spring.cloud.nacos.password="北极星用户/用户组的资源访问凭据 Token"
spring.cloud.nacos.discovery.server-addr="北极星服务端 IP:8848"
spring.cloud.nacos.discovery.namespace="北极星命名空间名称"
2. 北极星用户/用户组的资源访问凭据 Token 查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏权限控制 ,选择目标北极星引擎实例。
选择用户或者用户组,单击查看Token

3. 北极星服务端 IP 地址查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏实例列表 ,单击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。


1. 原生Nacos Client修改:北极星服务端地址和服务端访问账密:
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "北极星服务端IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "北极星命名空间名称");
properties.put(PropertyKeyConst.USERNAME, "可任意值");
properties.put(PropertyKeyConst.PASSWORD, "北极星用户/用户组的资源访问凭据 Token");

// 创建注册发现客户端
NamingService namingService = NacosFactory.createNamingService(properties);
2. 北极星用户/用户组的资源访问凭据 Token 查看方式:
登录 TSE 控制台
服务治理中心 下,点击侧边栏 权限控制 ,选择目标北极星引擎实例。
选择 用户 或者 用户组,点击 查看Token

3. 北极星服务端 IP 地址查看方式:
登录 TSE 控制台
服务治理中心 下,点击侧边栏 实例列表 ,点击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。

1. 修改应用配置文件:北极星服务端地址和服务端访问账密:
dubbo
registry
address: nacos://北极星服务端IP:8848?username=可任意值&password=北极星用户/用户组的资源访问凭据 Token
parameters.namespace: 北极星命名空间名称
metadata-report
address: nacos://北极星服务端IP:8848
2. 北极星用户/用户组的资源访问凭据 Token 查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏权限控制 ,选择目标北极星引擎实例。
选择用户或者用户组,单击查看Token

3. 北极星服务端 IP 地址查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏实例列表 ,单击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。


配置管理

1. Nacos 配置信息和北极星配置信息映射关系
Nacos 字段
Nacos 字段值
北极星字段
北极星字段值描述
namespace
默认命名空间/非默认命名空间 ID
namespace
default/命名空间名称
group
DEFAULT_GROUP
group
北极星配置分组名称
dataId
application.yaml
file_name
北极星配置文件名称
2. 修改服务端接入地址
Spring Cloud Alibaba
原生 Nacos-Client
Dubbo
1. 修改应用配置文件:北极星服务端地址和服务端访问账密:
spring.cloud.nacos.username="可任意值"
spring.cloud.nacos.password="北极星用户/用户组的资源访问凭据 Token"
spring.cloud.nacos.config.namespace="北极星命名空间名称"
spring.cloud.nacos.config.server-addr="北极星服务端IP:8848"
spring.cloud.nacos.config.group="北极星配置分组名称"
2. 北极星用户/用户组的资源访问凭据 Token 查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏权限控制 ,选择目标北极星引擎实例。
选择用户或者用户组,单击查看Token

3. 北极星服务端 IP 地址查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏实例列表 ,单击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。

1. 原生Nacos Client修改:北极星服务端地址和服务端访问账密:
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "北极星服务端IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "北极星命名空间名称");
properties.put(PropertyKeyConst.USERNAME, "可任意值");
properties.put(PropertyKeyConst.PASSWORD, "北极星用户/用户组的资源访问凭据 Token");

// 注册配置客户端
ConfigService configService = new NacosConfigService(properties);
2. 北极星用户/用户组的资源访问凭据 Token 查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏权限控制 ,选择目标北极星引擎实例。
选择用户或者用户组,单击查看Token

3. 北极星服务端 IP 地址查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏实例列表 ,单击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。


1. 修改应用配置文件:北极星服务端地址和服务端访问账密:
dubbo
config-center
address: nacos://北极星服务端IP:8848
2. 北极星用户/用户组的资源访问凭据 Token 查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏权限控制 ,选择目标北极星引擎实例。
选择用户或者用户组,单击查看Token

3. 北极星服务端 IP 地址查看方式:
登录 TSE 控制台
服务治理中心下,单击侧边栏实例列表 ,单击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。