使用场景
如果您希望使用北极星代替 Nacos 作为新的注册中心,北极星提供了协议兼容的方式,您仅需要更改应用中的 nacos-client 的服务端接入地址即可。无需修改代码或者 pom 依赖。该能力目前开白使用,如需使用,可提工单,联系腾讯云助手协助。
前提条件
使用说明
本文通过服务注册和配置管理两个场景介绍北极星接入的使用说明。
服务注册
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. 修改服务端接入地址。
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. 修改应用配置文件:北极星服务端地址和服务端访问账密:
dubboregistryaddress: nacos://北极星服务端IP:8848?username=可任意值&password=北极星用户/用户组的资源访问凭据 Tokenparameters.namespace: 北极星命名空间名称metadata-reportaddress: 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. 修改服务端接入地址
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 控制台。
在服务治理中心下,单击侧边栏实例列表 ,单击目标北极星引擎实例。
在引擎详情页的实例信息页面,可以查看到引擎的访问地址。