Skip to main content
note

有关扩展组件管理的更多信息,请参阅官方文档:KubeSphere 扩展管理

安装扩展组件

本章节介绍如何在 KubeSphere 扩展中心(Extension Center) 中安装扩展组件。
有关扩展组件的访问、配置与使用方法,请参阅扩展组件使用指南。

🛠 前提条件

  • 您必须在 KubeSphere 平台拥有 platform-admin 角色(平台管理员权限)。
    如需了解更多用户与角色相关信息,请参考 用户和平台角色

⚙️ 安装步骤

  1. 使用具有 platform-admin 角色的账号登录 KubeSphere Web 控制台。

  2. 进入 扩展中心(Extension Center),搜索你要安装的扩展组件。

  3. 点击扩展组件名称,然后点击 安装(Install),进入组件安装页面。

  4. 版本选择 页签中,选择扩展组件的版本号,并确认所有必装组件都已选中,点击 下一步

    说明
    在安装检测阶段,系统会识别该扩展组件是否依赖其他组件。
    这些依赖分为 必装组件选装组件

    • 若某个必装组件状态显示 未就绪,则需要先安装该组件的正确版本,才能继续后续安装。
    • 选装组件则不会阻止扩展组件的安装。
  5. 切换到 扩展组件配置 页签,在自定义配置输入框填入你所需的参数。检查 最终配置 后,点击 下一步

    小贴士:

    • 点击右上角按钮可全屏查看配置内容
    • 可上传自定义配置文件、下载当前配置或复制配置内容
  6. 扩展组件安装 页签点击 开始安装(Install),启动扩展组件安装流程。

  7. 安装完成后,点击 下一步

  8. 集群选择 页签,选择目标集群(可以选择多个集群)以便在这些集群中启用该扩展组件。

  9. 差异化配置 页签,可对不同集群的 Agent 配置进行个性化设置(如有必要),然后点击 确定 安装 Agent。等待安装完成即可。

⚠️ 注意:
有些扩展组件不需要安装集群 Agent,即可能跳过 “集群选择” 与 “差异化配置” 页签,仅需按照页面提示完成安装。

安装成功后,该扩展组件默认即被启用。

🧭 后续操作 & 使用

  • 在 KubeSphere 控制台的扩展中心中,查看已安装扩展列表
  • 对已安装的扩展进行升级、配置或卸载
  • 使用扩展组件提供的功能模块(访问 UI、管理 Agent、查看状态等)

📘 延伸阅读