配置工作负载
选择资源键后,配置 NPU 工作负载的运行时行为。启用默认的准入 webhook 后,请让工作负载清单专注于 NPU 资源请求,并由 webhook 添加 ascend RuntimeClass。
本页介绍通过 Alauda Build of NPU Operator 直接分配整卡。如果尚未选择分配所有者,请先参阅选择 Ascend NPU 分配模式。对于 Ascend 设备上的 HAMi 调度、共享、虚拟化、vNPU 行为或 HAMi 专用资源键,请按照该页面链接的 HAMi 路径操作。
资源请求
有关工作负载资源字段和示例,请参阅请求 NPU 资源。请使用目标节点报告的确切资源键。常见示例包括用于 910 系列设备的 huawei.com/Ascend910、huawei.com/Ascend310P,以及其他依环境而异的 huawei.com/Ascend* 键。请勿仅根据芯片产品名称推断资源键。
RuntimeClass 行为
NPU Operator v26.6.0 使用由 ascend-docker-runtime 支持的 ascend RuntimeClass。运行时集成 DaemonSet 会暂存 ascend-docker-runtime 负载,并使用 npu-container-toolkit 在每个 NPU 节点上配置相应的 containerd handler。
准入 webhook 会为请求 Ascend 资源的 Pod 添加 ascend RuntimeClass。启用 webhook 时,新清单无需设置 runtimeClassName。如果禁用了 webhook,请显式设置 runtimeClassName: ascend。
在 v26.6.0 中,请将 operator.runtimeClass 保持为 ascend。运行时集成 DaemonSet 会以该名称注册 containerd handler,因此只更改 Operator 设置会导致 RuntimeClass 与 containerd handler 不匹配。
运行时集成验证提示
排查已请求 NPU 资源但无法看到设备的工作负载时,请确认准入后的 Pod 使用 ascend RuntimeClass,并且运行时集成 DaemonSet 已就绪。在场景 2.2 中,Driver 库从 /run/ascend/driver 下的 Host runtime Driver 目录暂存;在场景 1 和 2.1 中,组件使用 /usr/local/Ascend/driver 下的 Host Driver。
在工作负载容器内,检查是否存在 /usr/local/bin/npu-smi、/usr/local/Ascend/... 和 /dev/davinci* 等路径。请勿将这些工作负载侧路径与主机侧 Driver 目录混淆。
调度和配额
如果工作负载一直处于 Pending 状态:
- 检查节点是否报告了所请求的资源键。
- 检查 ACP 中的项目和命名空间配额。
- 检查节点是否处于 Driver 升级或恢复状态。
有关 ACP 中配额字段的显示,请参阅 Accelerator Resource Quota。