激活前准备

开始前请确认以下条件全部满足，缺一不可：

条件	说明
HAMi	集群已部署且正常运行，HAMi enterprise / HAMi AI Platform 已完成安装
kubectl 访问权限	当前 kubeconfig 对应角色在 hami-system 命名空间具备 secrets 资源的创建/更新权限

HAMi AI Platform 平台版

授权申请

证书获取

请完成安装任务，确保所有组件的 Pod 都正常启动后再开始激活流程。

1. 使用 平台管理员** ** 账号登录 HAMi AI Platform。

2. 进入 License 与系统信息 页面

3. 按照页面提示获取授权申请信息。

4. 将授权申请信息发送给密瓜智能销售或交付人员。

5. 根据指引完成激活。

接收 License

密瓜智能完成签发后，将由销售通过邮件交付 License 文件。

激活 License

1. 使用 平台管理员 账号登录 HAMi AI Platform。

2. 进入 License 与系统信息 页面。

3. 点击激活授权，选择销售邮件中收到的 License 文件。

4. 点击确认。

5. 等待系统完成校验。

检查调度器事件

验证结果

请确认：

• License 状态显示为“正常”。

• 产品和授权范围与采购内容一致。

• License 到期时间正确。

• 平台功能可以正常使用。

HAMi enterprise 企业版

接收 License

密瓜智能完成授权签发后，将由销售通过邮件交付 License 文件。

请将文件保存到能够通过 kubectl 访问目标 Kubernetes 集群的运维机器。

创建 License Secret

执行以下命令，将 License 文件创建为 Kubernetes Secret：

kubectl create secret generic hami-license \
  --from-file=license=/你的 License 文件路径 \
  -n hami-system

预期输出：

secret/hami-license created

添加 License 标签

Secret 创建成功后，执行：

kubectl label secret hami-license \
  hami.io/license="true" \
  -n hami-system

预期输出：

secret/hami-license labeled

至此，HAMi enterprise License 已完成部署。

检查 Secret

执行：

kubectl get secret hami-license -n hami-system

能够查询到 hami-license，表示 Secret 已成功创建。

检查 License 标签：

kubectl get secret hami-license \
  -n hami-system \
  -o jsonpath='{.metadata.labels.hami\.io/license}'

预期输出：

true

检查调度器事件

查看 secret/hami-license 的 Kubernetes events。

kubectl get events --field-selector involvedObject.name=hami-license -n hami-system

预期输出：

LAST SEEN   TYPE     REASON         OBJECT                MESSAGE
3m49s       Normal   LicenseValid   secret/hami-license   license c90a9410-5f94-44fd-95b8-XXXXXXXX validated successfully in secret hami-system/hami-license: expire_time=2027-06-18 08:01:51.85 +0000 UTC

验证节点 License 注册

执行以下命令，查看每个 GPU 节点的 License 注册情况：

kubectl get nodes -o custom-columns='NODE:.metadata.name,LICENSE:.metadata.annotations.hami\.io/nvidia-license'
NODE                                         LICENSE
gke-demo-gpu-pool-a843f02e-3fln   [{"uuid":"GPU-f9cd036c-382f-b13d-443f-8baac323f800","reminder":10,"expire":"2026-12-22T10:46:16.755Z"}]
gke-demo-gpu-pool-a843f02e-kbql   [{"uuid":"GPU-ba9a9a2d-0eda-cce5-0ac4-f961eb8020fd","reminder":10,"expire":"2026-12-22T10:46:16.755Z"}]
gke-demo-gpu-pool-a843f02e-n02f   [{"uuid":"GPU-daaff9d7-781c-db2b-f011-f6c28d99303d","reminder":10,"expire":"2026-12-22T10:46:16.755Z"}]

输出字段说明：

• uuid：GPU 设备 UUID，应与您提供给密瓜智能的硬件信息一致

• expire：License 过期时间（UTC）

校验清单 （逐项核对）：

• 所有 GPU 节点均出现在列表中，且 LICENSE 字段非空

• 各节点 GPU UUID 与采购清单/环境信息一致

• License 过期时间符合签发约定

若以上任一项不符合预期，请第一时间联系密瓜智能售后/技术支持。

输出示例（截图）：

至此，License 激活完成。

验证

运行示例工作负载

部署以下示例 Pod，确认 GPU 资源能被 HAMi 正常调度与使用：

apiVersion: v1
kind: Pod
metadata:
  name: gpu-pod
spec:
  containers:
    - name: ubuntu-container
      image: ubuntu:22.04
      command: ["bash", "-c", "sleep 86400"]
      resources:
        limits:
          nvidia.com/gpu: 1 # declare how many physical GPUs the pod needs
          nvidia.com/gpumem: 3000 # identifies 3000M GPU memory each physical GPU allocates to the pod （Optional,Integer）
          nvidia.com/gpucores: 30 # identifies 30% GPU GPU core each physical GPU allocates to the pod （Optional,Integer)

部署并验证：

# 部署示例 Pod
kubectl apply -f gpu-pod.yaml

# 等待 Pod 进入 Running 状态
kubectl get pod gpu-pod -w

# 进入容器执行 nvidia-smi，确认 GPU 资源可见
kubectl exec -it gpu-pod -- nvidia-smi

预期效果：Pod 处于 Running 状态，nvidia-smi 可在容器内看到分配到的 GPU 资源，可见显存与算力受 gpumem / gpucores 限制。

License 更新或续期

HAMi AI Platform 平台版

收到新的 License 文件后，重新进入平台 License 页面上传并激活。

HAMi Enterprise 企业版

如果集群中已经存在 hami-license Secret，应先删除原有 Secret：

kubectl delete secret hami-license -n hami-system

然后使用新的 License 文件重新创建：

kubectl create secret generic hami-license \
  --from-file=license=/实际的/License文件路径 \
  -n hami-system

重新添加标签：

kubectl label secret hami-license \
  hami.io/license="true" \
  -n hami-system

更新后通常无需重启，等待约 60 秒再验证节点注册情况。

FAQ

License 过期会发生什么？

• 已运行的 AI 工作负载不受影响，不会破坏在线业务

• 新调度请求将不再受理，已有业务如果发生重启也将无法再调度

• 恢复 ：替换 secret 60 秒内自动重新激活

一份 License 多集群能不能用？

• 不行，License 和集群一一绑定

离线 airgap 怎么续期？

1. SE 通过客户通道（邮件 / U 盘）发新 license 文件

2. 客户重新激活

3. 无需重启，60 秒生效，完全不联网

获取支持

如在激活或验证过程中遇到任何问题，请通过以下方式联系密瓜智能：

• 技术支持邮箱：it@dynamia.ai

• 官方网站：https://dynamia.ai

如遇授权异常、GPU 节点未注册、License 更新失败等问题，请联系密瓜智能技术支持团队。