一、操作场景
根据后端服务的接入方式,服务分为以下两种类型:
·域名/IP:后端服务通过固定域名或 IP 地址访问,网关直接连接后端服务。
·私有 DNS:后端服务通过私有域名访问,网关使用腾讯云 Private DNS 进行域名解析。
这篇档介绍如何创建和管理这两种类型的服务。
二、前置条件
·已开通腾讯云 AI 网关服务。
·已创建 AI 网关实例。
·后端服务已部署并可访问(网络连通)。
·(私有 DNS 类型) 已在腾讯云 Private DNS 中配置相应域名的解析记录。
·(私有 DNS 类型) 已创建私有 DNS 类型的服务来源。
三、适用场景
后端服务通过固定的域名或 IP 地址访问,无需使用 Private DNS 进行域名解析。适用于:
·后端服务地址固定不变。
·使用公网域名或公网 IP 访问。
·使用内网 IP 地址直接访问。
四、前置条件
·后端服务已部署并可通过域名或 IP 访问。
·已确认后端服务的完整地址(协议 + 域名/IP + 端口 + 路径)。
五、操作步骤
步骤1:进入服务管理页面
1. 登录 微服务平台控制台 ,在左侧导航栏选择 AI 网关进入实例列表。
2. 单击目标实例 ID/名称进入实例详情页,进入目标网关实例。
3. 在左侧导航栏,选择服务管理 > 服务;
4. 单击新建按钮。
步骤2:选择服务类型并填写参数
在新建服务弹窗中,填写以下参数:
| 参数名称 | 是否必选 | 说明 |
| 服务名称 | 是 | 自定义名称,最长60个字符,支持中英文、数字及 -、_ 符号,不能以数字和分隔符开头,不能以分隔符结尾 |
| 服务类型 | 是 | 选择 域名/IP |
| 服务协议 | 是 | HTTP: 标准 HTTP 协议HTTPS: 加密 HTTPS 协议 |
| 服务地址 | 是 | 输入后端服务的域名或 IP 地址(不含协议头)示例(域名):backend-server.example.com示例(IP):192.168.1.100 |
| 服务端口 | 是 | 后端服务的端口号,支持 1-65535 的任意端口 |
| 服务路径 | 是 | 后端服务的路径(如:/api/v1)如无路径,填写 / |
| 超时时间 | 是 | 网关调用后端的超时时间,默认 60000 毫秒,支持调整 |
| 重试次数 | 是 | 请求失败时的重试次数,默认 5 次,支持调整 |
步骤3:保存配置
1. 确认所有参数填写正确;
2. 单击 确定 按钮完成创建;
3. 系统自动跳转到服务列表页。
六、结果验证
·在服务列表页,查看新建的服务记录。
·服务类型列显示“域名/IP”。
·服务地址列显示完整的后端地址(协议 + 域名/IP + 端口 + 路径)。
·在创建 MCP 服务、配置路由时,可从服务下拉列表中选择该服务。
七、注意事项
·服务地址填写时不需要包含协议头(如 http:// 或 https://),协议通过“服务协议”字段单独选择。
·服务地址可以填写域名或 IP,但必须确保网关实例可以访问该地址。
·使用公网域名时,请确保网关实例具备公网访问能力。
·使用内网 IP 地址时,请确保网关实例与后端服务在同一 VPC 或已配置网络互通。
·建议使用 HTTPS 协议,确保数据传输安全。
·超时时间和重试次数可根据实际后端服务响应情况调整。
八、适用场景
后端服务通过内网私有域名访问,且域名解析由腾讯云 Private DNS 服务管理。适用于:
·企业内网服务通过私有域名访问。
·需要与腾讯云 Private DNS 集成的场景。
·后端服务地址需要动态解析的场景。
九、前置条件
·已在腾讯云 Private DNS 中配置相应域名的解析记录。
·已创建私有 DNS 类型的服务来源(参考 服务来源管理)。
·后端服务已部署并可通过私有域名访问。
十、操作步骤
步骤1:进入服务管理页面
1. 登录 微服务平台控制台 ,在左侧导航栏选择 AI 网关进入实例列表。
2. 单击目标实例 ID/名称进入实例详情页,进入目标网关实例。
3. 在左侧导航栏,选择服务管理 > 服务;
4. 单击新建按钮,
步骤2:选择服务类型并填写参数
在新建服务弹窗中,填写以下参数:
| 参数名称 | 是否必选 | 说明 |
| 服务名称 | 是 | 自定义名称,最长60个字符,支持中英文、数字及 -、_ 符号,不能以数字和分隔符开头,不能以分隔符结尾 |
| 服务类型 | 是 | 选择 私有 DNS |
| 服务来源 | 是 | 从下拉列表中选择已配置的私有 DNS 类型服务来源(单击刷新按钮可更新服务来源列表) |
| 服务协议 | 是 | HTTP: 标准 HTTP 协议HTTPS: 加密 HTTPS 协议 |
| 私有域名 | 是 | 输入后端服务的私有域名(如:backend-server.internal.example.com) |
| 服务端口 | 是 | 后端服务的端口号,支持 1-65535 的任意端口注意:如 SRV 记录已填写端口,控制台填写的端口内容会覆盖 SRV 记录的端口内容 |
| 服务路径 | 是 | 后端服务的路径(如:/api/v1)如无路径,填写 / |
| 超时时间 | 是 | 网关调用后端的超时时间,默认 60000 毫秒,支持调整 |
| 重试次数 | 是 | 请求失败时的重试次数,默认 5 次,支持调整 |
步骤3:保存配置
1. 确认所有参数填写正确;
2. 单击 确定 按钮完成创建;
3. 系统自动跳转到服务列表页。
十一、结果验证
·在服务列表页,查看新建的服务记录。
·服务类型列显示“私有 DNS”。
·服务地址列显示私有域名和完整地址。
·在创建 MCP 服务、配置路由时,可从服务下拉列表中选择该服务。
十二、注意事项
·私有域名必须在腾讯云 Private DNS 中已配置解析记录,否则服务调用将返回域名解析失败错误。
·如 SRV 记录已填写端口,控制台填写的服务端口将覆盖 SRV 记录中的端口。
·私有 DNS 服务来源必须先创建,才能在新建服务时选择。
·请确保私有域名的解析记录关联的 VPC 包含网关实例所在的 VPC。
·建议定期检查 Private DNS 的解析记录是否正确,避免服务调用失败。
十三、查看服务列表
在服务列表页,可以查看以下信息:
·ID/名称:服务的唯一标识和名称
·服务类型:域名/IP 或 私有 DNS
·服务地址:完整的后端地址(协议 + 域名/IP + 端口 + 路径)
·限流:是否配置了限流策略
·创建时间:服务的创建时间
·修改时间:服务的最后修改时间
·操作:编辑、删除等操作按钮
十四、编辑服务
1. 在服务列表页,单击目标服务的编辑按钮;
2. 在编辑弹窗中,修改服务参数(服务类型不可修改);
3. 单击确定按钮保存修改。
注意:说明:
注意:服务类型(域名/IP / 私有 DNS)一旦创建后不可修改,如需变更请重新创建服务。
十五、删除服务
1. 在服务列表页,单击目标服务的删除按钮;
2. 在确认弹窗中,单击确定按钮。