note
有关扩展组件管理的更多信息,请参阅官方文档:KubeSphere 扩展管理
安装扩展组件
本章节介绍如何在 KubeSphere 扩展中心(Extension Center) 中安装扩展组件。
有关扩展组件的访问、配置与使用方法,请参阅扩展组件使用指南。
🛠 前提条件
- 您必须在 KubeSphere 平台拥有 platform-admin 角色(平台管理员权限)。
如需了解更多用户与角色相关信息,请参考 用户和平台角色。
⚙️ 安装步骤
-
使用具有 platform-admin 角色的账号登录 KubeSphere Web 控制台。
-
进入 扩展中心(Extension Center),搜索你要安装的扩展组件。
-
点击扩展组件名称,然后点击 安装(Install),进入组件安装页面。
-
在 版本选择 页签中,选择扩展组件的版本号,并确认所有必装组件都已选中,点击 下一步。
说明:
在安装检测阶段,系统会识别该扩展组件是否依赖其他组件。
这些依赖分为 必装组件 与 选装组件:- 若某个必装组件状态显示 未就绪,则需要先安装该组件的正确版本,才能继续后续安装。
- 选装组件则不会阻止扩展组件的安装。
-
切换到 扩展组件配置 页签,在自定义配置输入框填入你所需的参数。检查 最终配置 后,点击 下一步。
小贴士:
- 点击右上角按钮可全屏查看配置内容
- 可上传自定义配置文件、下载当前配置或复制配置内容
-
在 扩展组件安装 页签点击 开始安装(Install),启动扩展组件安装流程。
-
安装完成后,点击 下一步。
-
在 集群选择 页签,选择目标集群(可以选择多个集群)以便在这些集群中启用该扩展组件。
-
在 差异化配置 页签,可对不同集群的 Agent 配置进行个性化设置(如有必要),然后点击 确定 安装 Agent。等待安装完成即可。
⚠️ 注意:
有些扩展组件不需要安装集群 Agent,即可能跳过 “集群选择” 与 “差异化配置” 页签,仅需按照页面提示完成安装。
安装成功后,该扩展组件默认即被启用。
🧭 后续操作 & 使用
- 在 KubeSphere 控制台的扩展中心中,查看已安装扩展列表
- 对已安装的扩展进行升级、配置或卸载
- 使用扩展组件提供的功能模块(访问 UI、管理 Agent、查看状态等)