Ansible 角色：Proxmox VE NVIDIA 直通配置

这是一个用于在 Proxmox VE 7.x 上配置 NVIDIA 驱动程序以实现虚拟机和 LXC 容器直通的 Ansible 角色。

此角色已在 Proxmox VE 7.3 上进行了测试，基于 Ubuntu 22.04 模板的 LXC 容器。

要求

无。

角色变量

可用的变量如下所示，以及默认值（见 defaults/main.yml）：

pve_nvidia_passthrough_driver_version: ""
pve_nvidia_passthrough_initramfs_update_options: -k all -u

pve_nvidia_passthrough_driver_version 的值是必需的，应包含所需的驱动版本。您可以使用官方向导来识别适用于您的 GPU 的最新版本：https://www.nvidia.com/Download/index.aspx。

键 pve_nvidia_passthrough_initramfs_update_options 允许配置在添加模块时 initramfs 命令的选项。

默认情况下，此角色为 Proxmox 主机安装/配置驱动程序。要为 LXC 客户机配置驱动程序，需将键 pve_nvidia_passthrough_install_mode 设置为 guest。

依赖项

在 LXC 客户机上运行此角色之前，您需要在容器的 .conf 文件中设置适当的 lxc 标志。

例如，对于 /dev 中的以下条目：

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

您必须在 LXC 客户机的 .conf 文件中添加以下行（位于 /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/

示例播放剧本

- hosts: localhost

  vars:
    pve_nvidia_passthrough_driver_version: "525.89.02"

  roles:
    - simoncaron.pve_nvidia_passthrough

许可

MIT

作者信息

此角色由 Simon Caron 于 2023 年创建。