kubesphere/kubectl

KubeSphere Web kubectl功能介绍

功能概述

Web kubectl是KubeSphere提供的基于Web界面的kubectl工具，无需在本地安装和配置kubectl客户端，用户可直接通过浏览器访问KubeSphere控制台，执行kubectl命令操作Kubernetes集群，实现集群资源管理、故障排查等功能。

主要用途

1. 降低环境依赖

无需在本地电脑安装kubectl二进制文件，也不用手动配置集群凭证（如kubeconfig），直接通过浏览器即可使用kubectl功能，尤其适合临时操作或跨设备管理场景（如从公共电脑访问集群）。

2. 提升操作便捷性

结合KubeSphere界面，可在集群/项目详情页直接打开终端，执行命令时无需切换工具（如从界面查看pod列表后，立即在终端执行kubectl logs查看日志），操作流程更连贯。

3. 适配多集群管理

若通过KubeSphere管理多个Kubernetes集群，切换集群后Web kubectl会自动关联当前集群上下文，无需手动切换本地kubectl的--context参数，简化多集群命令操作。

4. 集成权限控制

基于KubeSphere的RBAC权限体系，Web kubectl会严格限制用户操作范围。例如：普通用户仅能执行kubectl get kubectl describe等查询类命令；管理员可执行kubectl create kubectl delete等管理类命令，避免越权操作。

操作步骤

1. 登录KubeSphere控制台

通过浏览器访问KubeSphere控制台地址（如`[]

2. 进入目标集群/项目

• 多集群场景：在左侧导航栏点击“集群管理”，选择需要操作的集群，进入集群详情页；
• 单集群场景：直接在左侧导航栏选择目标项目，进入项目详情页。

3. 打开Web终端

在当前页面右上角或操作区找到“Web终端”或“kubectl终端”按钮（不同版本按钮名称可能略有差异），点击后会弹出终端窗口。

4. 执行kubectl命令

在终端窗口中输入常规kubectl命令，例如：

• 查询pod列表：kubectl get pods -n default
• 查看pod日志：kubectl logs nginx-pod-xxx -n default
• 编辑deployment：kubectl edit deployment nginx -n default
  输入后按回车执行，支持命令补全（按Tab键）。

5. 查看/处理结果

命令执行后，终端会实时显示输出内容（如资源列表、操作结果）；若命令有误（如权限不足、资源不存在），会显示详细报错信息（如Error from server (Forbidden): pods is forbidden: User "xxx" cannot list resource "pods" in API group "" in the namespace "default"），可根据提示调整操作。