Antes de instalar um driver NVIDIA em um nó, verifique se a versão consta na lista de versões suportadas pelo ACK. Este tópico lista as versões de drivers NVIDIA compatíveis.
CUDA
O CUDA é uma plataforma de computação paralela e um modelo de programação da NVIDIA que utiliza GPUs para acelerar o desempenho computacional.
A figura a seguir ilustra a arquitetura CUDA. A Driver API e a Runtime API diferem da seguinte forma:
Driver API: Oferece mais recursos, mas apresenta maior complexidade.
Runtime API: Encapsula as funções da Driver API e oculta detalhes de inicialização para simplificar o uso.
O pacote NVIDIA Driver fornece a CUDA Driver API, enquanto o pacote CUDA Toolkit fornece a CUDA Library e a CUDA Runtime.

Compatibilidade entre driver e versão do cluster
Escolha e manutenção das versões de driver
O ACK atualiza periodicamente a versão padrão do driver. Portanto, novos nós GPU adicionados por dimensionamento podem usar uma versão diferente. Para evitar isso, especifique uma versão de driver para o pool de nós.
Caso a versão especificada do driver não esteja listada em Compatibilidade entre driver e versão do kernel do SO, o ACK instala a versão padrão. Se você especificar uma versão incompatível com o SO mais recente, a adição do nó poderá falhar. Selecione a versão mais recente do driver suportada.
Após uma atualização do kernel do SO, o driver da GPU pode ficar indisponível. Remova o nó do pool de nós e adicione-o novamente (o que reinsere automaticamente o nó existente) ou atualize manualmente o driver da GPU em um nó.
Se você personalizar a versão do driver da GPU especificando um número de versão ou usar uma URL do OSS, o SO e o driver podem tornar-se incompatíveis após a atualização. Consulte Versões de drivers NVIDIA suportadas no ACK para selecionar um driver compatível.
Problemas conhecidos em versões específicas de driver
Drivers da versão 510 e posteriores podem causar erros XID 119 ou XID 120 ocasionalmente. 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 de 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 complemento de monitoramento, certifique-se de que o ack-arms-prometheus seja da versão 1.1.33 ou superior e o ack-gpu-exporter seja da versão 2.3.0 ou superior.
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 mais antigas podem causar desconexões frequentes do dispositivo GPU. Sintomas:O comando
nvidia-smirelata menos GPUs do que as fisicamente instaladas ou exibeNo devices were found.O comando
lspci | grep -i nvidiaainda detecta o dispositivo, mas seu status mostra[rev b0].
Para tipos de instância com GPU L20N (
ecs.ebmgn9g,ecs.ebmgn9gceecs.ebmgn9ge), é obrigatório usar a versão 580 ou superior do driver GPU.
A tabela a seguir lista as versões de drivers NVIDIA GPU suportadas por cada versão de cluster ACK.
Para clusters ACK Lingjun e nós Lingjun em clusters ACK managed Pro, os drivers GPU estão integrados à imagem do SO. Não há suporte para a instalação de uma versão específica do driver GPU via rótulo de nó. Pools de nós de borda em clusters ACK Edge também não suportam a instalação de uma versão específica do driver GPU por meio de rótulos de nó.
Versão do cluster | Versão padrão do driver | Suporte a driver personalizado | Versões de driver suportadas |
1.28 e posteriores | 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 de versão do kernel e ID de imagem abaixo para 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 suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa não suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
580.126.09 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa não suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
570.195.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa não suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
570.169 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa não suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
570.133.20 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa não suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
550.163.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
550.144.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
550.90.07 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
550.54.15 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
550.54.14 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
535.247.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
535.230.02 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
535.161.07 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
535.129.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
535,98 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
535.54.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
525.147.05 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
525.105.17 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
515.105.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
515.86.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
510.108.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
510,54 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
510.47.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
470.256.02 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, ∞) |
470.161.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-17.3.al8.x86_64] Faixa não suportada: [5.10.134-18.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
470.103.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
470.82.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
470.57.02 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
460.106.00 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa suportada: [5.15.0-40-generic, 5.15.0-101-generic] Faixa não suportada: [5.15.0-106-generic, ∞) |
460.91.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
460.73.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
460.32.03 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
450.119.04 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
450.102.04 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa suportada: [5.10.23-5.al8.x86_64, 5.10.134-14.al8.x86_64] Faixa não suportada: [5.10.134-15.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
450.80.02 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
440.33.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
418.181.07 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
418.113 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
418.87.01 | Faixa suportada: [4.19.81-17.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
410,93 | Faixa suportada: [4.19.81-17.1.al7.x86_64, 4.19.91-18.al7.x86_64] Faixa não suportada: [4.19.91-19.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, 3.10.0-957.21.3.el7.x86_64] Faixa não suportada: [3.10.0-1062.9.1.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
410,79 | Faixa suportada: [4.19.81-17.1.al7.x86_64, 4.19.91-18.al7.x86_64] Faixa não suportada: [4.19.91-19.1.al7.x86_64, ∞) | Faixa não suportada: [5.10.23-5.al8.x86_64, ∞) | Faixa suportada: [3.10.0-862.14.4.el7.x86_64, 3.10.0-957.21.3.el7.x86_64] Faixa não suportada: [3.10.0-1062.9.1.el7.x86_64, ∞) | Faixa não suportada: [5.15.0-40-generic, ∞) |
Compatibilidade entre driver e CUDA Toolkit
Selecione uma versão de driver compatível com a versão do CUDA Toolkit da sua aplicação. Consulte as Notas de Lançamento do CUDA Toolkit para acessar a matriz de compatibilidade.
Verificando 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 a versão CUDA 12.6 indica que o driver suporta a CUDA Runtime API até a versão 12.6.
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 oficiais com o CUDA Toolkit pré-instalado. Crie a imagem da sua aplicação com base em uma imagem base correspondente à versão do toolkit exigida pela sua aplicação.
A imagem base CUDA da sua imagem docker determina a versão da CUDA Runtime API disponível para sua aplicação. Por exemplo, criar uma imagem baseada em NVIDIA/CUDA:12.2.0-base-Ubuntu20.04 significa que a aplicação usará a versão 12.2.0 da CUDA Runtime API.