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

前提条件

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

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

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

操作步骤

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

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

  3. 在页面点击创建

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

    参数 描述

    名称

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

    别名

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

    描述

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

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

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

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

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

    参数 描述

    域名

    用户自定义的域名。

    协议

    应用路由支持的协议,参数值可以为 HTTPHTTPS

    保密字典

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

    路径

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

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

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

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

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

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

    说明

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

    说明

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

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