本节介绍如何创建 Gateway API 应用路由。

前提条件

您需要加入一个项目并在项目中具有 Gateway API 应用路由的管理权限。

操作步骤

  1. 以具有 Gateway API 应用路由管理权限的用户登录 KubeSphere Web 控制台并进入您的企业空间。

  2. 在左侧导航栏选择 服务与网格 > Gateway API 应用路由。

  3. 根据您需要创建的路由类型，在相应的页签下点击 创建。

    类型 描述

    HTTPRoute

    用于将 HTTP/HTTPS 流量路由到后端服务，支持基于路径、主机名、请求头等条件进行流量分发。

    GRPCRoute

    用于将 gRPC 流量路由到后端服务，支持基于 gRPC 方法、服务名等条件进行流量分发。

    TLSRoute

    用于将 TLS 加密流量（基于 SNI）路由到后端服务，支持基于服务器名称指示进行路由决策。

    TCPRoute

    用于将原始 TCP 流量路由到后端服务，支持基于端口等条件进行简单的四层流量转发。

  4. 在对话框的 基本信息 页签，设置基本信息，然后点击 下一步。

    参数 描述

    名称

    路由名称。

    别名

    路由别名。

    描述

    路由的描述信息。

    网关

    选择使用的网关。

  5. 在 路由规则 页签，执行以下操作：

    • 设置域名。TCPRoute 不支持该配置项。

    • 添加路由规则。不同类型的路由，其规则有所不同，具体请参阅 参数描述。

  6. 在 高级设置 页签，可以为应用路由添加标签、注解等元数据信息。

参数描述

HTTPRoute 的路由规则

HTTPRoute 的一个路由规则支持添加一组匹配条件和一组后端服务。符合匹配条件的流量将被路由到该组后端服务。多个服务支持设置权重，实现流量分配。

一个匹配条件支持的配置项如下：

  • 路径匹配类型：支持精确匹配、前缀匹配和正则匹配。

  • 路径：匹配路径值，根据匹配类型自定义配置。

  • 请求类型：HTTP Method。

  • Header 匹配：按 Header 名和 Header 值进行精确匹配或正则匹配，支持设置多个。

  • Query 查询参数匹配：按参数名和参数值进行精确匹配或正则匹配，支持设置多个。

一个后端服务支持的配置项如下：

  • 服务名称

  • 服务端口

  • 权重

GRPCRoute 的路由规则

GRPCRoute 的一个路由规则支持添加一组匹配条件和一组后端服务。符合匹配条件的流量将被路由到该组后端服务。多个服务支持设置权重，实现流量分配。

一个匹配条件支持的配置项如下：

  • 类型：GRPC 方法的匹配类型，支持精确匹配和正则匹配。

  • 服务：匹配 GRPC 服务名，根据匹配类型自定义配置。

  • Method：匹配 GRPC 方法名，根据匹配类型自定义配置。

  • Header 匹配：按 Header 名和 Header 值进行精确匹配或正则匹配，支持设置多个。

一个后端服务支持的配置项如下：

  • 服务名称

  • 服务端口

  • 权重

TLSRoute 的路由规则

TLSRoute 的一个路由规则支持配置一组后端服务。

一个后端服务支持的配置项如下：

  • 服务名称

  • 服务端口

  • 权重

TCPRoute 的路由规则

TCPRoute 的一个路由规则支持配置一组后端服务。

一个后端服务支持的配置项如下：

  • 服务名称

  • 服务端口

  • 权重