集群网关

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 ，从下拉菜单中选择操作：

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

备注

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

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