集群网关

KubeSphere v3.3.0 提供集群级别的网关,使所有项目共用一个全局网关。本文档介绍如何在 KubeSphere 设置集群网关。

准备工作

您需要创建一个拥有 platform-admin 角色的用户,例如:admin。有关更多信息,请参见创建企业空间、项目、用户和平台角色.

创建集群网关

  1. admin 身份登录 web 控制台,点击左上角的平台管理并选择集群管理

  2. 点击导航面板中集群设置下的网关设置,选择集群网关选项卡,并点击开启网关

  3. 在显示的对话框中,从以下的两个选项中选择网关的访问模式:

    • NodePort:通过网关使用对应节点端口来访问服务。NodePort 访问模式提供以下配置:
      • 链路追踪:打开链路追踪开关以启用 KubeSphere 的链路追踪功能。功能开启后,如应用路由不可访问,请检查是否为应用路由是否添加注解(nginx.ingress.kubernetes.io/service-upstream: true)。如注解没有添加,则添加注解至您的应用路由中。
      • 配置选项:在集群网关中加入键值对。
    • LoadBalancer:通过网关使用单个 IP 地址访问服务。LoadBalancer 访问模式提供以下配置:
      • 链路追踪:打开链路追踪开关以启用 KubeSphere 的链路追踪功能。功能开启后,如应用路由不可访问,请检查是否为应用路由是否添加注解(nginx.ingress.kubernetes.io/service-upstream: true)。如注解没有添加,则添加注解至您的应用路由中。
      • 负载均衡器提供商:从下拉列表中选择负载均衡器提供商。
      • 注解:添加注解至集群网关。
      • 配置选项: 添加键值对至集群网关。

    信息

    • 为了使用链路追踪功能,请在创建自制应用时打开应用治理
    • 有关如何使用配置选项的更多信息,请参见 Configuration options
  4. 点击确定创建集群网关。

  5. 在这个页面中会展示创建的集群网关和该网关的基本信息。

    备注

    同时还创建了名为 kubesphere-router-kubesphere-system 的网关,作为集群中所有项目的全局网关。

  6. 点击管理,从下拉菜单中选择一项操作:

    • 查看详情:转至集群网关详情页面。
    • 编辑:编辑集群网关配置。
    • 关闭:关闭集群网关。
  7. 创建集群网关后,有关如何创建应用路由的更多信息,请参见应用路由

集群网关详情页面

  1. 集群网关选项卡下,点击集群网关右侧的管理,选择查看详情以打开其详情页面。
  2. 在详情页面,点击编辑以配置集群网关,或点击关闭以关闭网关。
  3. 点击监控选项卡,查看集群网关的监控指标。
  4. 点击配置选项选项卡以查看集群网关的配置选项。
  5. 点击网关日志选项卡以查看集群网关日志。
  6. 点击资源状态选项卡,以查看集群网关的负载状态。点击 集群网关 - 图1集群网关 - 图2 按钮,以增加或减少副本数量。
  7. 点击元数据选项卡,以查看集群网关的注解。

查看项目网关

网关设置页面,点击项目网关选项卡,以查看项目网关。

点击项目网关右侧的 集群网关 - 图3 ,从下拉菜单中选择操作:

  • 编辑:编辑项目网关的配置。
  • 关闭:关闭项目网关。

备注

如果在创建集群网关之前存在项目网关,则项目网关地址可能会在集群网关地址和项目网关地址之间切换。建议您只使用集群网关或项目网关。

关于如何创建项目网关的更多信息,请参见项目网关