安装 Alauda AI Infrastructure Accelerator Virtualization Console

Alauda AI Infrastructure Accelerator Virtualization Console 是 HAMi 产品线中的可选组件。当用户除了 ACP 监控之外还需要 HAMi 专属资源概览时,请安装此组件。

开始之前

  • 安装 Alauda Build of HAMi。
  • 在版本和组件中确认受支持的 HAMi-WebUI 版本。
  • 从为目标 ACP 环境配置的软件包源中,获取适用于目标架构的 Alauda AI Infrastructure Accelerator Virtualization Console v1.3.0 Operator Bundle。
  • 确认目标集群中已提供 ACP 监控,并且 HAMi-WebUI 可以访问其 Prometheus 查询地址。
  • 获取集群管理员访问权限。生成的 Prometheus 身份验证值属于凭证,必须作为机密信息处理。
WARNING

v1.3.0 Operator Bundle 无法从早期的 HAMi-WebUI 集群插件原位升级。请先卸载旧的集群插件,等待其 operator、WebUI 工作负载、Service 和配置资源被移除,然后全新安装 v1.3.0。

准备 Prometheus 设置

插件表单要求提供 Prometheus 地址,并接受 HTTP Authorization 标头的完整值。对于 Basic 身份验证,该值必须包含方案前缀:

Basic <base64(username:password)>

使用以下脚本读取监控 Feature 并生成这两个表单值。该脚本不会分别输出用户名或密码。

prometheus_address=$(kubectl get feature monitoring \
  -o jsonpath='{.spec.accessInfo.database.service}')
if [ -z "$prometheus_address" ]; then
  prometheus_address=$(kubectl get feature monitoring \
    -o jsonpath='{.spec.accessInfo.database.address}')
fi

prometheus_secret=$(kubectl get feature monitoring \
  -o jsonpath='{.spec.accessInfo.database.basicAuth.secretName}')
prometheus_namespace=cpaas-system

prometheus_username=$(kubectl get secret "$prometheus_secret" \
  -n "$prometheus_namespace" -o jsonpath='{.data.username}' | base64 -d)
prometheus_password=$(kubectl get secret "$prometheus_secret" \
  -n "$prometheus_namespace" -o jsonpath='{.data.password}' | base64 -d)

prometheus_auth="Basic $(printf '%s:%s' \
  "$prometheus_username" "$prometheus_password" | base64 | tr -d '\n')"

printf 'Prometheus Address: %s\n' "$prometheus_address"
printf 'Prometheus Auth: %s\n' "$prometheus_auth"
WARNING

请勿省略 Basic 前缀。HAMi-WebUI 会将配置的身份验证字符串原样作为 Prometheus 的 Authorization 标头发送。不带方案前缀的 base64 值可能会被重定向到授权页面,而不是接收 Prometheus JSON。

从可以访问返回地址的网络位置验证凭证,然后再安装插件:

curl --insecure --silent --show-error --fail \
  -H "Authorization: $prometheus_auth" \
  --get --data-urlencode 'query=up' \
  "${prometheus_address%/}/api/v1/query"

成功的响应包含 "status":"success" 和 Prometheus JSON data 对象。HTML 页面、登录页面或授权重定向都不是有效响应。

安装 Operator Bundle

  1. 将 hami-webui-operator 软件包添加到选定的 ACP catalog,并创建或更新其 Subscription。

  2. 当 Subscription 使用手动批准时,批准生成的 InstallPlan。

  3. 等待 CSV hami-webui-operator.v1.3.0 达到 Succeeded,并等待 operator Deployment 变为 Ready。

  4. 在 cpaas-system 中创建 HamiWebUI 资源,并根据目标集群的要求配置 Prometheus 和服务设置。

  5. 填写或更新 WebUI 配置:

    字段值
    Prometheus 地址监控 Feature 返回的地址。
    Prometheus 身份验证完整的 Basic <base64(username:password)> Authorization 值。
    启用 NodePort可选。根据环境要求及其网络策略允许的情况,启用直接节点访问。
    端口号30000 到 32767 范围内的可用 NodePort;表单通常默认为 30300。
  6. 等待 WebUI pod 变为 Ready:

    kubectl get pods -n cpaas-system | grep hami-webui

访问 HAMi-WebUI

平台支持访问时,使用 ACP route:

{platform-url}/clusters/{cluster-name}/hami-webui

启用 NodePort 后,查找服务端口和可访问的节点地址:

kubectl get svc -n cpaas-system | grep hami-webui
kubectl get nodes -o wide

使用选定的 NodePort 打开直接任务页面:

http://<node-ip>:<node-port>/admin/vgpu/task/admin

验证 Prometheus 查询路径

对于 NodePort 部署,查询页面使用的同一 WebUI 后端端点:

hami_webui_url=http://<node-ip>:<node-port>

curl --silent --show-error --fail \
  -H 'Content-Type: application/json' \
  --data '{"query":"up"}' \
  "${hami_webui_url}/api/vgpu/v1/monitor/query/instant-vector"

预期响应是包含 data 数组的 JSON 对象,例如 {"data":[...]}。HTTP 523、VGPU_DOMAIN_ERROR 或包含 HTML 文档的错误表示 WebUI 后端未收到有效的 Prometheus API 响应。请参阅 故障排除。

后续步骤