配置微服务网关¶
微服务网关提供路由转发，安全管理相关能力。可利用微服务网关，管理 Dev Portal 和 App Portal 域名下的请求转发以及对服务级的路由配置隔离管理。
微服务网关收到访问流量时，根据配置的路由规则判断是否匹配并决定后续的请求转发。
本文章介绍应用开发人员如何为应用配置微服务网关。
新建路由规则¶
配置路由规则基本信息¶
通过以下步骤为应用新建路由配置：
- 在项目列表中，点击项目名称，进入项目空间。
- 在左侧导航栏中，选择 微服务网关 > 路由。
- 点击 新建路由，并在 基本信息 一栏中，完成路由的基础配置信息：
- 应用：从已创建应用列表中，选择为目标应用创建路由。
- 环境：选择应用使用环境。
- 集群：选择部署应用的集群。
- 名称：输入路由名称，以应用名称作为固定前缀，路由名称不可重复。
- 描述：输入关于该路由的信息描述。
- 点击 下一步，填写 API 请求配置信息。
- 请求协议：选择路由规则需要匹配的请求协议。现支持 http 与 https （可多选）。
- 请求域名：选择路由规则需要匹配的请求 Host。现支持 Dev Portal、App Portal、ECP 与 DOCS。
- 请求路径：填写路由规则需要匹配的 API 请求路径。
- 剥离请求路径：开启表示转发到后端时，去除符合请求路径的前缀，如请求路径为
/app/demo，当请求/app/demo/param时将变更为/param路由到后端服务，默认关闭。
- 点击 下一步，填写后端服务配置信息。
- 服务来源：选择路由规则指向的目标服务来源，默认将 Kubernetes Service 作为目标服务，则继续选择应用对应的 Service 资源。也可将外部服务作为目标服务来源，则需输入完整服务地址。
- 服务协议：服务来源为 Kubernetes Service 时，Service 提供的服务协议。
- 服务：应用所属的 Service 资源。若应用未配置 Service 则需先创建。
- 服务端口：应用所属的 Service 资源中配置的可访问的端口。
- 服务请求路径：请求后端服务的路径。
- 高级设置
- 连接超时：请求后端服务时，建立连接的最长等待时间。
- 读取超时：请求后端服务时，读取数据的最长等待时间。
- 写入超时：请求后端服务时，写入数据的最长等待时间。
- 重试次数：请求超时后的自动重试的次数。
- 点击 完成，完成新路由创建。
批量操作路由规则¶
当应用发布到新环境，应用相关的路由规则可通过批量操作的导出 / 导入功能创建。
导出路由规则¶
- 在项目列表中，点击项目名称，进入项目空间。
- 在左侧导航栏中，选择 微服务网关 > 路由。
- 点击 批量操作 > 导出，选择需要导出的应用和环境、集群。
- 点击 确定 下载文件。导出文件格式为 yaml ，包含应用下所有路由的 Kubernetes 资源。
导入路由规则¶
- 在项目列表中，点击项目名称，进入项目空间。
- 在左侧导航栏中，选择 微服务网关 > 路由。
- 点击 批量操作 > 导入，选择需要导入的环境、集群，并上传 yaml 格式文件。
- 点击 确定，完成导入后显示导入结果。如导入文件中的某个路由已存在，将会覆盖更新。
配置路由规则¶
可在路由详情页中，为路由规则鉴权、流量控制与请求日志。
鉴权¶
目前支持 Cloud IAM 与 ECP IAM 鉴权：配置此鉴权方式后，当网关接收到符合路由规则的请求时，将拦截请求并向 Cloud IAM 或 ECP IAM 发起身份验证，判断请求中携带的用户身份是否有效。若身份验证不通过则网关直接返回，不再向后端服务继续请求。
注解
对一些符合路由规则的具体请求路径可设置免鉴权。
流量控制¶
可设置路由请求数最大值，超过请求频率则拒绝请求。目前支持每秒请求次数设置。
请求日志¶
支持根据请求方法开发记录请求日志，对不需要进行记录的请求路径可额外配置免记录路径名单。
开启请求后可根据请求时间，请求用户名称和请求路径关键字进行查询。
注解
请求路径关键字：日志存储组件将对路径进行分词索引，如路径为 /demo/index-app 时，可尝试输入 demo、index、app 检索。
关闭请求日志的配置后不可再进行日志查询。