使用 Helm Charts 部署 HAMi WebUI

本文介绍如何在 Kubernetes 集群中使用 Helm Chart 部署并运行 HAMi WebUI。

HAMi WebUI 默认仅通过本地访问（localhost）提供服务，因此在部署完成后，需要通过配置本地 ~/.kube/config 文件以连接目标集群并访问 WebUI。

官方仓库提供了用于部署 HAMi WebUI 的 Helm Chart，详见： https://github.com/Project-HAMi/HAMi-WebUI/tree/main/charts/hami-webui

如在使用过程中遇到问题，可在 HAMi-WebUI 仓库提交 Issue 进行反馈。

先决条件

要使用 Helm 安装 HAMi WebUI，请确保满足以下要求：

1. 本地主机上的 Kubectl

2. HAMi >= 2.4.0

3. Prometheus > 2.8.0

4. Helm > 3.0

使用 Helm 安装 HAMi WebUI

部署 HAMi WebUI Helm charts

要设置 HAMi WebUI Helm 仓库，以便在你的机器上下载正确的 HAMi WebUI Helm charts，请完成以下步骤：

1. 使用以下命令语法添加 HAMi WebUI 仓库：

   helm repo add hami-webui https://project-hami.github.io/HAMi-WebUI

2. 使用以下命令部署 HAMi WebUI：

   helm install my-hami-webui hami-webui/hami-webui --set externalPrometheus.enabled=true --set externalPrometheus.address="http://prometheus-kube-prometheus-prometheus.monitoring.svc.cluster.local:9090" -n kube-system

   重要：你需要将 externalPrometheus.address 的值替换为集群内的 Prometheus 地址

   你可以在安装期间根据配置文档在 values.yaml 中设置其他字段。

3. 运行以下命令以验证安装：

   kubectl get pods -n kube-system | grep webui

   如果安装成功，你应该看到 hami-webui 和 hami-webui-dcgm-exporter 都处于运行状态。

访问 HAMi WebUI

1. 在本地主机中配置 ~/.kube/config 以便能够连接到你的集群。

2. 运行以下命令以在本地主机上对 HAMi WebUI 服务进行端口转发，端口为 3000。

   kubectl port-forward service/my-hami-webui 3000:3000 --namespace=kube-system

   有关端口转发的更多信息，请参阅使用端口转发访问集群中的应用程序。

3. 在浏览器中导航到 localhost:3000。

   HAMi WebUI 资源概览页面将出现。

故障排除

本节包括在通过 Helm 在 Kubernetes 上部署 HAMi WebUI 时可能会发现有用的故障排除提示。

收集日志

在排查任何问题时，查看 HAMi WebUI 服务器日志非常重要。

要检查 HAMi WebUI 日志，请运行以下命令：

kubectl logs --namespace=hami deploy/my-hami-webui -c hami-webui-fe-oss
kubectl logs --namespace=hami deploy/my-hami-webui -c hami-webui-be-oss

有关访问 Kubernetes 应用程序日志的更多信息，请参阅 Pods 和 Deployments。

卸载 HAMi WebUI 部署

要卸载 HAMi WebUI 部署，请运行命令：

helm uninstall <RELEASE-NAME> <NAMESPACE-NAME>

helm uninstall my-hami-webui -n hami

这将删除给定命名空间 hami 中的所有对象。

如果你想删除命名空间 hami，请运行命令：

kubectl delete namespace hami