• 简体中文
    • English
    • 简体中文
  1. 文档 / 
  2. v3.4 / 
  3. 在 Linux 上安装 / 
  4. 安装显卡驱动 / 
  5. 华为昇腾 (Ascend)

文档

最新更新:
    编辑

    安装华为昇腾 (Ascend) 驱动

    本文介绍在 Linux NPU 节点上安装华为昇腾驱动、固件及 Ascend Docker Runtime 的步骤，以便 Kube AI Hub 集群能够调度昇腾 NPU 工作负载。请在 KubeKey 创建集群之前于所有 NPU 工作节点上完成本节操作。

    前提条件

    • 节点配备华为昇腾 NPU（如 910B 等，以实际硬件为准）
    • 具有 root 或 sudo 权限
    • 已完成 时间同步配置
    • 已准备与 NPU 型号、操作系统及架构匹配的驱动、固件与 runtime 安装包

    安装顺序

    备注

    • 首次安装：按 驱动 → 固件 顺序执行
    • 覆盖安装或升级：按 固件 → 驱动 顺序执行

    安装介质

    类型 文件名示例
    NPU 驱动 Ascend-hdk-{model}-npu-driver_{version}_linux-{arch}.run
    NPU 固件 Ascend-hdk-{model}-npu-firmware_{version}.run
    Ascend Docker Runtime Ascend-docker-runtime_{version}_linux-{arch}.run

    将 {model}、{version}、{arch} 替换为实际值（如 910b、x86_64）。

    下载地址：

    创建运行用户

    昇腾驱动安装要求存在 HwHiAiUser 用户：

    sudo groupadd HwHiAiUser 2>/dev/null || true
sudo useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash 2>/dev/null || true

    安装依赖

    RHEL / CentOS / Rocky 等：

    sudo yum install -y dkms gcc make kernel-headers-$(uname -r) kernel-devel-$(uname -r)

    Ubuntu / Debian：

    sudo apt-get update
sudo apt-get install -y dkms gcc make linux-headers-$(uname -r)

    安装 NPU 驱动

    赋予执行权限并校验安装包：

    chmod +x Ascend-hdk-{model}-npu-driver_{version}_linux-{arch}.run
./Ascend-hdk-{model}-npu-driver_{version}_linux-{arch}.run --check

    输出 OK 表示包完整。执行安装：

    sudo ./Ascend-hdk-{model}-npu-driver_{version}_linux-{arch}.run --full

    安装 NPU 固件

    chmod +x Ascend-hdk-{model}-npu-firmware_{version}.run
./Ascend-hdk-{model}-npu-firmware_{version}.run --check
sudo ./Ascend-hdk-{model}-npu-firmware_{version}.run --full

    确认固件版本与安装包一致：

    /usr/local/Ascend/driver/tools/upgrade-tool --device_index -1 --component -1 --version

    验证驱动

    npu-smi info

    能正常输出 NPU 信息即表示驱动安装成功。

    安装 Ascend Docker Runtime

    校验并安装 runtime 包：

    chmod +x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --check
sudo ./Ascend-docker-runtime_{version}_linux-{arch}.run --install

    配置 containerd

    编辑 /etc/containerd/config.toml，确认 runtime 指向 Ascend Docker Runtime。在 [plugins."io.containerd.runtime.v1.linux"] 段中设置：

    [plugins."io.containerd.runtime.v1.linux"]
  no_shim = false
  runtime = "/usr/local/Ascend/Ascend-Docker-Runtime/ascend-docker-runtime"
  runtime_root = ""
  shim = "containerd-shim"
  shim_debug = false

    备注

    若使用 KubeKey 且 containerManager 为 containerd，请在创建集群前完成上述配置；集群创建后修改需重启 containerd 并可能影响已有 Pod。

    重启 containerd 使配置生效：

    sudo systemctl daemon-reload
sudo systemctl restart containerd

    验证清单

    检查项 命令 期望结果
    固件版本 upgrade-tool --device_index -1 --component -1 --version 与安装包版本一致
    NPU 驱动 npu-smi info 显示 NPU 设备信息
    Ascend Docker Runtime ls /usr/local/Ascend/Ascend-Docker-Runtime/ascend-docker-runtime 文件存在且可执行
    containerd systemctl status containerd active (running)

    故障排查

    --check 校验失败

    • 重新下载安装包，确认传输过程中未损坏
    • 确认安装包与硬件型号、操作系统架构匹配

    npu-smi 无输出或报错

    • 确认驱动与固件安装顺序正确（首次安装：驱动 → 固件）
    • 确认 HwHiAiUser 用户已创建
    • 检查内核头文件是否与当前内核一致：uname -r

    容器无法使用 NPU

    • 确认 /etc/containerd/config.toml 中 runtime 路径正确
    • 确认已重启 containerd
    • 查阅昇腾官方文档确认 CANN/驱动版本与容器镜像兼容
    上一篇 : 英伟达 (NVIDIA)
    页面内容