概述
云原生API网关支持将请求转发的预定义的目标服务,本章节介绍如何创建云原生API网关中的服务。
云原生API网关中服务相关概念
| 概念 | 说明 |
|---|---|
| 服务 | 网关转发请求的目标,可以通过配置路由引用相应的服务,将请求转发到指定的目标 |
| 容器服务 | 从云容器引擎中发现的服务 |
| 注册中心服务 | 从注册配置中心发现的服务 |
| 固定地址服务 | 固定配置的IP+端口服务,支持添加多个服务地址 |
| LLM服务 | 大模型供应商服务,提供AI模型能力 |
| Dubbo服务 | 添加服务时,服务请求协议选择DUBBO |
| 权重 |
|
| 优先级 |
|
| 请求协议 | 请求后端服务的协议,当前支持HTTP、HTTPS、GRPC、GRPCS、DUBBO,默认为HTTP |
| 服务版本 | 云原生API网关支持基于容器和注册中心服务中的元数据(容器服务中的POD标签或者注册中心服务的元数据)对服务进行分组,并定义为不同版本,即为服务版本概念 |
创建服务
云原生API网关支持创建容器服务、注册中心服务和固定地址服务,本章节介绍每种服务创建操作流程。
创建容器服务
前置条件
已开通云原生API网关实例和同VPC下的云容器引擎实例,已添加云容器引擎作为云原生API网关的服务来源
服务已部署到云容器引擎并配置相关Service暴露服务
操作流程
进入云原生API网关控制台。
在顶部菜单栏选择资源池。
单击左侧导航栏实例 > 进入实例概览。
单击左侧导航栏服务 > 服务标签页。
单击左上角按钮 创建服务。
在弹出的页面中选择容器服务来源,选择要添加的服务所在的命名空间。
在服务列表中选择要添加的服务,根据需求做不同的配置。
容器服务配置说明
| 配置 | 说明 |
|---|---|
| 命名空间 | 后端服务部署在云容器引擎中的命名空间 |
| servicePort | 对应云容器引擎Service中定义的服务端口,每个端口可以定义为一个独立的云原生API网关服务 |
| 请求协议 | 后端服务的协议,支持HTTP、HTTPS、GRPC、GRPCS、DUBBO,默认为HTTP |
| mTLS | 是否打开后端服务双向TLS认证(后端服务对网关证书认证) |
| 证书文件 | 后端服务开启双向TLS认证后,云原生API网关提供的证书文件 |
| 私钥文件 | 后端服务开启双向TLS认证后,云原生API网关提供的私钥文件 |
创建注册中心服务
前置条件
已开通云原生API网关实例和同VPC下的注册配置中心实例(Nacos引擎),已添加注册配置中心实例作为云原生API网关的服务来源
后端服务已部署并注册到注册配置中心
操作流程
进入云原生API网关控制台。
在顶部菜单栏选择资源池。
单击左侧导航栏实例 > 进入实例概览。
单击左侧导航栏服务 > 服务标签页。
单击左上角按钮 创建服务。
在弹出的页面中选择容器服务来源,选择要添加的服务所在的命名空间。
在服务列表中选择要添加的服务,根据需求做不同的配置。
注册中心服务配置说明
| 配置 | 说明 |
|---|---|
| 命名空间 | 后端服务注册到注册配置中心的命名空间 |
| 请求协议 | 后端服务的协议,支持HTTP、HTTPS、GRPC、GRPCS、DUBBO,默认为HTTP |
| mTLS | 是否打开后端服务双向TLS认证(后端服务对网关证书认证) |
| 证书文件 | 后端服务开启双向TLS认证后,云原生API网关提供的证书文件 |
| 私钥文件 | 后端服务开启双向TLS认证后,云原生API网关提供的私钥文件 |
创建固定地址服务
前置条件
已开通云原生API网关实例
操作流程
进入云原生API网关控制台。
在顶部菜单栏选择资源池。
单击左侧导航栏实例 > 进入实例概览。
单击左侧导航栏服务 > 服务标签页。
单击左上角按钮 创建服务。
在弹出的页面中选择固定地址服务。
根据需求做不同的配置。
固定地址服务的配置参数
| 配置 | 说明 |
|---|---|
| 服务名称 | 用于唯一标识一个后端服务 |
| 服务地址 | 1. 支持配置服务节点的地址、端口、权重和优先级。 2. 优先访问高优先级节点,只有在高优先级的节点不可用或者尝试过,才会访问一个低优先级的节点; 3. 只有在优先级相同时,权重才会生效; 4. 优先级默认值为0,可以取负数表示备份节点,表示只有其他节点均不可用时,才会启用备份节点; 5. 此处节点权重采用比例形式,表示不同节点之间的流量比例 |
| 请求协议 | 后端服务的协议,支持HTTP、HTTPS、GRPC、GRPCS、DUBBO,默认为HTTP |
| mTLS | 是否打开后端服务双向TLS认证(后端服务对网关证书认证) |
| 证书文件 | 后端服务开启双向TLS认证后,云原生API网关提供的证书文件 |
| 私钥文件 | 后端服务开启双向TLS认证后,云原生API网关提供的私钥文件 |
创建DNS域名服务
前置条件
已开通云原生API网关实例
操作流程
进入云原生API网关控制台。
在顶部菜单栏选择资源池。
单击左侧导航栏实例 > 进入实例概览。
单击左侧导航栏服务 > 服务标签页。
单击左上角按钮 创建服务。
在弹出的页面中选择DNS域名服务。
填写域名、端口等配置。
DNS域名服务的配置参数
| 配置 | 说明 |
|---|---|
| 服务名称 | 用于唯一标识一个后端服务 |
| 服务地址 | 1. 支持配置服务节点的地址、端口、权重和优先级。 2. 优先访问高优先级节点,只有在高优先级的节点不可用或者尝试过,才会访问一个低优先级的节点; 3. 只有在优先级相同时,权重才会生效; 4. 优先级默认值为0,可以取负数表示备份节点,表示只有其他节点均不可用时,才会启用备份节点; 5. 此处节点权重采用比例形式,表示不同节点之间的流量比例 |
| 请求协议 | 后端服务的协议,支持HTTP、HTTPS、GRPC、GRPCS、DUBBO,默认为HTTP |
| mTLS | 是否打开后端服务双向TLS认证(后端服务对网关证书认证) |
| 证书文件 | 后端服务开启双向TLS认证后,云原生API网关提供的证书文件 |
| 私钥文件 | 后端服务开启双向TLS认证后,云原生API网关提供的私钥文件 |
创建LLM服务
前置条件
已开通云原生API网关实例
操作流程
进入云原生API网关控制台。
在顶部菜单栏选择资源池。
单击左侧导航栏实例 > 进入实例概览。
单击左侧导航栏服务 > 服务标签页。
单击左上角按钮 创建服务。
在弹出的页面中选择LLM服务。
填写服务名称、大模型供应商、API-KEY等配置。
LLM服务的配置参数
| 配置 | 说明 |
|---|---|
| 服务名称 | 用于唯一标识一个后端服务 |
| 大模型供应商 | 支持的大模型供应商有:DeepSeek、OpenAI兼容(OpenAI Compatible)、百炼、息壤、火山方舟、千帆等 需特别说明,本AI服务所集成的大模型能力并非由云原生API网关直接提供。您在接入使用前,需自行确认该服务是否匹配您的业务需求并评估其可靠性,同时应确保严格遵循国家法律法规及平台产品协议的相关约定。若因未合规使用引发任何纠纷或不良后果,我方不承担相应责任。 |
| 服务地址(base_url) | 选定大模型供应商后会自动载入标准接口,其中OpenAI兼容的供应商需要自行填写服务地址 |
| API-KEY | 该API-KEY用于在云原生API网关和大模型服务之间进行身份认证。API-KEY的获取请咨询对应服务供应商。 |