本节介绍如何将 Kubernetes 自定义资源（CRD）快速集成至 KubeSphere，并通过侧边栏菜单统一查看和管理。

前提条件

  • 您具有快速集成资源的管理权限。

  • KubeSphere 平台已安装并启用快速集成扩展组件。

操作步骤

  1. 登录 KubeSphere Web 控制台，在扩展坞中点击 快速集成，然后在页面右上角点击 创建。

  2. 在 基本信息 区域填写以下参数。

    参数 描述

    名称

    快速集成资源的名称。只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 63 个字符。

    描述

    快速集成资源的描述信息，最长 256 个字符。该参数为可选项。

    菜单名称

    集成成功后显示在侧边栏一级菜单中的名称。

    菜单图标

    侧边栏菜单使用的图标。

    菜单位置

    集成资源挂载的菜单层级，可选 集群 或 企业空间。

    菜单位置说明如下：

    • 集群：在集群范围内管理该功能模块，适用于平台管理员进行统一配置和运维。

    • 企业空间：在企业空间中管理该功能模块，适用于多租户场景下的资源隔离与治理。选择该位置时，无法管理集群级（Cluster-scoped）的自定义资源。

  3. 点击 添加资源集成，按需选择以下方式添加 CRD 资源。

    方式 说明

    指定现有资源

    从列表中选择已有的 Kubernetes 自定义资源。列表按集群分组展示，每条记录显示资源名称（plural-name）、API 组和作用域。

    自行编写

    手动填写资源名称（plural-name）、API 组、API 版本和作用域。该方式同时支持 Kubernetes 原生 API 资源。

    说明：*.kubesphere.io 等系统资源在列表中显示为置灰状态，无法选中。KubeSphere 自身的自定义资源已提供对应的可视化管理界面，无需通过快速集成功能重复管理。

  4. 为该资源设置对应的 二级菜单名称 和 路径，然后点击 保存。

    如需继续添加其他资源，可重复点击 添加资源集成。

  5. 确认所有配置无误后，点击 完成。

创建完成后，刷新页面，新创建的快速集成资源将显示在侧边栏菜单中。点击对应入口，即可查看和管理相关的 Kubernetes 自定义资源。