集群网关
KubeSphere v3.2.x 提供集群级别的网关,使所有项目共用一个全局网关。本文档介绍如何在 KubeSphere 设置集群网关。
准备工作
您需要创建一个拥有 platform-admin
角色的用户,例如:admin
。有关更多信息,请参见创建企业空间、项目、用户和平台角色.
创建集群网关
-
以
admin
身份登录 web 控制台,点击左上角的平台管理并选择集群管理。 -
点击导航面板中集群设置下的网关设置,选择集群网关选项卡,并点击开启网关。
-
在显示的对话框中,从以下的两个选项中选择网关的访问模式:
- NodePort:通过网关使用对应节点端口来访问服务。NodePort 访问模式提供以下配置:
- 链路追踪:打开链路追踪开关以启用 KubeSphere 的链路追踪功能。功能开启后,如应用路由不可访问,请检查是否为应用路由是否添加注解(
nginx.ingress.kubernetes.io/service-upstream: true
)。如注解没有添加,则添加注解至您的应用路由中。 - 配置选项:在集群网关中加入键值对。
- 链路追踪:打开链路追踪开关以启用 KubeSphere 的链路追踪功能。功能开启后,如应用路由不可访问,请检查是否为应用路由是否添加注解(
- LoadBalancer:通过网关使用单个 IP 地址访问服务。LoadBalancer 访问模式提供以下配置:
- 链路追踪:打开链路追踪开关以启用 KubeSphere 的链路追踪功能。功能开启后,如应用路由不可访问,请检查是否为应用路由是否添加注解(
nginx.ingress.kubernetes.io/service-upstream: true
)。如注解没有添加,则添加注解至您的应用路由中。 - 负载均衡器提供商:从下拉列表中选择负载均衡器提供商。
- 注解:添加注解至集群网关。
- 配置选项: 添加键值对至集群网关。
- 链路追踪:打开链路追踪开关以启用 KubeSphere 的链路追踪功能。功能开启后,如应用路由不可访问,请检查是否为应用路由是否添加注解(
信息
- 为了使用链路追踪功能,请在创建自制应用时打开应用治理。
- 有关如何使用配置选项的更多信息,请参见 Configuration options。
- NodePort:通过网关使用对应节点端口来访问服务。NodePort 访问模式提供以下配置:
-
点击确定创建集群网关。
-
在这个页面中会展示创建的集群网关和该网关的基本信息。
备注
同时还创建了名为 kubesphere-router-kubesphere-system 的网关,作为集群中所有项目的全局网关。 -
点击管理,从下拉菜单中选择一项操作:
- 查看详情:转至集群网关详情页面。
- 编辑:编辑集群网关配置。
- 关闭:关闭集群网关。
-
创建集群网关后,有关如何创建应用路由的更多信息,请参见应用路由。
集群网关详情页面
- 在集群网关选项卡下,点击集群网关右侧的管理,选择查看详情以打开其详情页面。
- 在详情页面,点击编辑以配置集群网关,或点击更多操作以选择操作。
- 点击监控选项卡,查看集群网关的监控指标。
- 点击配置选项选项卡以查看集群网关的配置选项。
- 点击网关日志选项卡以查看集群网关日志。
- 点击资源状态选项卡,以查看集群网关的负载状态。点击 或 按钮,以增加或减少副本数量。
- 点击元数据选项卡,以查看集群网关的注解。
查看项目网关
在网关设置页面,点击项目网关选项卡,以查看项目网关。
点击项目网关右侧的 ,从下拉菜单中选择操作:
- 编辑:编辑项目网关的配置。
- 关闭:关闭项目网关。
备注
如果在创建集群网关之前存在项目网关,则项目网关地址可能会在集群网关地址和项目网关地址之间切换。建议您只使用集群网关或项目网关。
关于如何创建项目网关的更多信息,请参见项目网关。
反馈
这篇文章对您有帮助吗?
通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知
感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。
页面内容