准备 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 后缀。

示例配置:

操作系统硬件精确的主机内核Driver 镜像示例
基于 CTyunOS 的 Alauda OSAscend 310P6.6.0-0008.ctl4.aarch64alaudadockerhub/ascend-driver:25.5.0-310p-6.6.0-0008.ctl4
openEuler 24.03 LTS SP3Ascend 910B6.6.0-145.0.4.135.oe2403sp3.aarch64alaudadockerhub/ascend-driver:25.5.0-910b-6.6.0-145.0.4.135-oe2403sp3

验证源镜像架构,并将其镜像到目标业务集群 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 已处于正常状态。