Partilhar via


Extensão do Driver GPU NVIDIA para Windows

A Extensão de Drivers GPU NVIDIA para Windows instala os drivers da 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 GRID. Quando você instala drivers NVIDIA usando esta extensão, você aceita e concorda com os termos do Contrato de Licença de Usuário Final da NVIDIA. Durante o processo de instalação, a VM pode reinicializar para concluir a configuração do driver.

As instruções para a instalação manual dos drivers e a lista de versões suportadas atuais estão disponíveis para revisão. Para mais informações, consulte Instale os drivers da GPU NVIDIA em VMs da série N a executar Windows.

A NVIDIA GPU Driver Extension também pode ser implantada em VMs Linux série N. Para obter mais informações, consulte NVIDIA GPU Driver Extension for Linux.

Note

Esta extensão continuará a usar a v18.x até terminarmos a implementação da v20.x no terceiro trimestre do ano de 2026.

Note

As extensões de driver da GPU não atualizam automaticamente o driver após a instalação da extensão. Se precisar mudar para uma versão mais recente do driver, deve de manualmente descarregar e instalar o driver ou remover e voltar a adicionar a extensão.

Note

Experimenta o VM assist para diagnósticos mais rápidos. Recomendamos que execute VM assist para Windows ou VM assist para Linux. Estas ferramentas de diagnóstico baseadas em scripts ajudam-no a identificar problemas comuns que afetam o Agente de Convidados da VM Azure e a saúde geral da VM.

Se estiver a experienciar problemas de desempenho com máquinas virtuais, antes de contactar o suporte, execute estas ferramentas.

Prerequisites

Confirme se sua máquina virtual satisfaz os pré-requisitos para usar a extensão de driver de GPU NVIDIA.

Suporte de sistema operativo

A Extensão do Driver GPU NVIDIA suporta as seguintes versões para 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

Ligação à Internet necessária

A extensão de driver de GPU NVIDIA requer que a VM de destino esteja conectada à Internet e tenha acesso.

Revise o esquema de extensão

O trecho 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 seguintes parâmetros.

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

Implantar a extensão

As extensões VM do Azure podem ser geridas utilizando os templates CLI do Azure, PowerShell, Azure Resource Manager (ARM) e o portal Azure.

Note

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

Azure portal

Para instalar a Extensão do Driver GPU NVIDIA no portal Azure, siga estes passos:

  1. No portal Azure, vai à máquina virtual onde queres instalar a extensão.

  2. Em Configurações, selecione Extensões + Aplicativos.

    Captura de ecrã que mostra como selecionar Extensões + Aplicações para uma máquina virtual no portal Azure.

  3. Em Extensões, selecione + Adicionar.

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

  4. Localize e selecione NVIDIA GPU Driver Extension e, em seguida, selecione Next.

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

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

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

    Captura de ecrã que mostra como criar a Extensão do Driver 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 ecrã que mostra a Extensão do Driver GPU NVIDIA na lista de extensões para a máquina virtual no portal Azure.

modelo do ARM

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

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

O exemplo a seguir pressupõe que a extensão esteja aninhada dentro do recurso de máquina virtual. Quando o recurso de extensão é 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 seguinte comando do PowerShell para implantar a extensão de driver de GPU NVIDIA 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 seguinte comando na CLI do Azure para implementar a Extensão do Driver GPU NVIDIA numa máquina virtual.

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

Solucionar problemas

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

Verificar o estado da extensão

Verifique o estado da implementação da sua extensão no portal do Azure, ou usando o PowerShell ou a CLI do Azure.

Para ver o estado de implantação das extensões de uma determinada VM, execute os seguintes comandos:

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

Verificar registos de saída

Veja os registos de saída da implementação da extensão de driver da GPU NVIDIA em C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.NvidiaGpuDriverWindows\.

Responder a códigos de erro

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

Error Description Action
0 Operação bem-sucedida. Nenhuma ação necessária.
1 Operação bem-sucedida. Reboot.
100 A operação não é suportada ou não pôde ser concluída. Verifique os arquivos de log para determinar a causa do erro, como:
- A versão do PowerShell não é suportada.
- 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 novamente a operação.
-1 Ocorreu uma exceção. Verifique os arquivos de log para determinar a causa da exceção.
-5x Operação interrompida devido à reinicialização pendente. Reinicie a VM. A instalação continua após a reinicialização.
A desinstalação deve ser invocada manualmente.

Problemas conhecidos

A versão 17.x do driver GRID é incompatível com NVv3 (NVIDIA Tesla M60). Os controladores GRID até à versão 16.5 são suportados. NvidiaGpuDriverWindows instala os drivers mais recentes que são incompatíveis no NVv3 SKU. Em vez disso, use as seguintes configurações de tempo de execução para forçar a extensão a instalar uma versão mais antiga do driver. Para mais informações sobre versões dos drivers, 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

Aqui estão algumas outras opções para ajudá-lo a resolver problemas de implantação:

  • Para obter assistência, contacte os especialistas da Azure nos fóruns de Q&A e Stack Overflow.

  • Se não encontrar uma resposta no site, pode publicar uma pergunta para obter contributos da Microsoft ou de outros membros da comunidade.

  • Também pode Contactar Suporte da Microsoft. Para informações sobre como utilizar o suporte do Azure, leia as FAQs do suporte do Azure.

Próximos passos