En este documento, se explica cómo crear una instancia de máquina virtual (VM) basada en Linux con unidades de procesamiento gráfico (GPU) de NVIDIA. Para realizar pasos similares en una instancia de VM de Windows, consulta Instala controladores de GPU de NVIDIA en una VM de Windows.
Una máquina virtual con GPU te permite ejecutar varias cargas de trabajo aceleradas por GPU, por ejemplo, inteligencia artificial y aprendizaje automático.
Las máquinas virtuales con GPU forman parte de la familia de máquinas de la serie A "optimizada para aceleradores", por ejemplo, A2 y A3. Para obtener más información, consulta Visualiza el tipo de máquina de la VM.
Este documento está dirigido a los desarrolladores de los grupos de administradores de plataformas o de operadores de aplicaciones que crean VMs en un entorno aislado de Google Distributed Cloud (GDC). Para obtener más información, consulta Públicos de la documentación de GDC aislado.
Antes de comenzar
Prepare el entorno
Para usar los comandos de la interfaz de línea de comandos (CLI) de gdcloud, asegúrate de haber descargado, instalado y configurado la CLI de gdcloud. Todos los comandos de Distributed Cloud usan la CLI de gdcloud o kubectl, y requieren un entorno de Linux.
Solicita roles de IAM
Comunícate con el administrador de IAM de tu proyecto para solicitar los siguientes roles:
Administrador de proyectos de máquinas virtuales (
project-vm-admin): Crea, modifica, enumera y borra VMs en el espacio de nombres del proyecto.Visualizador del proyecto(
project-viewer): Permite ver todos los recursos dentro del espacio de nombres del proyecto.
Todos los roles de VM deben vincularse al espacio de nombres del proyecto en el que reside la VM. Sigue los pasos para verificar tu acceso.
Crea una VM
Crea una VM siguiendo los pasos que se describen en Crea una VM a partir de una imagen y selecciona un tipo de máquina de la serie A.
Instala controladores de NVIDIA
En esta sección, se proporcionan los pasos para instalar los controladores de NVIDIA en tu instancia de VM de GDC.
Instale el paquete
A partir de la versión v20250809, las imágenes de Ubuntu y Rocky Linux proporcionadas por GDC
tienen controladores de NVIDIA preinstalados.
Para las versiones de imagen anteriores a v20250809 y las imágenes personalizadas proporcionadas por el usuario,
instala el controlador desde el repositorio de paquetes de GDC.
Conéctate a la VM con SSH y ejecuta el comando que corresponda al sistema operativo (SO) de tu VM:
Ubuntu
sudo apt install nvidia-dkms-570-server-open
Rocky Linux y RHEL
sudo dnf install nvidia-driver-cuda
Ejecuta DKMS
Habilita el controlador de NVIDIA en tu VM con el comando dkms. Solo debes realizar esta tarea una vez por VM:
sudo dkms autoinstall
Instala el kit de herramientas de CUDA
El kit de herramientas de NVIDIA CUDA está disponible en los repositorios de paquetes de GDC. Conéctate a la VM con SSH y, luego, ejecuta el comando que corresponda al SO de tu VM:
Ubuntu
sudo apt install cuda-toolkit-12-8
Rocky Linux y RHEL
sudo dnf install cuda-toolkit-12-8
Habilitar el inicio seguro y firmar los controladores
Si necesitas habilitar el inicio seguro en tu VM con GPU, debes firmar los controladores de GPU. Consulta las instrucciones para el SO correspondiente.
Ubuntu
- Conéctate a la VM con SSH.
Cambia al superusuario:
sudo suGenera una clave de MOK si aún no existe una:
[ -f /var/lib/shim-signed/mok/MOK.der ] || openssl req -new -x509 -newkey rsa:2048 -keyout /var/lib/shim-signed/mok/MOK.priv \ -outform DER -out /var/lib/shim-signed/mok/MOK.der \ -nodes -days 36500 -subj "/CN=DKMS Signing Key/"Inscribe la clave con
mokutil:mokutil --import /var/lib/shim-signed/mok/MOK.derCuando se te solicite, crea e ingresa una contraseña nueva de tu elección.
Firma los módulos de kernel de NVIDIA con la MOK:
for module in nvidia nvidia_drm nvidia_modeset nvidia_uvm nvidia_peermem; do /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 /var/lib/shim-signed/mok/MOK.priv /var/lib/shim-signed/mok/MOK.der $(modinfo -n $module) done
Rocky Linux y RHEL
- Conéctate a la VM con SSH.
Cambia al superusuario:
sudo suFirma el controlador con la clave usando
dkms autoinstall:sudo dkms autoinstallInscribe la clave de DKMS en MOK:
mokutil --import /var/lib/dkms/mok.pub
Finaliza la inscripción y la verificación de MOK
Para acceder a la pantalla de administración de MOK, asegúrate de reiniciar la instancia de VM y conectarte de inmediato al puerto en serie. La pantalla es sensible al tiempo y aparece solo brevemente durante el proceso de inicio. En particular, sigue estos pasos:
Reinicia la instancia de VM:
rebootConéctate a la consola en serie de la VM. Para obtener más información, consulta Conéctate a un puerto en serie.
Inscribe la MOK desde la consola:
Puedes ver la clave para asegurarte de que coincida con la que se generó en un paso anterior:
Ingresa la contraseña que seleccionaste antes:
Selecciona Reboot en el menú de administración de MOK:
Ejecuta
nvidia-smipara verificar que el controlador de NVIDIA funcione.En el resultado, se muestra el estado de la GPU y la información del controlador:
$ nvidia-smi Wed Aug 13 00:09:17 2025 +-----------------------------------------------------------------------------------------+ | NVIDIA-SMI 570.158.01 Driver Version: 570.158.01 CUDA Version: 12.8 | |-----------------------------------------+------------------------+----------------------+ | 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 NVIDIA H200 Off | 00000000:08:00.0 Off | 0 | | N/A 42C P0 128W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 1 NVIDIA H200 Off | 00000000:09:00.0 Off | 0 | | N/A 36C P0 127W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 2 NVIDIA H200 Off | 00000000:0A:00.0 Off | 0 | | N/A 34C P0 122W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 3 NVIDIA H200 Off | 00000000:0B:00.0 Off | 0 | | N/A 40C P0 128W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 4 NVIDIA H200 Off | 00000000:0C:00.0 Off | 0 | | N/A 39C P0 125W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 5 NVIDIA H200 Off | 00000000:0D:00.0 Off | 0 | | N/A 35C P0 122W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 6 NVIDIA H200 Off | 00000000:0E:00.0 Off | 0 | | N/A 39C P0 128W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ | 7 NVIDIA H200 Off | 00000000:0F:00.0 Off | 0 | | N/A 35C P0 121W / 700W | 0MiB / 143771MiB | 0% Default | | | | Disabled | +-----------------------------------------+------------------------+----------------------+ +-----------------------------------------------------------------------------------------+ | Processes: | | GPU GI CI PID Type Process name GPU Memory | | ID ID Usage | |=========================================================================================| | No running processes found | +-----------------------------------------------------------------------------------------+