intel/intel-npu-plugin

Intel NPU Plugin 镜像文档

镜像概述

Intel NPU Plugin是一个用于Kubernetes环境的组件，旨在通过提供对Intel Neural Processing Units (NPUs)的访问能力，实现工作负载的高效卸载，从而提升Kubernetes集群中计算密集型任务的处理性能。

核心功能与特性

• 提供对Intel NPUs的访问接口，支持Kubernetes工作负载直接利用NPU硬件资源
• 实现工作负载卸载，将计算任务从CPU转移到NPU，提高处理效率和资源利用率
• 与Kubernetes生态系统深度集成，支持标准的容器化部署和资源管理

使用场景与适用范围

适用于Kubernetes集群中需要硬件加速的工作负载场景，包括但不限于：

• AI推理任务（如深度学习模型部署、计算机视觉应用）
• 高性能数据处理与分析
• 边缘计算环境中的实时数据处理
• 对计算性能和能效比有较高要求的应用场景

使用方法与配置说明

部署准备

1. 确保Kubernetes集群节点已安装Intel NPU驱动及相关依赖组件
2. 确认节点已启用NPU设备并可被操作系统识别

部署方式

该插件通常以DaemonSet形式部署，确保集群中每个节点都能访问NPU资源：

DaemonSet部署示例

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: intel-npu-plugin
  namespace: kube-system
spec:
  selector:
    matchLabels:
      app: intel-npu-plugin
  template:
    metadata:
      labels:
        app: intel-npu-plugin
    spec:
      containers:
      - name: intel-npu-plugin
        image: docker.xuanyuan.run/intel/npu-plugin:latest
        resources:
          limits:
            intel.com/npu: 1  # 请求1个NPU设备
        volumeMounts:
        - name: npu-device
          mountPath: /dev/intel_npu  # NPU设备挂载路径
      volumes:
      - name: npu-device
        hostPath:
          path: /dev/intel_npu  # 主机NPU设备路径

验证部署

部署后通过以下命令验证插件状态：

bash
kubectl get daemonset intel-npu-plugin -n kube-system

工作负载使用示例

在Pod中使用NPU资源：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: npu-workload-example
spec:
  containers:
  - name: npu-app
    image: docker.xuanyuan.run/your-npu-application:latest
    resources:
      limits:
        intel.com/npu: 1  # 申请1个NPU设备

配置参数说明

• 镜像版本：建议指定具体版本标签（如:v1.0.0）以确保部署稳定性
• 资源请求/限制：通过intel.com/npu资源类型指定NPU设备数量
• 设备挂载路径：默认挂载路径为/dev/intel_npu，需与主机设备路径保持一致