Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Especifique uma versão personalizada de driver GPU para um nó

Última atualização: Jun 27, 2026

O ACK instala uma versão padrão do driver NVIDIA para cada tipo de cluster. Se essa versão for incompatível com sua biblioteca CUDA, defina um rótulo no pool de nós para fixar uma versão específica do driver em novos nós GPU.

Pré-requisitos

Verifique se você tem:

Limitações

Compatibilidade de drivers

O ACK não garante compatibilidade entre versões de drivers e da biblioteca CUDA. Para obter os requisitos detalhados de versão de driver para cada tipo de placa GPU NVIDIA, consulte a documentação oficial da NVIDIA na página de download de drivers NVIDIA.

Aplica-se apenas a novos nós

O rótulo aciona a instalação do driver quando um nó ingressa no cluster, seja durante a criação ou o scale-out. Os nós existentes não são afetados. Para atualizar um nó existente, remova o nó e adicione-o novamente.

Imagens personalizadas de SO

Em imagens personalizadas de SO que contenham componentes GPU, como o driver e o NVIDIA Container Runtime, o ACK não garante a compatibilidade entre o driver personalizado e outros componentes GPU do ACK, como os de monitoramento.

Versões não suportadas revertem para o padrão

Se a versão especificada não estiver na lista de versões suportadas pelo ACK, o sistema instalará a versão padrão. Uma versão incompatível com o SO mais recente também pode causar falhas na adição de nós. Utilize sempre a versão suportada mais recente.

Compatibilidade de tipos de instância

Tipo de instância

Versões de driver compatíveis

gn7, ebmgn7

Anteriores a 510.xxx (por exemplo, 470.xxx.xxxx com GSP desativado) ou 525.125.06 e posteriores. As versões 510.xxx e 515.xxx não são compatíveis.

ebmgn7, ebmgn7e

460.32.03 e posteriores

Etapa 1: Selecione uma versão do driver

Acesse a lista de versões de driver NVIDIA suportadas pelo ACK e escolha uma versão compatível com sua biblioteca CUDA. Este procedimento usa 550.144.03 como exemplo.

Etapa 2: Crie um pool de nós com o rótulo de versão do driver

  1. Faça logon no Container Service Management Console. No painel de navegação à esquerda, clique em Container Service Management ConsoleClusters.

  2. Clique no nome do seu cluster. No painel de navegação à esquerda, selecione Nodes > Node Pools.

  3. No canto superior esquerdo, clique em Create Node Pool. Consulte Criar e gerenciar um pool de nós.

  4. Na seção Node Labels, clique no ícone 1 para adicionar um rótulo:

    • Key: ack.aliyun.com/nvidia-driver-version

    • Value: 550.144.03

  5. Conclua as configurações restantes e envie o pool de nós.

Etapa 3: Verifique a instalação do driver

Após um nó ingressar no pool, confirme se ele tem a versão esperada do driver.

  1. Liste os pods com o rótulo component: nvidia-device-plugin para localizar o pod no novo nó:

    kubectl get po -n kube-system -l component=nvidia-device-plugin -o wide

    Saída esperada:

    NAME                             READY   STATUS    RESTARTS   AGE     IP              NODE                       NOMINATED NODE   READINESS GATES
    ack-nvidia-device-plugin-fnctc   1/1     Running   0          2m33s   10.117.227.43   cn-qingdao.10.117.XXX.XX   <none>           <none>

    Anote o nome do pod correspondente ao novo nó (por exemplo, ack-nvidia-device-plugin-fnctc).

  2. Execute nvidia-smi no pod para verificar a versão do driver:

    kubectl exec -ti ack-nvidia-device-plugin-fnctc -n kube-system -- nvidia-smi

    Saída esperada:

    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                                                             |
    +-----------------------------------------------------------------------------------------+

    A presença de Driver Version: 550.144.03 confirma a instalação do driver personalizado.

Defina a versão do driver via API

Ao criar um pool de nós com a API CreateClusterNodePool, inclua o rótulo de versão do driver no campo tags:

{
  "tags": [
    {
      "key": "ack.aliyun.com/nvidia-driver-version",
      "value": "550.144.03"
    }
  ]
}