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

前提条件

  • 您需要加入一个集群并在集群中具有应用负载管理权限。有关更多信息，请参阅集群成员和集群角色。

  • 如需创建支持 HTTPS 协议的应用路由，您需要创建 TLS 信息类型的保密字典，保密字典中必须包含 Base64 编码的证书和私钥。有关更多信息，请参阅创建保密字典。

  • 应用路由所属的项目中存在至少一个服务。有关更多信息，请参阅创建服务。

操作步骤

  1. 以具有应用负载管理权限的用户登录 KubeSphere 企业版 Web 控制台并进入您的集群。

  2. 在左侧导航栏选择应用负载 > 应用路由。

  3. 在页面点击创建。

  4. 在基本信息页签，设置应用路由的基本信息，然后点击下一步。

    参数描述

    名称

    应用路由的名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 253 个字符。

    别名

    应用路由的别名。不同应用路由的别名可以相同。别名只能包含中文、字母、数字和连字符（-），不得以连字符（-）开头或结尾，最长 63 个字符。

    描述

    应用路由的描述。描述可包含任意字符，最长 256 个字符。

  5. 在路由规则页签，点击添加路由规则，设置路由规则参数，然后点击下一步。

    • 点击添加路由规则可设置路由规则。您可以设置多条路由规则，每条规则对应一个域名。

    • 将光标悬停在已创建的路由规则上，然后在右侧点击pen可编辑路由规则的设置。

    • 将光标悬停在已创建的路由规则上，然后在右侧点击trash-light可删除路由规则。

    参数描述

    域名

    用户自定义的域名。

    协议

    应用路由支持的协议，参数值可以为 HTTP 或 HTTPS。

    保密字典

    应用路由协议为 HTTPS 时，用于提供证书和密钥的保密字典。该保密字典必须包含 tls.cert 和 tls.key 字段，分别存储 Base64 编码的证书和私钥。

    路径

    域名路径及其与服务端口的映射关系。

    • 点击添加可设置多条路径。

    • 在已创建的路径右侧点击trash-light可删除路径。

  6. 在高级设置页签，为应用路由设置标签和注解，然后点击创建。

    • 点击添加可设置多条标签或注解。

    • 在已创建的标签或注解右侧点击trash-light可删除标签或注解。

    说明

    KubeSphere 企业版的集群网关和项目网关底层基于 Nginx Ingress Controller 实现。您可以在应用路由上设置注解控制网关的行为。有关更多信息，请参阅 Nginx Ingress Controller 官方文档。

    说明

    安装“KubeSphere 网关”扩展组件，并启用集群网关、企业空间网关、或项目网关后，创建应用路由时，需要在高级设置页签选择对应网关的 IngressClassName。

    应用路由创建完成后将显示在应用路由列表中。