腾讯云微服务引擎 TSE C++ 应用开发 - L5Agent 接入
文档简介：
操作场景：
本文针对使用 L5 用户接入微服务引擎托管的 PolarisMesh 治理中心。
咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！
微信咨询
免费试用、价格特惠
操作场景
本文针对使用 L5 用户接入微服务引擎托管的 PolarisMesh 治理中心。
L5agent 使用北极星
L5 的 SID 在北极星中如何创建
由于 l5api 仅支持访问 L5 SID，因此访问非 L5 SID 格式的服务名，需要创建 CL5 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 治理中心。
操作步骤
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 的服务别名
