启用 Dashboard(KueueViz)
KueueViz 是一个基于 Web 的可视化工具,提供对 Kueue 工作负载、队列和资源分配的实时监控。 它提供了直观的 Dashboard,用于观察作业队列状态、资源利用率和工作负载进展。
本页面展示如何在你的集群中安装和配置 KueueViz。
本页面的目标读者是批处理管理员。
开始之前
请确保满足以下条件:
- Kubernetes 集群正在运行
- kubectl 命令行工具可以与你的集群通信
- 已安装 Helm 命令行工具
- 你的集群中已安装 Kueue
- (可选)用于外部访问的入口控制器(例如 Nginx Ingress Controller)
KueueViz 可以使用 Helm(推荐)或 kubectl 进行安装。 选择最适合你工作流程的方法。
与 Kueue 一起安装
在安装新的 Kueue 时一起安装 KueueViz:
helm install kueue oci://registry.k8s.io/kueue/charts/kueue \
--version=0.13.2 \
--namespace kueue-system \
--create-namespace \
--set enableKueueViz=true \ # 启用 KueueViz
--wait --timeout 300s
有关安装 Kueue 的更多信息,请参阅安装。
启用 KueueViz(安装 Kueue 之后)
如果 Kueue 已经安装,你可以通过 Helm 或 kubectl 启用 KueueViz。
通过 Helm 启用 KueueViz
在现有的 Helm 安装的 Kueue 上启用 KueueViz:
helm upgrade kueue oci://registry.k8s.io/kueue/charts/kueue \
--version=0.13.2 \
--namespace kueue-system \
--set enableKueueViz=true # 启用 KueueViz
通过 YAML 启用 KueueViz
在现有的 Kueue 安装上通过 YAML 启用 KueueViz:
kubectl apply --server-side -f https://github.com/kubernetes-sigs/kueue/releases/download/0.13.2/kueueviz.yaml
访问 Dashboard
端口转发(仅用于开发)
在开发或测试期间快速访问(已在 Docker Desktop 上测试):
kubectl port-forward svc/kueue-kueue-viz-frontend -n kueue-system 8080
kubectl port-forward svc/kueue-kueue-viz-backend -n kueue-system 8081:8080
编辑 kueue-viz-frontend Deployment 以设置环境变量
REACT_APP_WEBSOCKET_URL=ws://localhost:8081
。
然后在 http://localhost:8080 访问 Dashboard。
Ingress
对于生产部署,配置 Ingress 资源:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: kueueviz-ingress
namespace: kueue-system
spec:
rules:
- host: kueueviz.example.com
http:
paths:
- path: /api(/|$)(.*)
pathType: Prefix
backend:
service:
name: kueue-kueueviz-backend
port:
number: 8080
- path: /
pathType: Prefix
backend:
service:
name: kueue-kueueviz-frontend
port:
number: 8080
tls:
- hosts:
- kueueviz.example.com # 替换为你的域名
secretName: kueueviz-tls # 你需要首先创建 TLS 密钥
LoadBalancer
对于支持 LoadBalancer 的云环境:
apiVersion: v1
kind: Service
metadata:
name: kueueviz-loadbalancer
namespace: kueue-system
spec:
type: LoadBalancer
ports:
- name: http
port: 80
targetPort: 8080
protocol: TCP
selector:
app.kubernetes.io/name: kueue
app.kubernetes.io/component: kueueviz-frontend
升级
通过 Helm 升级
通过 Helm 升级 KueueViz:
helm upgrade kueue oci://registry.k8s.io/kueue/charts/kueue \
--version=0.13.2 \
--namespace kueue-system \
--set enableKueueViz=true
通过 YAML 升级
通过 YAML 升级 KueueViz:
kubectl apply --server-side -f https://github.com/kubernetes-sigs/kueue/releases/download/0.13.2/kueueviz.yaml
卸载
注意: 请确保卸载的是 KueueViz,而不是意外卸载 Kueue。
卸载 KueueViz 组件:
kubectl delete -f https://github.com/kubernetes-sigs/kueue/releases/download/0.13.2/kueueviz.yaml
下一步
反馈
这个页面有帮助吗?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.