操作场景
您需要将服务添加到云原生 API 网关中,以便网关能查找对应的服务地址从而实现动态代理。云原生 API 网关支持添加 K8S 服务、注册中心、IP 列表、域名/IP、私有域名、云函数几种类型的服务。本文介绍如何为云原生网关添加服务。
操作步骤
添加服务
1. 登录 微服务引擎控制台。
2. 在左侧导航栏单击服务路由,在页面上方选择好实例后,单击服务页签,在服务列表单击新建。
3. 在新建服务窗口中配置相关参数。
参数 | 是否必填 | 说明 |
服务名称 | 是 | 输入服务名称。 |
服务类型 | 是 | 服务类型,支持 注册中心,其余服务类型不支持新接入。 |
注意:
目前云原生 API 网关仅对微服务场景(即后端为注册中心的服务)支持开通白名单新购,其余场景不支持新接入。
当服务来源为 K8S 服务时,填写以下参数:
参数 | 是否必填 | 说明 |
服务来源 | 是 | 选择已创建的容器服务来源。 |
命名空间 | 是 | 输入命名空间名称。 |
服务列表 | 是 | 填写需要访问的容器服务列表,多个服务使用换行分隔。 |
服务协议 | 是 | 网关请求后端服务使用的协议,支持 HTTP/WS、HTTPS/WSS、TCP、UDP。 |
服务路径 | 是 | 后端服务的请求路径。 |
服务端口 | 否 | 后端服务的端口,支持1~65535的任意端口。 |
超时时间 | 是 | 连接建立、写入和读取后端返回的最大超时时间 |
重试次数 | 是 | 与后端服务建立连接的最大重试次数。 |
当服务来源为注册中心时,填写以下参数:
参数 | 是否必填 | 说明 |
服务来源 | 是 | 选择已创建的服务来源。 |
命名空间 | 是 | 当来源产品为 Nacos/PolarisMesh 时,输入命名空间 ID。注意:Nacos 默认命名空间请填写 empty_ns。当来源产品为 TSF 注册中心时,下拉选择命名空间。 |
服务列表 | 是 | 当来源产品为 Nacos/PolarisMesh/Consul 时填写需要访问的服务列表,多个服务使用换行分隔。针对不同注册中心,服务列表书写方式为: Nacos:{Nacos分组}__{服务名称}注意:Nacos 分组与服务名称之间使用两个下划线(_)分割 Consul:{服务名称} Polaris Mesh:{服务名称} 当来源产品为 TSF 注册中心时,下拉选择单个微服务名称。 |
服务协议 | 是 | 网关请求后端服务使用的协议,支持 HTTP/WS、HTTPS/WSS、TCP、UDP。 |
服务路径 | 是 | 后端服务的请求路径。 |
超时时间 | 是 | 连接建立、写入和读取后端返回的最大超时时间。 |
重试次数 | 是 | 与后端服务建立连接的最大重试次数。 |
当服务类型为 IP 列表时,需要填写以下参数:
参数 | 是否必填 | 说明 |
地址列表 | 是 | 填写后端服务节点的 IP、端口、权重信息。 |
CVM 弹性伸缩 | 否 | 开启后,Kong 将自动关联所选伸缩组对应的 CVM 实例。 伸缩组:勾选同 VPC 网络下的弹性伸缩组。关联后,Kong 将在弹性伸缩组创建生命周期挂钩,以及在云服务器-我的命令创建弹性伸缩命令,对上述资源的修改和删除将导致伸缩失效。 伸缩组端口:填写伸缩组端口。 |
服务协议 | 是 | 网关请求后端服务使用的协议,支持 HTTP/WS、HTTPS/WSS、TCP、UDP。 |
服务路径 | 是 | 后端服务的请求路径。 |
超时时间 | 是 | 连接建立、写入和读取后端返回的最大超时时间。 |
重试次数 | 是 | 与后端服务建立连接的最大重试次数。 |
当服务类型为域名/IP 时,需要填写以下参数:
参数 | 是否必填 | 说明 |
服务地址 | 是 | 支持填写 IP 或域名,例如:10.0.0.1或 www.tencent.com。 |
服务端口 | 是 | 后端服务的端口,支持1~65535的任意端口。 |
服务协议 | 是 | 网关请求后端服务使用的协议,支持 HTTP/WS、HTTPS/WSS、TCP、UDP。 |
服务路径 | 是 | 后端服务的请求路径。 |
超时时间 | 是 | 连接建立、写入和读取后端返回的最大超时时间。 |
重试次数 | 是 | 与后端服务建立连接的最大重试次数。 |
当服务类型为云函数时,需要填写以下参数:
参数 | 是否必填 | 说明 |
函数类型 | 是 | 事件函数或者 Web 函数。 |
命名空间 | 是 | 选择函数所在的命名空间。 |
函数 | 是 | 选择函数。 |
版本/别名 | 是 | 选择函数所在的服务版本或者别名。 |
CAM 鉴权 | 是 | 默认开启,网关转发请求到云函数进行 CAM 鉴权。 |
超时时间 | 是 | 连接建立、写入和读取后端返回的最大超时时间。 |
重试次数 | 是 | 与后端服务建立连接的最大重试次数。 |
当服务来源为 私有域名时,填写以下参数:
参数 | 是否必填 | 说明 |
服务来源 | 是 | 选择已创建的腾讯云私有解析来源。 |
私有域名 | 是 | 填写服务的私有域名。 |
服务端口 | 是 | 填写需要访问的容器服务列表,多个服务使用换行分隔。 |
服务协议 | 是 | 网关请求后端服务使用的协议,支持 HTTP/WS、HTTPS/WSS、TCP、UDP。 |
服务路径 | 是 | 后端服务的请求路径。 |
超时时间 | 是 | 连接建立、写入和读取后端返回的最大超时时间。 |
重试次数 | 是 | 与后端服务建立连接的最大重试次数。 |
说明:
1. 网关仅对 SRV记录、A记录、CNAME 记录类型进行解析。
2. 如果 SRV 记录已填写端口,控制台输入端口会覆盖 SRV 记录的端口内容。
4. (可选)配置高级参数。
负载均衡算法:支持选择轮询和最小连接数。
慢启动:开启后,服务对应的节点将在慢启动时间内,将权重从1逐步增加到目标值。若引擎版本较低,可能不支持使用此功能,建议前往实例基本信息页面升级引擎版本。
说明:
支持在容器服务集群中修改 YAML 配置慢启动,增加 annotation:
annotations:tse.konghq.com/TSE-Upstream-SlowStart: "30"
5. 添加后,查看服务列表,可以看到添加的服务,单击服务名称,可以查看详细的服务信息。

编辑服务
单击操作 > 编辑,修改服务信息,确认后即可。
删除服务
单击操作 > 删除,确认是否删除服务。确认后将删除服务。