Ansible Роль: Конфигурация NVIDIA Passthrough для Proxmox VE

Это Ansible роль, которая конфигурирует драйвера NVIDIA на Proxmox VE 7.x для передачи в виртуальные машины (VM) и LXC.

Эта роль была протестирована на Proxmox VE 7.3 на контейнерах LXC на основе шаблона Ubuntu 22.04.

Требования

Нет.

Переменные роли

Доступные переменные перечислены ниже, вместе с значениями по умолчанию (см. defaults/main.yml):

pve_nvidia_passthrough_driver_version: ""
pve_nvidia_passthrough_initramfs_update_options: -k all -u

Значение pve_nvidia_passthrough_driver_version является обязательным и должно содержать желаемую версию драйвера. Вы можете использовать официальный инструмент для определения последней доступной версии для вашей графической карты: https://www.nvidia.com/Download/index.aspx.

Ключ pve_nvidia_passthrough_initramfs_update_options позволяет настроить параметры команды initramfs при добавлении модулей.

По умолчанию роль устанавливает/конфигурирует драйвер для хоста Proxmox. Чтобы настроить драйвер для гостя LXC, ключ pve_nvidia_passthrough_install_mode должен быть установлен на guest.

Зависимости

Перед запуском роли на гостях LXC вам нужно будет установить соответствующие флаги lxc в файле .conf вашего контейнера.

Пример, для следующих записей в /dev:

root@pve01:/etc/pve/lxc# ls -l /dev/nvidia*
crw-rw-rw- 1 root root 195,   0 Фев 13 21:15 /dev/nvidia0
crw-rw-rw- 1 root root 195, 255 Фев 13 21:15 /dev/nvidiactl
crw-rw-rw- 1 root root 195, 254 Фев 13 21:15 /dev/nvidia-modeset
crw-rw-rw- 1 root root 511,   0 Фев 13 21:15 /dev/nvidia-uvm
crw-rw-rw- 1 root root 511,   1 Фев 13 21:15 /dev/nvidia-uvm-tools

Вы должны добавить следующие строки в файл .conf гостя LXC (в /etc/pve/lxc/.conf):

lxc.cgroup2.devices.allow: c 195:* rwm
lxc.cgroup2.devices.allow: c 508:* rwm
lxc.mount.entry: /dev/nvidia0 dev/nvidia0 none bind,optional,create=file
lxc.mount.entry: /dev/nvidiactl dev/nvidiactl none bind,optional,create=file
lxc.mount.entry: /dev/nvidia-uvm dev/nvidia-uvm none bind,optional,create=file
lxc.mount.entry: /dev/nvidia-uvm-tools dev/nvidia-uvm-tools none bind,optional,create=file
lxc.mount.entry: dev/nvidia-modeset dev/nvidia-modeset none bind,optional,create=file
lxc.mount.entry: /dev/nvidia-modeset dev/nvidia-modeset none bind,optional,create=file

После добавления строк необходимо перезагрузить LXC. Вы можете запустить эту роль с pve_nvidia_passthrough_install_mode, установленным на guest, для конфигурации гостя.

Смотрите эти ресурсы для получения дополнительной информации:

• https://jocke.no/2022/02/23/plex-gpu-transcoding-in-docker-on-lxc-on-proxmox/
• https://theorangeone.net/posts/lxc-nvidia-gpu-passthrough/

Пример Playbook

- hosts: localhost

  vars:
    pve_nvidia_passthrough_driver_version: "525.89.02"

  roles:
    - simoncaron.pve_nvidia_passthrough

Лицензия

MIT

Авторская информация

Эта роль была создана в 2023 году Симоном Кароном.