当您需要从外部系统或客户端访问部署在SAE中的服务时,可以通过在云原生API网关中创建HTTP API,从而实现访问SAE里应用提供的服务,提升了服务的可访问性和外部集成能力。本文介绍如何通过配置HTTP API来访问SAE应用中的服务。
前提条件
-
已完成云原生API网关创建,具体操作,请参见创建网关实例。
-
已完成SAE应用创建,且应用的VPC和网关的VPC一致, 具体操作,请参见在SAE控制台使用JAR文件部署微服务应用。
-
应用配置基于K8s ServiceName配置应用服务访问,具体操作,请参见基于K8s ServiceName配置应用服务访问。
方案概览
-
创建HTTP API:配置API的基本信息。
-
创建路由:
-
配置路由规则:定义API与SAE应用K8s Service的映射关系,确保请求能够准确地被路由到正确的目标服务。
-
所属实例&后端服务:选择对应的云原生API网关实例,确保路由配置在实际部署时能够正确应用。
-
关联服务:将服务实例与路由规则关联,实现服务的动态发现与调用,提升系统的灵活性和扩展性。
-
-
路由调试:通过模拟请求和分析响应,验证云原生API网关与SAE应用K8s Service的集成是否符合预期,确保服务调用的高效性和稳定性。
操作步骤
步骤一:创建HTTP API
登录云原生API网关控制台。
在左侧导航栏,选择API,并在顶部菜单栏选择地域。
-
在API页面单击左上角创建API。
-
选择HTTP API,单击创建,在创建HTTP API页面填写API名称和描述。
步骤二:创建路由
单击目标API名称,进入API详情页,单击创建路由,在创建路由面板,配置相关参数。
1.配置路由基本信息
本示例中,路由名称填写为 springcloud-entry,路径(Path)匹配条件选择前缀是并填写 /,同时勾选大小写敏感。
基本信息参数如下:
-
路由名称:自定义路由名称,创建后路由名称不可修改。
-
域名:您可以直接单击右侧的添加域名,在添加域名面板中创建。
-
路径(Path):匹配Path参数以
/开头的HTTP请求。
2.所属实例&后端服务
-
选择所属实例对应的云原生API网关实例。
在后端服务区域分别选择服务名称、服务端口和服务协议。
-
使用场景:选择单服务。
3.创建服务
-
在后端服务配置项中的服务名称下拉选项框中,单击创建服务。
-
选择来源类型为SAE Kubernetes 服务。
创建服务基本信息参数如下:
-
命名空间:选择SAE中的命名空间。
-
服务列表:在服务列表中选择您的SAE应用注册的K8s service 服务名称。
-
-
保存并发布路由。
步骤三:路由调试
-
路由发布成功后,单击目标路由操作列的调式。
-
在调试面板中输入相关接口参数,并单击发送,在右侧即可看到服务接口的返回结果。
本示例中请求方法为 GET,目标域名为 item.dev,响应状态码为 200、响应耗时 12ms,响应体为
false。
相关文档
-
当您容器服务中的应用需要通过外部访问时,请参考通过HTTP API访问容器服务中的应用。
-
当您在使用云原生API网关过程中遇到问题时,请查看常见问题。