容器服务
容器服务
文档指南
请输入
- 文档首页
容器服务容器服务 VKE用户指南异构计算NVIDIA GPU自动安装 GPU 驱动
复制全文
下载 pdf自动安装 GPU 驱动
文档反馈
问问助手容器服务为 NVIDIA GPU 节点池提供自动安装 GPU 驱动功能，允许基于公共镜像创建的节点自动安装指定的 GPU 驱动。本文为您介绍如何为 GPU 节点自动安装 GPU 驱动。
背景信息
容器服务为您提供了预置 GPU 驱动的系统镜像。创建节点池时，您可以直接选择预置的镜像，为节点安装基础镜像和 GPU 驱动。如果系统预置 GPU 驱动的系统镜像无法满足您的要求，您也可以通过节点池 Label 或控制台，自主选择 GPU 驱动版本。
批量安装建议
如果您需要为集群中的节点批量安装 GPU 驱动，推荐先通过 后台自动安装驱动 功能在少量节点上完成驱动安装，再基于这些节点制作自定义镜像，最后使用该镜像批量扩容节点。这样可以避免每台节点重复下载安装驱动，显著缩短批量扩容耗时。
- 创建或编辑节点池，开启 后台自动安装驱动 功能，并选择指定的 GPU 驱动版本。操作详情请参见下文 操作步骤。
- 在该节点池中扩容 1 台节点，完成指定 GPU 驱动的安装。
- 参考 基于 ECS 制作自定义镜像，使用已完成 GPU 驱动安装节点对应的 ECS 实例，创建包含 GPU 驱动的自定义镜像。
- 使用自定义镜像批量扩容节点（此时无需开启 后台自动安装驱动 功能），完成节点批量安装 GPU 驱动。
注意
- 如果您在 GPU 驱动未完成安装前停止或重启实例，导致安装中断，启动后的实例不带 GPU 驱动，且不再继续安装。
- 自动安装 GPU 驱动过程中，会下载驱动安装包，建议系统盘容量不小于 40 GB，避免由于磁盘空间不足造成安装失败。
使用控制台指定 GPU 驱动
配置节点池时，支持选择基础系统镜像（veLinux、Ubuntu）时，通过控制台选择 GPU 驱动版本。当前 VKE 支持的 GPU 驱动、公共镜像和 GPU 实例规格族的对应关系，如下表所示。
说明
- 不同计算规格支持选择的驱动版本会定期更新，如与控制台有差异，请以控制台为准。
- 支持使用 ListSupportedGpuDriverVersions 接口，获取指定系统镜像支持安装的 GPU 驱动版本。
GPU 驱动 | 公共镜像 | GPU 实例规格族 |
580.105.08 | Ubuntu 22.04 |
|
| |
|
570.86.15 | Ubuntu 22.04 |
|
| |
|
550.144.03 | Ubuntu 22.04 |
|
| |
|
| |
|
550.127.05 | veLinux 1.0 |
|
| |
|
| |
|
535.261.03 |
|
|
| |
|
| |
|
使用 Label 指定 GPU 驱动
配置节点池时，支持通过标签 vke.volcengine.com/nvidia-driver-version 选择 GPU 驱动版本，支持通过标签选择的驱动版本如下：
- 470.161.03
- 535.129.03
- 535.183.06
说明
使用节点池标签添加上述 GPU 版本时，节点配置需要注意以下情况：
- 系统镜像：目前仅支持公共镜像中的 veLinux 标准版和 Ubuntu。
- 计算规格：目前仅支持使用高性能计算 GPU 型或部分 GPU 计算型（不包括 vws 结尾的 GPU 渲染型）规格族。
使用限制
- 免责声明：此功能无法保证所有驱动在所有卡型下可用，因此，需要自行保证选择的 GPU 驱动版本与 GPU 型号匹配，并进行充分测试，否则可能导致性能降低或存在未知风险。
- VKE 不保证提供的 GPU 驱动版本与所有 GPU 卡型的兼容性，您需要自行验证两者之间的适配性。更多详情，请参考 NVIDIA 官方文档。
- VKE 不保证提供的 GPU 驱动版本与业务应用的兼容性（即 GPU 驱动版本与 CUDA 库版本的兼容性），您需要自行验证两者之间的适配性。
- VKE 不保证提供的 GPU 驱动版本与 VKE 其他 GPU 组件的兼容性（例如：监控组件等）。
- 目前仅支持部分 GPU 驱动版本，若不满足实际使用场景，可自定义安装 GPU 驱动，更多详细介绍参见 自定义安装 GPU 驱动。
注意事项
通过配置节点池时指定 GPU 驱动信息，仅当节点添加到节点池时，才会根据节点池中的配置信息识别并触发驱动安装。常见使用场景如下：
- 新建节点池场景，所有节点均属于新添加到节点池的节点，均能够根据节点池中的节点标签识别并触发驱动安装，推荐此方式使用自定义 GPU 驱动功能。
- 针对已有节点池中的新增节点，依然属于新添加到节点池的节点，能够根据节点池中的节点标签识别并触发驱动安装。
- 针对已有节点池中的存量节点，不属于新添加到节点池中的节点，无法根据节点池中的节点标签识别并触发驱动安装。参考解决方案如下：
- 方案一：确保不影响业务正常运行的前提下手动移除存量节点，并通过添加已有节点方式重新添加。
- 方案二：确保不影响业务正常运行的前提下使用节点扩缩容功能将存量节点全部缩容，然后重新扩容节点。
操作步骤
本文以创建节点池为例，介绍如何在配置节点池时指定节点的 GPU 驱动。
- 登录 容器服务控制台。
- 在左侧导航栏选择 集群，单击目标集群名称，进入集群管理页面。
- 在左侧导航栏选择 节点池，进入节点池管理页面。
- 单击 创建节点池 或已有节点池右侧操作列的 编辑，完成镜像和驱动配置。
- 在 操作系统配置 中选择 公共镜像，本文以 veLinux 1.0 为例。
- 勾选 后台自动安装驱动，并在下拉菜单中，选择需要安装的 GPU 驱动版本。
-
- 单击 确定，完成配置。
警告
- 该方式仅限于安装 470.161.03、535.129.03 和 535.183.06 版本的驱动。
- 务必确保使用的驱动版本在 GPU 卡型支持的范围内，若超出卡型支持范围，将因 GPU 驱动无法安装，导致节点扩容失败。
- 登录 容器服务控制台。
- 在左侧导航栏选择 集群，单击目标集群名称，进入集群管理页面。
- 在左侧导航栏选择 节点池，进入节点池管理页面。
- 单击 创建节点池 或已有节点池右侧操作列的 编辑，在 更多配置 中为节点池添加节点标签 vke.volcengine.com/nvidia-driver-version，标签值为 GPU 驱动版本号，本文以535.183.06为例。节点池的其他参数配置，请参见 创建托管节点池。
-
- 单击 确定，完成配置。
结果验证
- 使用 ECS Terminal 登录节点。详情请参见 ECS Terminal。
- 执行以下命令，查看 GPU 相关信息。
-
- 预期结果如下，Driver Version与节点池中配置的驱动版本号一致，本例中为 535.183.06，表示自动安装 NVIDIA 驱动成功。
-
相关文档
最近更新时间：2026.06.01 13:45:29
这个页面对您有帮助吗？
有用
有用
无用
无用