Compartilhar via


Extensão de driver de GPU NVIDIA para Windows

A Extensão de Driver de GPU NVIDIA para Windows instala drivers de GPU NVIDIA em máquinas virtuais (VMs) da série N do Windows. Dependendo da família VM, a extensão instala drivers CUDA ou grade. Ao instalar drivers NVIDIA usando essa extensão, você declara aceitar e concordar com os termos do Contrato de Licença de Usuário Final da NVIDIA. Durante o processo de instalação, a VM pode ser reinicializada para concluir a configuração do driver.

As instruções para a instalação manual dos drivers e a lista de versões atuais com suporte estão disponíveis para leitura. Para obter mais informações, consulte Instalar drivers de GPU NVIDIA em VMs da série N executando Windows.

A Extensão de Driver NVIDIA de GPU também pode ser implantada em VMs da série N com Linux. Para obter mais informações, confira Extensão de driver NVIDIA de GPU para Linux.

Note

Essa extensão continuará a usar v18.x até concluirmos a distribuição v20.x no 3º trimestre de 2026.

Note

As extensões de driver de GPU não atualizam automaticamente o driver depois que a extensão é instalada. Se você precisar mover para uma versão mais recente do driver, baixe e instale manualmente o driver ou remova e adicione a extensão novamente.

Note

Experimente a assistência de VM para diagnósticos mais rápidos. Recomendamos que você execute VM assist para Windows ou VM assist para Linux. Essas ferramentas de diagnóstico baseadas em script ajudam você a identificar problemas comuns que afetam o agente convidado da VM Azure e a integridade geral da VM.

Se você estiver enfrentando problemas de desempenho com máquinas virtuais, antes de entrar em contato com o suporte, execute essas ferramentas.

Prerequisites

Confirme se a sua máquina virtual cumpre os pré-requisitos de uso da Extensão de Driver NVIDIA de GPU.

Suporte do sistema operacional

A Extensão de Driver de GPU NVIDIA dá suporte às seguintes versões de Windows:

Distribution Version
Windows 11 Core
Windows 10 Core
Windows Server 2022 Core
Windows Server 2019 Core
Windows Server 2016 Core
Windows Server 2012 R2 Core

É necessária uma conexão com a internet

A Extensão de Driver NVIDIA de GPU requer que a VM de destino esteja conectada e tenha acesso à internet.

Leia o esquema da extensão

O trecho de código em JSON a seguir mostra o esquema para a extensão:

{
  "name": "<myExtensionName>",
  "type": "extensions",
  "apiVersion": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
  ],
  "properties": {
    "publisher": "Microsoft.HpcCompute",
    "type": "NvidiaGpuDriverWindows",
    "typeHandlerVersion": "1.10",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

Properties

O esquema JSON inclui valores para os parâmetros a seguir.

Name Value/Example Tipo de dados
apiVersion 2015-06-15 date
publisher Microsoft. HpcCompute cadeia
type NvidiaGpuDriverWindows cadeia
typeHandlerVersion 1.10 int

Implantar a extensão

Azure extensões de VM podem ser gerenciadas usando os modelos CLI do Azure, PowerShell, Azure Resource Manager (ARM) e o portal Azure.

Note

Alguns dos exemplos a seguir usam valores de parâmetro <placeholder> nos comandos. Antes de executar cada comando, certifique-se de substituir todos os valores de espaço reservado por valores específicos para a sua configuração.

Portal do Azure

Para instalar a Extensão de Driver de GPU NVIDIA no portal Azure, siga estas etapas:

  1. No portal Azure, acesse a máquina virtual na qual você deseja instalar a extensão.

  2. Em Configurações, selecione Extensões e Aplicações.

    Screenshot que mostra como selecionar Extensões + Aplicativos para uma máquina virtual no portal Azure.

  3. Em Extensões, selecione + Adicionar.

    Screenshot que mostra como adicionar uma extensão para uma máquina virtual no portal Azure.

  4. Localize e selecione a Extensão de Driver NVIDIA de GPU e, a seguir, selecione Avançar.

    Screenshot que mostra como localizar e selecionar a Extensão de Driver de GPU NVIDIA para uma máquina virtual no portal Azure.

  5. Selecione Examinar + criar. Confirme a ação de implantação e selecione Criar.

    Aguarde alguns minutos até que a extensão seja implantada.

    Screenshot que mostra como criar a Extensão de Driver de GPU NVIDIA na máquina virtual selecionada no portal Azure.

  6. Confirme se a extensão está listada como uma extensão instalada para a máquina virtual.

    Captura de tela que mostra a Extensão de Driver de GPU NVIDIA na lista de extensões da máquina virtual no portal do Azure.

modelo do ARM

Os modelos do ARM são ideais quando você implanta uma ou mais máquinas virtuais que requerem uma configuração pós-implantação.

A configuração do JSON para uma extensão de máquina virtual pode ser aninhada dentro do recurso de máquina virtual ou posicionada na raiz ou no nível superior de um modelo JSON do ARM. O posicionamento da configuração do JSON afeta o valor do name e type do recurso. Para obter mais informações, consulte Definir o nome e o tipo de recursos filho.

O exemplo a seguir pressupõe que a extensão está aninhada dentro do recurso de máquina virtual. Quando o recurso de extensão está aninhado, o JSON é colocado no objeto "resources": [] da máquina virtual.

{
  "name": "<myExtensionName>",
  "type": "extensions",
  "location": "[<resourceGroup().location>]",
  "apiVersion": "2015-06-15",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
  ],
  "properties": {
    "publisher": "Microsoft.HpcCompute",
    "type": "NvidiaGpuDriverWindows",
    "typeHandlerVersion": "1.10",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

PowerShell

Use o comando do PowerShell a seguir para implantar a Extensão de Driver NVIDIA de GPU em uma máquina virtual.

Set-AzVMExtension
    -ResourceGroupName "<myResourceGroup>" `
    -VMName "<myVM>" `
    -Location "<location>" `
    -Publisher "Microsoft.HpcCompute" `
    -ExtensionName "NvidiaGpuDriverWindows" `
    -ExtensionType "NvidiaGpuDriverWindows" `
    -TypeHandlerVersion 1.10 `
    -SettingString '{ `
	}'

CLI do Azure

Execute o comando a seguir no CLI do Azure para implantar a Extensão de Driver de GPU NVIDIA em uma máquina virtual.

az vm extension set \
  --resource-group <myResourceGroup> \
  --vm-name <myVM> \
  --name NvidiaGpuDriverWindows \
  --publisher Microsoft.HpcCompute \
  --version 1.10 \
  --settings '{ \
  }'

Solucionar problemas

Abaixo algumas sugestões de como solucionar problemas de implantação.

Verificar o status da extensão

Verifique o status da implantação da extensão no portal do Azure ou usando o PowerShell ou o CLI do Azure.

Para ver o status de implantação de extensões para uma VM específica, execute os comandos a seguir:

Get-AzVMExtension -ResourceGroupName <myResourceGroup> -VMName <myVM> -Name <myExtensionName>
az vm extension list --resource-group <myResourceGroup> --vm-name <myVM> -o table

Ler os logs de saída

Exibir logs de saída para a implantação da extensão do driver de GPU NVIDIA em C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.NvidiaGpuDriverWindows\.

Responder a códigos de erro

A tabela a seguir lista os códigos de erro mais comuns para a implantação e possíveis ações de acompanhamento.

Error Description Action
0 Operação concluída com êxito. Nenhuma ação necessária.
1 Operação concluída com êxito. Reboot.
100 Operação sem suporte ou não pôde ser concluída. Verifique os arquivos de log para determinar a causa do erro, como, por exemplo:
— A versão do PowerShell não tem suporte.
— O tamanho da VM não é uma VM da série N.
— Falha durante o download de dados.
240, 840 Tempo limite de operação. Tentar a operação novamente.
-1 Ocorreu uma exceção. Verifique os arquivos de log para determinar a causa da exceção.
-5x Operação foi interrompida devido a reinicialização pendente. Reinicialize a VM. A instalação continua após a reinicialização.
Desinstalação deve ser invocada manualmente.

Problemas conhecidos

O 17.x de versão do GRID Driver é incompatível com o NVv3 (NVIDIA Tesla M60). Há suporte para drivers GRID até a versão 16.5. NvidiaGpuDriverWindows instala os drivers mais recentes incompatíveis com o SKU do NVv3. Em vez disso, use as seguintes configurações de runtime para forçar a extensão a instalar uma versão mais antiga do driver. Para obter mais informações sobre as versões do driver, consulte NVIDIA GPU resources.

az vm extension set  --resource-group <rg-name> --vm-name <vm-name>  --name NvidiaGpuDriverWindows --publisher Microsoft.HpcCompute --settings "{'driverVersion':'538.46'}"
{
  "name": "NvidiaGpuDriverWindows",
  "type": "extensions",
  "apiVersion": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
  ],
  "properties": {
    "publisher": "Microsoft.HpcCompute",
    "type": "NvidiaGpuDriverWindows",
    "typeHandlerVersion": "1.10",
    "autoUpgradeMinorVersion": true,
    "settings": {
         "driverVersion": "538.46"
    }
  }
}

Obtenha suporte

Abaixo algumas outras opções para ajudar você a resolver problemas de implantação:

  • Para obter assistência, entre em contato com os especialistas do Azure nos fóruns Q&A e Stack Overflow.

  • Se você não encontrar uma resposta no site, poderá postar uma pergunta para obter informações de Microsoft ou de outros membros da comunidade.

  • Você também pode Contact Suporte da Microsoft. Para obter informações sobre como usar Suporte do Azure, leia as perguntas frequentes Suporte do Azure.

Próximas etapas