有奖捉虫:云通信与企业服务文档专题,速来> HOT

操作场景

本文针对腾讯内部自研上云用户接入微服务引擎托管的 PolarisMesh 治理中心。

L5agent 使用北极星

L5 的SID在北极星中如何创建

由于 l5api 仅支持访问 L5 SID,因此访问非 L5 SID 格式的服务名,需要创建 CL5 SID 格式的服务别名指向该服务,这里请直接从内部北极星将服务对应的L5别名SID信息直接复制,然后在公有云北极星中创建响应的服务别名。
复制 SID 信息。


如果对应的环境类型(即命名空间)在公有云北极星引擎中不存在,则先进行手动创建。


在公有云北极星引擎实例中创建L5格式的服务别名。




SID 和命名空间的对应关系

L5 SDI 的格式:ModID:CmdID
注意
强烈建议用户命名空间选择 default 或者 Production,ModID 取值范围为: [2, 192000000]
如果用户确实有需要使用其他命名空间,请按照以下方式进行其他命名空间的换算: ModID 数值右移6位,如果结果 >= 3000001,则需要计算 ModID & 63 的结果值,根据结果值对应的命名空间信息如下,否则会出现L5寻址失败的问题:
{
1: "Production",
2: "Development",
3: "Pre-release",
4: "Test",
5: "Polaris",
6: "default",
}

微服务引擎操作场景

本文主要面向腾讯内部自研上云用户如何迁移至微服务引擎托管的 PolarisMesh 治理中心。

前提条件

已创建 PolarisMesh 服务治理中心,请参见 创建 PolarisMesh 治理中心

操作步骤

1. 登录 TSE 控制台
2. 治理中心下的 polarismesh 页面,单击页面左上方下拉列表,选择目标地域。
3. 单击目标引擎的“ID”,进入基本信息页面。

引擎实例未开启客户端公网访问

L5Agent 接入

1. 查看引擎的接入地址,在实例的基本信息页面中,记住访问地址中的每个 VPC 内网 IP 地址以及访问端口



2. 修改 L5Agent 的配置文件 l5_config.ini
[L5CONFIG]
ServerIp={对应 vpc 的内网接入地址}
ServerPort=7779
3. 重启 L5agent,启动前要把 /data/L5Backup/l5server_list.backup 删掉

引擎实例开启客户端公网访问

L5Agent 接入

1. 查看引擎的接入地址,在实例的基本信息页面中,记住访问地址中的公网 IP 地址以及访问端口



2. 修改 L5Agent 的配置文件 l5_config.ini
[L5CONFIG]
ServerIp={对应公网接入地址}
ServerPort=7779
3. 重启 L5agent,启动前要把 /data/L5Backup/l5server_list.backup 删掉

常见问题排查

使用 ./L5GetRoute1 查询失败

现象
./L5GetRoute1 xxx xxx 10 ApiGetRoute failed, ret: -9998, usec=181283,avg_usec=181283,err: FILE[static_route.cpp] LINE[153][GetRoute],NOT FOUND,invalid mod[xxx] cmd[xxx]
排除方向
检查 l5config.ini 中对于 ServerIp 的信息是否填写正确
确保对应的服务下有健康的服务实例
L5 的 SID 所对应的命名空间是否正确
是否已经在北极星中创建了格式为 SID 的服务别名