API 网关支持对接容器服务集群,为容器集群内的应用提供高可用的网关功能。本文以部署在 VKE 集群中的 Nginx 应用为例,介绍如何通过 API 网关发布部署在 VKE 集群中的应用。
背景信息 API 网关(API Gateway,APIG)为 容器服务 集群提供托管的云原生网关功能,实现高可用、高扩展的 Ingress 流量管理方式。允许将集群中的 Service 资源添加为 API 网关的后端 Upstream,并支持配置路由权重。满足在云原生应用场景下业务发布、灰度发布等场景和需求。同时,API 网关支持对接 托管 Prometheus ,实现实例级别、服务级别的观测和告警。
前提条件 已创建集群,详情请参见 创建集群 。 已在集群中部署应用和服务,详情请参见 通过控制台使用容器服务 。 已创建托管 Prometheus 工作区,详情请参见 创建工作区 。 已在域名注册商处获取待绑定的域名,并在工信部完成 ICP 备案或接入备案。详情请参见 备案流程 。 操作步骤 步骤一:创建实例 登录 API 网关控制台 。
在顶部导航栏,选择目标地域。
在左侧导航栏选择 实例管理 ,在实例管理页面,单击 创建实例 。
在创建实例页面,按要求配置实例信息。
基本信息 :选择 标准网关 类型,并配置网关实例的名称,本例中为 apig-demo。
规格配置 :配置网关实例的规格、私有网络等信息。其中,私有网络必须与 VKE 集群的保持一致。
可观测性 :开启监控告警,并选择托管 Prometheus 工作区。
其他配置保持缺省,阅读《API 网关服务条款》并勾选同意。
单击 确认订单 ,开始创建网关实例。
步骤二:创建服务 在左侧导航栏选择 路由管理 > 服务列表(域名) 。单击 创建服务 。 在创建服务对话框,配置服务名称和所属实例。 单击 确定 ,完成服务配置。 步骤三:绑定自定义域名 在服务列表中单击目标服务名称,进入服务概览页面。
选择 域名管理 页签,单击 绑定域名 ,在服务中配置自定义域名和协议。
说明
公网域名需要在工信部完成 ICP 备案或接入备案,本文中的域名仅为示例。 您需要自主保证自定义域名和 API 网关 IP 地址的 DNS 解析关系,以保证能够通过域名正常访问到 API 网关实例。 单击 确定 ,完成域名绑定。
步骤四:导入集群 在左侧导航栏选择 后端管理 > 容器集群导入 。 在集群列表页面,单击 导入集群 。 在导入集群页面,勾选需要导入的 VKE 集群。 单击 确定 ,完成集群导入。 注意
当导入集群为 VPC-CNI 网络模型时,无需额外配置,API 网关即可访问到集群中的 Service 资源。 当导入集群为 Flannel 网络模型时,导入集群后,还需要为待对接 Flannel 集群下的所有节点开放 APIG 安全组。详情请参见 创建容器服务类型 Upstream 。 步骤五:创建 Upstream 在左侧导航栏选择 后端管理 > Upstream 列表 。 在 Upstream 列表页面,单击 创建 Upstream 。 在创建 Upstream 页面,按要求填写参数信息。
基本信息 :配置 Upstream 的名称和所属实例。后端配置 :后端服务选择 容器服务 ,并选择 VKE 集群中应用部署的命名空间、服务和端口号。 单击 确定 ,完成创建容器服务类型 Upstream。 步骤六:创建路由 说明
系统支持为指定服务配置单条路由,也支持为多个服务批量创建路由。本文以指定服务配置单条路由为例。 为多个服务批量创建路由的操作方法,请参见 创建路由 。 在左侧导航栏选择 路由管理 > 服务列表(域名) 。 在服务列表页面,单击目标服务名称,进入当前服务概览页面。 单击 创建路由 ,配置路由信息。
基本信息 :配置路由的名称、请求方法 Method 和 路径 Path。Upstream 流量分发 :在 后端类型 下拉菜单中选择 容器服务 ,并选择已配置好的 Upstream。配置权重为 100,表示将 100% 的流量都转发到该后端。 单击 确定 ,创建完成路由。 结果验证 访问应用 在本地环境中,使用如下命令访问应用。
curl http://apig-example.com
预期访问结果如下。表示可以通过自定义域名访问到部署在 VKE 集群中的应用。
查看监控信息 在左侧导航栏选择 实例管理 ,单击目标实例名称,进入实例概览页面。 单击 监控信息 ,切换至 监控信息 页签。 设置查询时间范围,查看当前实例的各项监控指标。最多支持查看近 30 天的监控数据。