准备 Driver 镜像和 ImageWhiteList
仅当所选安装场景要求详细导入 Driver 镜像或准备 ImageWhiteList 时,才使用此页面。大多数用户可以从安装 NPU Operator开始,选择一个场景,并仅在该场景要求执行这些步骤时返回此处。
选择匹配的预编译 Driver 镜像
对于不可变 OS 场景,导入与完整 (HDK, chip, kernel, OS) 配置匹配的 ARM64 Driver 镜像。NPU Operator 会根据 HDK 版本、检测到的芯片以及移除架构后缀的完整内核发行版本生成标签:
<HDK>-<chip>-<kernel-release-without-architecture>
对于已发布的 openEuler 标签,内核发行版本中的旧版 .oe 分隔符会变为 -oe。不要添加检测到的内核发行版本中不存在的 OS 后缀。
示例配置:
验证源镜像架构,并将其镜像到目标业务集群 registry:
SOURCE_IMAGE=docker.io/alaudadockerhub/ascend-driver:25.5.0-310p-6.6.0-0008.ctl4
TARGET_IMAGE=<your-cluster-registry>/mlops/ascend-driver:25.5.0-310p-6.6.0-0008.ctl4
skopeo inspect --override-arch arm64 docker://$SOURCE_IMAGE
skopeo copy --override-arch arm64 docker://$SOURCE_IMAGE docker://$TARGET_IMAGE
skopeo inspect --override-arch arm64 docker://$TARGET_IMAGE
如果没有已发布的标签与节点内核匹配,请记录 uname -r 和芯片型号,然后联系支持人员。
配置 ImageWhiteList
如果目标集群强制执行镜像白名单策略,请允许 NPU Operator 渲染出的精确 Driver 镜像引用,并将其重写为导入业务集群 registry 的镜像。
apiVersion: app.alauda.io/v1alpha1
kind: ImageWhiteList
metadata:
name: npu-operator-precompiled-driver
namespace: cpaas-system
spec:
repoList:
- build-harbor.alauda.cn/mlops/ascend-driver:25.5.0-310p-6.6.0-0008.ctl4
rewriteRules:
- regexp: ^build-harbor\.alauda\.cn/mlops/ascend-driver:25\.5\.0-310p-6\.6\.0-0008\.ctl4$
replacement: <your-cluster-registry>/mlops/ascend-driver:25.5.0-310p-6.6.0-0008.ctl4
在目标业务集群中应用白名单,保留不相关的条目,并为每个受支持的 Driver 标签使用一条精确规则。
创建 NPUOperatorCtl 后,验证渲染出的引用以及实际运行的镜像:
kubectl get npuclusterpolicy cluster \
-o jsonpath='{.spec.driver.imageSpec.repository}{"\n"}'
kubectl -n npu-operator get pods \
-l app.kubernetes.io/component=npu-driver \
-o jsonpath='{range .items[*]}{.metadata.name}{"\n"}{range .status.containerStatuses[*]}{.name}{" imageID="}{.imageID}{"\n"}{end}{end}'
获准使用的镜像及其 imageID 必须与预期导入的 Driver 工件匹配。
物理主机和外部 Driver 场景
对于由 operator 管理的物理主机,请使用随附的 Driver 安装程序和 installMode: host、usePrecompiled: false。对于外部 Driver 场景,请跳过 Driver 镜像准备,并确认每个选定的 NPU 节点上的 /usr/local/Ascend/driver 已处于正常状态。