# CCE AI套件（NVIDIA GPU）
#### 插件简介
CCE AI套件（NVIDIA GPU）插件是一款用于启用和管理GPU资源的设备管理插件，支持容器内访问GPU显卡资源，帮助用户在云原生环境中高效运行和运维基于GPU的计算密集型工作负载。通过该插件，Standard/Turbo集群可具备GPU调度、驱动自动化安装、运行时管理及性能指标监控等能力，为GPU工作负载提供完整的生命周期支持。集群中使用GPU节点时必须安装本插件。
#### nvidia-gpu-device-plugin工作机制
nvidia-gpu-device-plugin是CCE AI套件（NVIDIA GPU）插件的核心组件之一，作为连接容器平台与GPU硬件的桥梁，它能够将物理GPU资源抽象为容器平台可识别、可调度的资源类型，从而解决容器化环境中GPU资源的分配与使用问题。
该组件以DaemonSet方式部署在集群的每个节点上，可让节点上的GPU被kubelet发现并上报至Kubernetes。此后，用户只需在Pod spec中声明所需的GPU资源，即可调用对应节点上的GPU资源。kubelet不主动感知GPU设备，需要依赖nvidia-gpu-device-plugin注册和汇报GPU信息。这个插件运行在每个GPU节点上，并通过gRPC协议与kubelet的Device Plugin Manager进行通信，完成注册流程。其具体工作流程如下：
图1GPU资源上报与健康   
![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002430726529.png "点击放大")
1. 注册请求：nvidia-gpu-device-plugin以客户端的身份向kubelet发起注册请求，主要汇报以下关键信息：
   - 设备名称：即nvidia.com/gpu，用于标识插件所管理的硬件资源类型，便于kubelet识别和调度。
   
   - Unix Socket：用于组件与kubelet进行本地gRPC通信，确保kubelet能准确调用正确的服务。
   
   - API版本：标明所使用的Device Plugin API协议版本，以保证双方通信协议兼容。
    
2. 启动服务：完成注册后，nvidia-gpu-device-plugin会启动一个gRPC服务器，正式对外提供服务，用于接收并响应kubelet发起的请求，包括设备列表查询、健康状态汇报、资源分配等。该gRPC服务监听的地址（Unix Socket路径）及支持的Device Plugin API版本，均在注册阶段已向kubelet上报，确保kubelet能基于注册信息正确建立连接并调用相应接口。
3. 健康监控：当gRPC服务器启动后，kubelet会通过ListAndWatch接口与nvidia-gpu-device-plugin建立一个长连接，用于持续监听设备ID及其健康状态。一旦nvidia-gpu-device-plugin检测到某个设备出现异常，会通过该连接主动上报给kubelet。
4. 信息上报：kubelet会将这些设备信息整合到节点的状态中，并将设备数量等资源数据上报至kube-apiserver。后续调度器（kube-scheduler/volcano）便可基于这些信息进行资源调度决策。
5. 持久化存储：CCE会将节点上报的GPU设备信息（如数量、状态等）存储至Etcd中，实现集群级资源状态的持久化。这一过程确保了GPU资源数据在集群组件故障或重启后不丢失，同时为调度器、控制器等组件提供一致的数据源，保障资源调度与管理的可靠性。
 
#### GPU Device Plugin DRA模式说明
插件自v2.15.0版本起，GPU Device Plugin正式支持DRA（Dynamic Resource Allocation）模式。该模式基于开源社区nvidia-dra组件（当前集成版本v25.12.0） 构建，可提供更灵活、声明式的GPU资源分配能力。
- 核心特性与变更
  - 架构重构：启用DRA模式后，GPU资源的调度与分配将由gpu-kubelet-plugin组件全面接管。原生GPU Device Plugin插件中，除自动安装驱动功能外，其余资源管理相关功能均将禁用。
  
  - 功能聚焦：当前版本专注于基础的GPU计算资源管理，暂不支持GPU共享模式、GPU虚拟化，并移除了社区版本中与Compute Domain及网络相关的扩展组件。
  
  - 开启DRA模式：在部署YAML配置文件中，将dra_mode参数设置为true即可开启。
   
- 使用约束
  - 集群版本：需使用Kubernetes v1.34及以上版本。
  
  - 驱动版本限制：DRA模式下请安装580及以上版本的驱动。
  
  - 调度器兼容性：若集群使用Volcano调度器，需确保其版本为v1.22.1及以上。
  
  - 容器运行时：不支持Docker Runtime，请使用containerd或其他兼容CRI的运行时。
  
  - 资源申请API变更：DRA模式与原生Device Plugin组件的调度机制"互斥"。一旦开启DRA，Pod中传统的resources.requests/limits字段将不再支持GPU资源申请，必须全面转向使用DRA标准的ResourceClaim API来声明资源。
   
- 从Device Plugin迁移至DRA
  ![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/warning_3.0-zh-cn.png)
  切换Device Plugin与DRA设备管理方式时，已分配设备在新管理方式下会被错误识别为空闲状态。此行为可能导致设备重复分配、运行时冲突或业务中断。请在执行切换前充分评估风险，并严格遵循本章节的建议。
  - 核心风险：在Kubernetes集群中，传统Device Plugin与DRA采用两套完全独立、互不感知的设备资源记账机制。当集群从Device Plugin模式卸载旧框架并启用DRA新框架时，新框架不会继承旧框架的历史分配记录，导致已经被存活Pod占用的物理GPU在新框架下被错误标记为"可用/空闲"。这些GPU会重新参与调度，造成设备重复分配，进而引发运行时冲突、CUDA显存争抢或业务中断等问题。
  
  - 典型故障表现：如果在切换前未彻底清理旧业务，新调度的Pod启动时会与仍在运行的旧进程发生显存碰撞，导致新业务在初始化或预分配显存阶段直接触发CUDA Out of Memory (OOM)，进而引发Pod反复启动失败或持续处于CrashLoopBackOff状态。
  
  - 迁移操作建议与最佳实践
    - 清空过渡期分配：切换前，确保所有依赖目标设备的旧版工作负载已优雅终止或完成迁移。
      ```
      kubectl get pods -A -o wide | grep <设备标签>
      ```
      
    
    - 节点隔离调度：通过为节点添加标签（如device-mgmt=legacy/ device-mgmt=dra），配合nodeSelector或亲和性设置，防止新旧工作负载混部。
     
   
 
#### 约束与限制
- 下载的驱动必须是后缀为".run"的文件。
- 仅支持Nvidia Tesla驱动，不支持GRID驱动。
- 安装或重装插件时，需要保证驱动下载链接正确且可正常访问，插件对链接有效性不做额外校验。
- 插件仅提供驱动的下载及安装脚本执行功能，插件的状态仅代表插件本身功能正常，与驱动是否安装成功无关。
- 对于GPU驱动版本与您业务应用的兼容性（GPU驱动版本与CUDA库版本的兼容性），CCE不做保证，请您自行验证。
- 对于已经安装GPU驱动的自定义操作系统镜像，CCE无法保证其提供的GPU驱动与CCE其他GPU组件兼容（例如监控组件等）。
- 如果您使用不在[GPU驱动支持列表]内的GPU驱动版本，可能引发GPU驱动与操作系统版本、ECS实例类型、Container Runtime等不兼容，继而导致驱动安装失败或者CCE AI套件（NVIDIA GPU）插件异常。对于使用自定义GPU驱动的场景，请您自行验证。
 
 #### 安装插件
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
2. 在左侧导航栏中选择"插件中心"，在右侧找到**CCE AI套件（NVIDIA GPU）**插件，单击"安装"。
3. 选择是否"启用dcgm-exporter组件进行DCGM指标观测"，开启后将在GPU节点上同时部署dcgm-exporter组件。 
   ![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/notice_3.0-zh-cn.png)
   插件版本为2.7.40及以上时，支持部署dcgm-exporter组件。dcgm-exporter组件保持社区能力，暂不支持共享模式和GPU虚拟化。
   启用dcgm-exporter组件后，如果需要将采集的GPU监控数据上报至AOM服务，请参见[实现DCGM指标的全面监控](https://support.huaweicloud.com/usermanual-cce/cce_10_0956.html)。
   
   
4. 设置插件支持的"参数配置"。 
   表1CCE AI套件（NVIDIA GPU）插件参数配置 
   | 参数   | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   |:---|:---|
   | 集群默认驱动 | 集群下全部GPU节点将使用相同的驱动，请选择合适的GPU驱动版本，或自定义驱动链接地址，填写Nvidia驱动的下载链接。 须知： - 如果下载链接为公网地址，如nvidia官网地址（https://us.download.nvidia.com/tesla/470.103.01/NVIDIA-Linux-x86_64-470.103.01.run），各GPU节点均需要绑定EIP。获取驱动链接方法请参考[公网地址](https://support.huaweicloud.com/usermanual-cce/cce_10_0141.html#cce_10_0141__section95451728192112)。  - 若下载链接为OBS上的链接，无需绑定EIP 。获取驱动链接方法请参考[OBS地址](https://support.huaweicloud.com/usermanual-cce/cce_10_0141.html#cce_10_0141__section14922133914508)。  - 请确保Nvidia驱动版本与GPU节点适配。配套关系请参见[GPU驱动支持列表]。  - 更改驱动版本后，需要重启节点才能生效。  - 对于Linux 5.x内核系统：Huawei Cloud EulerOS 2.0建议使用470及以上版本驱动；Ubuntu 22.04建议使用515及以上版本驱动。   |
      
   ![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/note_3.0-zh-cn.png)
   插件安装完成后，GPU虚拟化和节点池驱动配置请前往"配置中心 \> 异构资源配置"页进行设置。
   
   
5. （可选）启用DRA模式。 
   您可通过"安装插件"面板中，单击"YAML安装"，修改YAML配置文件中的dra_mode参数为true来启用DRA模式。关于工作负载的具体部署与资源声明方式，请参见[NVIDIA DRA插件安装指导](https://support.huaweicloud.com/bestpractice-cce/cce_bestpractice_10075.html)。
   
   
6. 单击"安装"，安装插件的任务即可提交成功。 
   ![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/note_3.0-zh-cn.png)
   卸载插件将会导致重新调度的GPU Pod无法正常运行，但已运行的GPU Pod不会受到影响。
   
   
 
#### 验证插件
插件安装完成后，在GPU节点及调度了GPU资源的容器中执行nvidia-smi命令，验证GPU设备及驱动的可用性。
- GPU节点：
  - 插件版本为2.0.0以下时，请执行以下命令：
    ```
    cd /opt/cloud/cce/nvidia/bin && ./nvidia-smi
    ```
    
  
  - 插件版本为2.0.0及以上时，请执行以下命令：
    ```
    cd /usr/local/nvidia/bin && ./nvidia-smi
    ```
    
   
- 容器：
  - 当集群版本在1.27及以下时，请执行以下命令：
    ```
    cd /usr/local/nvidia/bin && ./nvidia-smi
    ```
    
  
  - 当集群版本在1.28及以上时，请执行以下命令：
    ```
    cd /usr/bin && ./nvidia-smi
    ```
    
   
若能正常返回GPU信息，说明设备可用，插件安装成功。
![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000001238225460.png "点击放大")
 #### 插件管理
插件安装后，支持升级和回滚操作，您可以根据需求进行选择。CCE AI套件（NVIDIA GPU）插件对版本**升级或回滚** 时，需保证GPU节点上没有GPU虚拟化负载。如果在GPU节点存在GPU虚拟化负载时，对插件版本进行升级或回滚操作，则需要对GPU节点的进行排水，具体操作请参见[CCE AI套件（NVIDIA GPU）插件版本升级或回滚后，如何对GPU节点进行排水](https://support.huaweicloud.com/cce_faq/cce_faq_00488.html)。
#### 插件升级
CCE会定期发布插件新版本，进行特性更新、性能优化和BUG修复。您可以通过[版本记录]了解相关信息，并根据实际需求选择是否进行升级。具体升级步骤如下：
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
2. 在左侧导航栏中选择"插件中心"，在右侧找到CCE AI套件（NVIDIA GPU）插件，并单击"升级"。
3. 在页面上方，单击"插件版本"，选择需要升级的版本。其他参数请按需配置，具体请参见[安装插件]。如果需要修改"集群默认驱动"，则升级完成后需要手动重启GPU节点，具体请参见"GPU驱动升级"小节。
   
   所有参数配置完成后，在右下角单击"确定"。待插件状态由"升级中"变为"运行中"，则说明插件升级成功。
   图2升级插件   
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002244498173.png "点击放大")
   
   
   
 
#### 插件回滚
插件升级版本后，如果出现插件升级失败或者其他特殊情况，您可以将插件回滚至升级前版本。插件回滚后，**节点池的虚拟化配置和驱动配置不会回滚**。插件回滚功能对集群版本和插件版本存在要求，具体如下：
- 集群版本≥v1.28时，仅2.7.35及以上的插件版本支持插件回滚（插件升级前版本必须大于2.7.13）。
- 集群版本≤v1.27时，仅2.1.19及以上的插件版本支持插件回滚（插件升级前版本必须大于2.1.8）。
![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/note_3.0-zh-cn.png)
如果您手动修改了插件启动参数，请在回滚前检查并删除自定义参数，否则回滚后版本可能不支持该参数，从而造成启动失败。
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
2. 在左侧导航栏中选择"插件中心"，在右侧找到CCE AI套件（NVIDIA GPU）插件，并单击"更多 \> 回滚"。
3. 在弹出的"回滚插件"界面中，核对"回滚版本"，无误后单击"是"。待插件状态由"回滚中"变为"运行中"，则说明插件回滚成功。 
   图3插件回滚   
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002209626790.png "点击放大")
   
   
   
 
#### GPU驱动升级
当使用的CUDA库无法与当前的NVIDIA驱动版本匹配时，对应的GPU节点将无法使用，此时需要升级驱动版本。在CCE Standard/Turbo集群支持集群和节点池粒度升级驱动版本，本节主要介绍如何进行集群粒度的驱动版本升级。关于节点池粒度的升级方法，请参见[通过节点池升级节点的GPU驱动版本](https://support.huaweicloud.com/usermanual-cce/cce_10_0849.html)。
升级集群的NVIDIA驱动，本质上是在重启节点的过程中重新安装驱动。因此，在控制台指定集群驱动版本后，需要手动重启对应的GPU节点。具体步骤如下：
1. 指定集群驱动版本。您可以通过三个入口指定集群驱动版本，具体如下： 
   - **升级插件**：在集群左侧导航栏中选择"插件中心"，在右侧找到CCE AI套件（NVIDIA GPU）插件，并单击"升级"。在"升级插件"页面，修改"集群默认驱动"至合适的版本，如535.216.03，在右下角单击"确定"。
   
   - **编辑插件**：在集群左侧导航栏中选择"插件中心"，在右侧找到CCE AI套件（NVIDIA GPU）插件，并单击"编辑"。在"编辑插件"页面，修改"集群默认驱动"至合适的版本，如535.216.03，在右下角单击"确定"。
   
   - **异构资源配置**：在集群左侧导航栏中选择配置中心，切换至异构资源配置页签，修改"集群默认驱动"至合适的版本，如535.216.03，在右下角单击"确认配置"。
   
   
   
   
2. 滚动重启GPU节点，安装指定版本驱动。**重启GPU节点前建议排空节点中的Pod** ，详情请参见[节点排水](https://support.huaweicloud.com/usermanual-cce/cce_10_0605.html)。在对某个GPU节点进行排水时，请在其他节点中预留足够的GPU资源，以满足节点排空过程中的Pod调度需求，防止资源不足导致Pod调度失败，从而影响业务运行。
   
   1. 在集群左侧导航栏中，单击"节点管理"，切换至"节点"页签，查看全部GPU节点。
   
   2. 单击GPU节点名称，跳转到ECS界面，在右上角单击重启。GPU节点完成重启后，需要等待5\~10分钟，等待驱动安装成功。您可以通过CCE AI套件（NVIDIA GPU）插件的状态判断驱动是否安装完成，当插件状态变为"运行中"时，则说明安装完成。
   
   
   
   
3. 登录节点查看节点上实际的驱动版本是否为指定版本，以确认该GPU节点驱动是否升级成功。不同版本的CCE AI套件（NVIDIA GPU）插件使用不同的命令查询驱动，具体如下： 
   - 1.x.x版本执行命令为：
     ```
     /opt/cloud/cce/nvidia/bin/nvidia-smi
     ```
     
   
   - 2.0.0-2.5.3版本执行命令为：
     ```
     /usr/local/nvidia/bin/nvidia-smi
     ```
     
   
   - 2.5.4以上版本执行命令为：
     ```
     nvidia-smi
     ```
     
   
   
   回显结果如下，节点上驱动版本为535.216.03，与指定驱动版本一致，则说明升级成功。
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002239209248.png "点击放大")
   确认节点及业务运行正常后，请按照以上步骤依次重启集群内的其他GPU节点。
   
   
 
 #### GPU驱动支持列表
![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/notice_3.0-zh-cn.png)
- 当前GPU驱动支持列表仅针对1.2.28及以上版本的CCE AI套件（NVIDIA GPU）插件。
- 如果您需要安装最新版本的GPU驱动，请将您的CCE AI套件（NVIDIA GPU）插件升级到最新版本。
- [表3 GPU驱动支持列表]中列出的操作系统、GPU驱动及GPU卡型号为经测试验证的兼容范围。为确保最佳性能与稳定性，建议在此范围内进行部署。在未验证环境进行部署时，请根据自身环境进行充分测试，以确保最终兼容性和稳定性。
- 对于已结束生命周期（EOL）的GPU驱动，NVIDIA官方将不再提供功能更新或安全补丁等服务，具体请参见[驱动生命周期](https://docs.nvidia.com/datacenter/tesla/drivers/#driver-lifecycle)。例如，Production Branch从发布之日起提供1年的支持，LTSB（Long Term Support Branch）提供3年的长期支持**。**
  对应该策略，对于已EOL的GPU驱动，CCE将不再提供相应的技术支持，包含驱动的安装、更新等服务。**目前，已EOL的驱动包括：510.47.03、470.141.03、470.57.02**。
  
- 在Ubuntu和CentOS系统上安装GPU驱动时，需要注意操作系统的版本号，具体请参见[表3]。更多信息，请参见[NVIDIA Data Center GPU Driver Documentation](https://docs.nvidia.com/datacenter/tesla/)。
 
 表2GPU驱动支持列表 
| **GPU型号**   | **机型规格**                                                             | 操作系统                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         ||||||||
| **GPU型号**   | **机型规格**                                                             | Huawei Cloud EulerOS 3.0 | Huawei Cloud EulerOS 2.0                                                                                                                                                                                                                                      | Ubuntu 22.04                                                                                                                                                                              | CentOS Linux release 7.6                                                                                                                                                                                        | EulerOS release 2.9                             | EulerOS release 2.5                               | Ubuntu 18.04（停止维护） | EulerOS release 2.3（停止维护） |
|:---|:---|:---|:---|:---|:---|:---|:---|:---|:---|
| Tesla T4   | g6 pi2                                  | 570.86.15                  | 580.126.20 570.86.15 535.216.03 535.161.08 535.54.03 510.47.03 470.57.02       | 580.126.20 570.86.15 535.216.03 535.161.08 535.54.03               | 535.216.03 535.161.08 535.54.03 510.47.03 470.141.03 470.57.02 | 535.54.03 470.141.03 | 535.54.03 470.141.03   | 470.141.03        | 470.141.03                 |
| Tesla V100 | p2s p2vs p2v | 570.86.15                  | 580.126.20 570.86.15 535.216.03 535.161.08 535.54.03 510.47.03 470.57.02 | 580.126.20 570.86.15 535.216.03 535.161.08 535.54.03  | 535.216.03 535.161.08 535.54.03 510.47.03 470.141.03 470.57.02 | 535.54.03 470.141.03     | 535.54.03 470.141.03 | 470.141.03       | 470.141.03                 |
   
 表3GPU驱动与操作系统版本号的对应关系 
| 驱动版本                                                                                                                       | Ubuntu 22.04                    | CentOS Linux release 7.6 | Ubuntu 18.04（停止维护）              |
|:---|:---|:---|:---|
| [570.86.15](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-570-86-15/index.html#hardware-software-support)    | Ubuntu 22.04.z LTS (where z≤5) | 不支持                       | 不支持                            |
| [535.216.03](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-535-216-03/index.html#hardware-software-support)   | Ubuntu 22.04.z LTS (where z≤4) | CentOS 7.y (where y≤9)  | 不支持                             |
| [535.161.08](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-535-161-08/index.html#hardware-software-support) | Ubuntu 22.04.z LTS (where z≤3)   | CentOS 7.y (where y≤9)  | 不支持                            |
| [535.54.03](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-535-54-03/index.html#hardware-software-support)      | Ubuntu 22.04.z LTS (where z≤2) | CentOS 7.y (where y≤9)    | 不支持                           |
| [510.47.03](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-510-47-03/index.html#hardware-software-support)    | 不支持                               | CentOS 7.y (where y≤9)  | Ubuntu 18.04.z LTS (where z≤6)  |
| [470.141.03](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-470-141-03/index.html#hardware-software-support)     | 不支持                            | CentOS 7.y (where y≤9)  | Ubuntu 18.04.z LTS (where z≤6)  |
| [470.57.02](https://docs.nvidia.com/datacenter/tesla/tesla-release-notes-470-57-02/index.html#hardware-software-support)    | 不支持                            | CentOS 7.y (where y≤9)   | Ubuntu 18.04.z LTS (where z≤5) |
   
#### 获取驱动链接
当需要使用自定义驱动链接地址安装驱动时，CCE AI套件（NVIDIA GPU）插件支持两种类型的地址，即公网地址和OBS地址。具体获取方式如下：
- [公网地址]
  
  1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
  
  2. 创建节点，在"节点规格"处选择要创建的GPU节点，选中后下方显示的信息中可以看到节点的GPU显卡型号。 
     图4查看显卡型号   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002168811733.png "点击放大")
     
     
     
  
  
  
  3. 登录到[NVIDIA驱动下载](https://www.nvidia.com/en-us/drivers/)页面，搜索对应的驱动信息，其中操作系统必须选**Linux 64-bit** 。
     
     图5参数选择   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002133502512.png "点击放大")
     
     
  
  4. 驱动信息确认完毕，单击"Find"按钮，会跳转到驱动信息展示页面，找到需要下载的驱动，单击"view"跳转到下载页面。 
     图6驱动信息   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002133709902.png "点击放大")
     
     
  
  5. 鼠标右键单击"Download"按钮，复制下载链接。 
     图7获取链接   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002133717390.png "点击放大")
     
     
   
- [OBS地址]
  
  1. 将驱动上传到对象存储服务OBS中，并将驱动文件设置为公共读，方法请参见[上传文件](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829661.html)。
     
     ![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/note_3.0-zh-cn.png)
     节点重启时会重新下载驱动进行安装，请保证驱动的OBS桶链接长期有效。
     
     
  
  2. 在桶列表单击待操作的桶，进入"对象"页面。
  
  3. 单击目标对象名称，在基本信息页复制驱动链接。 
     图8复制OBS链接   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002499128888.png "点击放大")
     
     
     
   
#### 组件说明
表4CCE AI套件（NVIDIA GPU）插件组件 
| 容器组件                    | 说明                                             | 资源类型      |
|:---|:---|:---|
| nvidia-driver-installer  | 为节点安装Nvidia GPU驱动的工作负载，仅在安装场景占用资源，安装完成后无资源占用。 | DaemonSet  |
| nvidia-gpu-device-plugin | 为容器提供Nvidia GPU异构算力的Kubernetes设备插件。              | DaemonSet  |
| nvidia-operator          | 为集群提供Nvidia GPU节点管理能力。                        | Deployment |
| dcgm-exporter              | 启用dcgm-exporter组件进行DCGM指标观测时安装，用于采集GPU指标。     | DaemonSet |
   
#### 相关链接
- CCE AI套件（NVIDIA GPU）插件提供GPU监控指标，关于GPU指标详情请参见[GPU监控指标说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0955.html)。
- 启用dcgm-exporter组件后，如果需要将采集的GPU监控数据上报至AOM服务，请参见[实现DCGM指标的全面监控](https://support.huaweicloud.com/usermanual-cce/cce_10_0956.html)。
- 如果需要进一步实现GPU虚拟化功能，请参见[GPU虚拟化](https://support.huaweicloud.com/usermanual-cce/cce_10_0643.html)。
 
 #### 版本记录
表5CCE AI套件（NVIDIA GPU）版本记录 
| 插件版本    | 支持的集群版本                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 更新特性                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| 2.16.2   | v1.29 v1.30 v1.31 v1.32 v1.33 v1.34 v1.35 v1.36   | 兼容问题修复                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 2.16.1    | v1.29 v1.30 v1.31 v1.32 v1.33 v1.34 v1.35 v1.36 | 支持CCE v1.36集群                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 2.15.6  | v1.29 v1.30 v1.31 v1.32 v1.33 v1.34 v1.35                                                                 | 新增NVIDIA驱动版本580.126.20                                                                                                                                                                                                                                                                                                                                                                                                           |
| 2.14.4     | v1.29 v1.30 v1.31 v1.32 v1.33 v1.34 v1.35                                                                | 支持CCE v1.35集群                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 2.13.3  | v1.28 v1.29 v1.30 v1.31 v1.32 v1.33 v1.34                                                               | 兼容问题修复                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.12.0   | v1.28 v1.29 v1.30 v1.31 v1.32 v1.33 v1.34                                                                 | 兼容问题修复                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 2.11.1   | v1.28 v1.29 v1.30 v1.31 v1.32 v1.33 v1.34                                                              | 支持CCE v1.34集群                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 2.10.3  | v1.28 v1.29 v1.30 v1.31 v1.32 v1.33                                                                                                                                       | 修复部分问题                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 2.10.2  | v1.28 v1.29 v1.30 v1.31 v1.32 v1.33                                                                                                                                           | 新增NVIDIA驱动版本570.86.15。                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.8.4    | v1.28 v1.29 v1.30 v1.31 v1.32                                                                                                                                                                                                  | 修复[CVE-2025-23266](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2025-23266)、[CVE-2025-23267](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2025-23267)漏洞                                                                                                                                                                                                                                                                  |
| 2.8.1    | v1.28 v1.29 v1.30 v1.31 v1.32                                                                                                                                                                                                 | 修复部分问题                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.7.84    | v1.28 v1.29 v1.30 v1.31 v1.32                                                                                                                                                                                                          | 支持CCE v1.32集群                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 2.7.66    | v1.28 v1.29 v1.30 v1.31                                                                                                                                                                                                                                                                               | 修复部分问题                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.7.63    | v1.28 v1.29 v1.30 v1.31                                                                                                                                                                                                                                                                      | 修复安全漏洞                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 2.7.47 | v1.28 v1.29 v1.30 v1.31                                                                                                                                                                                                                                                                       | 新增NVIDIA 535.216.03驱动，支持XGPU特性                                                                                                                                                                                                                                                                                                                                                                                                    |
| 2.7.42  | v1.28 v1.29 v1.30 v1.31                                                                                                                                                                                                                                                                     | 新增NVIDIA 535.216.03驱动，支持XGPU特性                                                                                                                                                                                                                                                                                                                                                                                                     |
| 2.7.41    | v1.28 v1.29 v1.30 v1.31                                                                                                                                                                                                                                                                    | 新增NVIDIA 535.216.03驱动，支持XGPU特性                                                                                                                                                                                                                                                                                                                                                                                                     |
| 2.7.40   | v1.28 v1.29 v1.30 v1.31                                                                                                                                                                                                                                                                    | 集成DCGM-Exporter，为集群提供Nvidia GPU节点DCGM指标观测能力                                                                                                                                                                                                                                                                                                                                                                                         |
| 2.7.19    | v1.28 v1.29 v1.30                                                                                                                                                                                                                                                                                                                                  | 修复nvidia-container-toolkit CVE-2024-0132容器逃逸漏洞                                                                                                                                                                                                                                                                                                                                                                                    |
| 2.7.13   | v1.28 v1.29 v1.30                                                                                                                                                                                                                                                                                                                                     | - 支持节点池粒度配置XGPU  - 支持GPU渲染场景  - 支持v1.30集群              |
| 2.6.4      | v1.28 v1.29                                                                                                                                                                                                                                                                                                                                                                                                       | 更新GPU卡逻辑隔离逻辑                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 2.6.1     | v1.28 v1.29                                                                                                                                                                                                                                                                                                                                                                                                      | 升级GPU插件基础镜像                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 2.5.6  | v1.28                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 修复安装驱动的问题                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 2.5.4     | v1.28                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 支持v1.28集群                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 2.2.4    | v1.25 v1.27                                                                                                                                                                                                                                                                                                                                                                                                     | 修复[CVE-2025-23266](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2025-23266)、[CVE-2025-23267](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2025-23267)漏洞                                                                                                                                                                                                                                                                 |
| 2.2.1    | v1.25 v1.27                                                                                                                                                                                                                                                                                                                                                                                                         | 修复部分问题                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.1.67    | v1.25 v1.27                                                                                                                                                                                                                                                                                                                                                                                                      | 支持NVIDIA peermem模块                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 2.1.49   | v1.25 v1.27                                                                                                                                                                                                                                                                                                                                                                                                      | 新增NVIDIA 535.216.03驱动，支持XGPU特性                                                                                                                                                                                                                                                                                                                                                                                                     |
| 2.1.47 | v1.25 v1.27                                                                                                                                                                                                                                                                                                                                                                                                    | 新增NVIDIA 535.216.03驱动，支持XGPU特性                                                                                                                                                                                                                                                                                                                                                                                                     |
| 2.1.26  | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                   |  新增NVIDIA 535.216.03驱动，支持XGPU特性                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.1.14    | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                       | 修复nvidia-container-toolkit CVE-2024-0132容器逃逸漏洞                                                                                                                                                                                                                                                                                                                                                                                     |
| 2.1.8    | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                     | 修复部分问题                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 2.0.72   | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                   | 更新GPU卡逻辑隔离逻辑                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 2.0.69  | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                   | 升级GPU插件基础镜像                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 2.0.48   | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                  | 修复安装驱动的问题                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 2.0.46 | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                   | - 支持535版本Nvidia驱动  - 支持非root用户使用XGPU  - 优化启动逻辑   |
| 2.0.44 | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                   | - 支持535版本Nvidia驱动  - 支持非root用户使用XGPU  - 优化启动逻辑                |
| 2.0.18    | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                       | 支持Huawei Cloud EulerOS 2.0                                                                                                                                                                                                                                                                                                                                                                                                          |
| 2.0.17     | v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                                                                                           | RollingUpdate参数配置优化                                                                                                                                                                                                                                                                                                                                                                                                                |
| 2.0.14  | v1.19 v1.21 v1.23 v1.25 v1.27                                                                                                                                                                                                    | - 支持xGPU设备监控  - 支持nvidia.com/gpu与volcano.sh/gpu-\* api兼容                                                                                                                              |
| 2.0.5   | v1.19 v1.21 v1.23 v1.25                                                                                                                                                                                                                                                                   | -                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2.0.0    | v1.19 v1.21 v1.23 v1.25                                                                                                                                                                                                                                                                   | - 支持GPU虚拟化  - 驱动安装目录更新至节点/usr/local/nvidia                                                                                                                                       |
| 1.2.28   | v1.19 v1.21 v1.23 v1.25                                                                                                                                                                                                                                                                      | - 适配OS Ubuntu22.04  - GPU驱动目录自动挂载优化                                                                                                                                                  |
| 1.2.24    | v1.19 v1.21 v1.23 v1.25                                                                                                                                                                                                                                                                   | - 节点池支持配置GPU驱动版本  - 支持GPU指标采集                                                                                                                                                                |
| 1.2.20      | v1.19 v1.21 v1.23 v1.25                                                                                                                                                                                                                                                                      | 设置插件别名为gpu                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.2.17     | v1.15 v1.17 v1.19 v1.21 v1.23                                                                                                                                                                                                 | 增加nvidia-driver-install pod limits 配置                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.2.15    | v1.15 v1.17 v1.19 v1.21 v1.23                                                                                                                                                                                              | 适配CCE v1.23集群                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.2.11    | v1.15 v1.17 v1.19 v1.21                                                                                                                                                                                                                                                                  | 支持EulerOS 2.10系统                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.2.10     | v1.15 v1.17 v1.19 v1.21                                                                                                                                                                                                                                                                     | CentOS系统支持新版本GPU驱动                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.2.9     | v1.15 v1.17 v1.19 v1.21                                                                                                                                                                                                                                                                      | 适配CCE v1.21集群                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.2.2   | v1.15 v1.17 v1.19                                                                                                                                                                                                                                                                                                                                          | 适配EulerOS新内核                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.2.1     | v1.15 v1.17 v1.19                                                                                                                                                                                                                                                                                                                                       | - 适配CCE v1.19集群  - 插件增加污点容忍                                                                                                                                                               |
| 1.1.13  | v1.13 v1.15 v1.17                                                                                                                                                                                                                                                                                                                                    | 支持Centos7.6 3.10.0-1127.19.1.el7.x86_64内核系统                                                                                                                                                                                                                                                                                                                                                                                        |
| 1.1.11   | v1.15 v1.17                                                                                                                                                                                                                                                                                                                                                                                                         | - 支持用户自定义驱动地址下载驱动  - 支持v1.15、v1.17集群                                                                                                                                                      |
   
