Skip to content

Erupt K8s Dashboard 开箱即用的 Kubernetes 管理台 ​

erupt-k8s-dashboard 是基于 erupt-data-k8s 的独立仓库:加上依赖,后台就多出一个 Kubernetes 菜单,常用资源连同日志、Web 终端、扩缩容、滚动重启与 YAML 编辑一并就位,不用写任何模型与注解。

xml
<dependency>
    <groupId>xyz.erupt</groupId>
    <artifactId>erupt-k8s-dashboard</artifactId>
    <version>${erupt.version}</version>
</dependency>

需要 erupt 2.4.0 及以上。要给管理台没有内置的资源(如自定义资源)建模,直接用 erupt-data-k8s 的 @EruptK8s。

本地试用 ​

bash
mvn spring-boot:run
# http://localhost:8080  erupt / erupt

管理台可独立运行:使用 ./h2 下的 H2 文件库,读取 ~/.kube/config,kubectl 能看到的集群都会出现在 Workspace 选择器里。

内置菜单 ​

菜单Kind操作
PodsPod日志、实时日志、终端、YAML、删除
DeploymentsDeployment扩缩容、重启、YAML 新增 / 编辑、删除
Stateful SetsStatefulSet扩缩容、重启、YAML 新增 / 编辑、删除
Daemon SetsDaemonSet重启、YAML 新增 / 编辑、删除
ServicesServiceYAML 新增 / 编辑、删除
Config MapsConfigMapYAML 新增 / 编辑、删除
EventsEvent只读
NamespacesNamespace只读、YAML
NodesNode只读、YAML

每个资源是独立菜单,角色按菜单逐项授权;终端是单独的权限点(Pods 菜单的 TERMINAL 按钮),没有该按钮的用户看不到终端操作,服务端也拒绝渲染终端页面。

Workspace:当前集群与命名空间 ​

页头的 Workspace 选择器决定所有 Kubernetes 页面看哪个集群、哪个命名空间:

  • 集群列出 kubeconfig 里的全部 context,当前 context 排在最前并作为默认值,不再需要 kubectl config use-context。
  • 命名空间可选;留空看全部命名空间,选定后带命名空间的页面只显示该命名空间,隐藏命名空间搜索与列,新建资源也落在其中。

每个浏览器窗口各自记住一份 Workspace,两个窗口可以看两个集群。选择随每次请求以 erupt-scope 头发送,服务端会校验它是否在用户被提供的选项之内。Workspace 基于 Erupt 的 @EruptScope 实现,KubeScope 只是一个普通的 Erupt 表单。

集群连接 ​

默认走标准客户端链:KUBECONFIG → ~/.kube/config → 集群内 ServiceAccount。要读别的文件或固定一个集群:

yaml
erupt:
  k8s-dashboard:
    kubeconfig: /etc/erupt/kubeconfig   # 其中的 context 成为 Workspace 的集群选项,或者:
    master-url: https://10.0.0.1:6443   # 单集群,不可切换
    token: ${K8S_TOKEN}                 # 放在环境变量里,不要写进文件

只设 master-url 而不设 kubeconfig 时忽略 ~/.kube/config。管理台能做的事不会超过凭据允许的范围,请给它一个只覆盖管理员应当触碰资源的 ServiceAccount。

Web 终端 ​

终端在底部抽屉打开:终端运行 bash,镜像没有 bash 时退回 sh;实时日志先取最后 500 行再持续跟随;多容器 Pod 有容器切换器。

  • Socket 路径:WebSocket 监听 /erupt-k8s-terminal,前置反向代理需放行该路径的 upgrade 请求。
  • 一次性票据:页面携带 60 秒过期的票据,绑定用户会话、Pod 与容器,socket 不从浏览器接收 Pod 名;重新打开操作即可重连。
  • 离线可用:xterm.js 打包在 jar 内(/erupt-k8s-dashboard/xterm/),无外网也能用。

终端为何不在 erupt-data-k8s 里

数据源只负责把资源读成模型;终端需要 WebSocket、票据与独立权限点,属于管理台的职责。erupt-data-k8s 保持为纯数据源,终端随 erupt-k8s-dashboard 一起提供。

贡献者

The avatar of contributor named as YuePeng YuePeng

页面历史

Released under the Apache-2.0 License.