Antes de instalar um driver NVIDIA em um nó, verifique se a versão consta na lista de compatibilidade do ACK. Este tópico apresenta as versões de driver NVIDIA compatíveis.
CUDA
CUDA é uma plataforma de computação paralela e modelo de programação da NVIDIA que utiliza GPUs para acelerar o desempenho computacional.
A figura a seguir ilustra a arquitetura CUDA. As diferenças entre a Driver API e a Runtime API são:
Driver API: oferece mais recursos, porém é mais complexa.
Runtime API: encapsula funções da Driver API e oculta detalhes de inicialização, simplificando o uso.
O pacote NVIDIA Driver fornece a CUDA Driver API, enquanto o pacote CUDA Toolkit fornece a CUDA Library e o CUDA Runtime.
Compatibilidade entre driver e versão do cluster
Escolha e manutenção de versões de driver
O ACK atualiza periodicamente a versão padrão do driver, de modo que nós GPU recém-escalados podem receber uma versão diferente. Para evitar isso, especifique uma versão de driver para o node pool.
Se a versão de driver especificada não constar em Compatibilidade entre driver e versão do kernel do SO, o ACK instala a versão padrão. Caso você especifique uma versão incompatível com o SO mais recente, a adição do nó pode falhar. Selecione a versão de driver compatível mais recente.
Após uma atualização do kernel do SO, o driver GPU pode ficar indisponível. Remova o nó do node pool e adicione-o novamente (o que readiciona automaticamente o nó existente), ou atualize manualmente o driver GPU em um nó.
Ao personalizar a versão do driver GPU especificando um número de versão ou usando uma URL do OSS, o SO e o driver podem se tornar incompatíveis após a atualização. Consulte Versões de driver NVIDIA compatíveis com o ACK para escolher um driver compatível.
Problemas conhecidos em versões específicas de driver
Drivers da versão 510 em diante podem ocasionalmente gerar erros XID 119 ou XID 120. Se isso ocorrer, consulte Solucionar falhas de GPU causadas por erros XID 119 ou XID 120.
A versão 550 do driver resolve problemas como erros frequentes XID 119, 120 e 31, além de kernel panics em determinadas aplicações. Recomendamos atualizar os nós GPU existentes para a versão 550 do driver.
Ao utilizar um driver da série 570 ou posterior com o add-on de monitoramento, certifique-se de que o ack-arms-prometheus esteja na versão 1.1.33 ou posterior e o ack-gpu-exporter esteja na versão 2.3.0 ou posterior.
Requisitos de driver para tipos de instância específicos
-
Para a família de instâncias
gn9t, não utilize versões de driver anteriores à 570.153.02. Versões anteriores podem causar desconexões frequentes do dispositivo GPU. Sintomas:O comando
nvidia-smireporta menos GPUs do que as fisicamente instaladas, ou exibeNo devices were found.O comando
lspci | grep -i nvidiaainda detecta o dispositivo, mas o status exibe[rev b0].
Para tipos de instância GPU L20N (
ecs.ebmgn9g,ecs.ebmgn9gceecs.ebmgn9ge), é necessário utilizar a versão 580 ou posterior do driver GPU.
A tabela a seguir lista as versões de driver GPU NVIDIA compatíveis com cada versão de cluster ACK.
Para clusters ACK Lingjun e nós Lingjun em clusters ACK managed Pro, os drivers GPU são integrados à imagem do SO. A instalação de uma versão específica de driver GPU por rótulo de nó não é suportada. Node pools de borda em ACK Edge cluster s também não suportam a instalação de uma versão específica de driver GPU por rótulos de nó.
Versão do cluster | Versão padrão do driver | Suporte a driver personalizado | Versões de driver compatíveis |
1.28 e posterior | 535.161.07 570.169 (para tipos de instância ecs.gn9t e ecs.ebmgn9t) | Sim |
As seguintes versões de driver são incompatíveis com os sistemas operacionais mais recentes.
|
1.26 | Sim | ||
1.24 | Sim | ||
1.22 | Sim | ||
1.20 | Sim |
| |
1.18.8 | 418.181.07 | Sim | |
1.16.9 | 418.181.07 | Sim | |
1.16.6 | 418.87.01 | Não | |
1.14.8 | 418.181.07 | Sim |
Compatibilidade entre driver e GPU
Compatibilidade entre driver e versão do kernel do SO
Consulte a tabela de mapeamento entre versão do kernel e ID de imagem abaixo para verificar os mapeamentos de kernel para ID de imagem.
Versão do driver | Alibaba Cloud Linux 2 | Alibaba Cloud Linux 3 | CentOS 7 | Ubuntu 22.04 |
580.126.20 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa não compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
580.126.09 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa não compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
570.195.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa não compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
570.169 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa não compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
570.133.20 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa não compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
550.163.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
550.144.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
550.90.07 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
550.54.15 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
550.54.14 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
535.247.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
535.230.02 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
535.161.07 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
535.129.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
535.98 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
535.54.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
525.147.05 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
525.105.17 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
515.105.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
515.86.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
510.108.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
510.54 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
510.47.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
470.256.02 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, ∞) |
470.161.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não compatível: [5.10.134-18.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
470.103.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
470.82.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
470.57.02 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não compatível: [5.15.0-40-generic, ∞) |
460.106.00 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa compatível: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não compatível: [5.15.0-106-generic, ∞) |
460.91.03 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não compatível: [5.15.0-40-generic, ∞) |
460.73.01 | Faixa compatível: [4.19.81-17.1.al7.x86_64, ∞) | Faixa compatível: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não compatível: [5.10.134-15.al8.x86_64, ∞) | Faixa compatível: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não compatível: [5.15.0-40 ## Compatibilidade entre driver e CUDA Toolkit Selecione uma versão de driver compatível com a versão do CUDA Toolkit utilizada pela sua aplicação. Consulte as [CUDA Toolkit Release Notes](https://docs.nvidia.com/cuda/cuda-toolkit-release-notes/index.html?spm=a2c4g.207292.0.0.62f2778erY9RgV) para verificar a matriz de compatibilidade. ## **Verificar** a **versão** da CUDA Driver API Execute o comando `nvidia-smi` em um nó para verificar a versão do driver instalado e a versão da CUDA Driver API. Na saída a seguir, 550.144.03 é a versão do driver, e CUDA version 12.6 indica que o driver suporta a CUDA Runtime API até a versão 12.6. ```bash Mon Mar 24 08:51:55 2025 +-----------------------------------------------------------------------------------------+ | NVIDIA-SMI 550.144.03 Driver Version: 550.144.03 CUDA Version: 12.6 | |-----------------------------------------+------------------------+----------------------+ | GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. | | | | MIG M. | |=========================================+========================+======================| | 0 Tesla P4 On | 00000000:00:07.0 Off | 0 | | N/A 33C P8 7W / 75W | 0MiB / 7680MiB | 0% Default | | | | N/A | +-----------------------------------------+------------------------+----------------------+ +-----------------------------------------------------------------------------------------+ | Processes: | | GPU GI CI PID Type Process name GPU Memory | | ID ID Usage | |=========================================================================================| | No running processes found | +-----------------------------------------------------------------------------------------+ ``` ## Versão da Runtime API A NVIDIA fornece [imagens base CUDA](https://hub.docker.com/r/nvidia/cuda) oficiais com o CUDA Toolkit pré-instalado. Construa a imagem da sua aplicação com base em uma imagem que corresponda à versão do toolkit exigida pela aplicação. A imagem base CUDA da sua imagem Docker determina a versão da CUDA Runtime API disponível para a aplicação. Por exemplo, ao construir com base em `NVIDIA/CUDA:12.2.0-base-Ubuntu20.04`, a aplicação utiliza a CUDA Runtime API versão 12.2.0. ## **Referências** |