Installing and managing Proxmox machines from the ground up with Ansible

lae · October 14, 2021, 9:58am

I just opened this issue and realised there are likely people on this forum who might be interested in contributing, since I do see a lot of Proxmox users using it for VFIO, etc. here.

github.com/lae/ansible-role-proxmox

VFIO support

opened 05:49AM - 14 Oct 21 UTC

closed 02:02PM - 05 Jul 24 UTC

lae

enhancement hacktoberfest-accepted good first issue

So a lot of people have started using PVE for their VFIO setups, it looks like, …and so have I recently. We can probably simplify the setup for it in this role like we do for watchdog and ZFS. Setup instructions can be found on the wiki (sections 1-3 is all that's needed, the others are only relevant to the creation of VMs): https://pve.proxmox.com/wiki/Pci_passthrough This is probably a good chance for someone new to familiarize themselves with this role's codebase, so let me know if anyone's interested and I'll help guide you through it.

This is an Ansible role for deploying Proxmox clusters (or single nodes) on Debian servers originally written back in 2016 and it has seen a lot of activity since, as well as a few companies adopting it for their Proxmox deployments.

So if you use Proxmox and know some Ansible (or even if you’re just starting to learn Ansible) and want to contribute to an open source project, I think this could be a good opportunity for you to get your feet wet and help out!

While I could work on this myself, it would definitely be more preferable to me (and the other contributors) to have more people who are familiar with the codebase and thus can review code contributions and the like without needing to rely on me.

Either way, I’ll eventually get around to it if there does happen to be no interest, lol. But if you are interested, let me know and I can help point you in the right direction! And if the VFIO one above seems too complicated, there are a couple other more trivial issues open that you could try your hand at, as well. Thanks for reading!

arhue · October 14, 2021, 11:23am

I don’t currently use Proxmox(as I only have a laptop) and haven’t used Ansible for a while, but I’ll try to contribute with some PRs in my mid semester break, in a couple of weeks or so.

lae · October 20, 2021, 7:19am

P.S. I’ve opted the repository in for Hacktoberfest (since I guess the rules changed and it’s opt-in this year now) so check it out if you’re participating!

Also, it looks like yesterday marked the fifth year anniversary of the project since 1.0. Woo.

lae · July 15, 2024, 3:35pm

As a bit of an update, support for configuring VFIO is finally in the role as of last week. It is not yet in a versioned release as there are some more changes I want to make before setting some of the new changes in stone, but please try it out and tell me how it goes!

That said, I’m still looking for new contributors to become my redundancy . Reach out if you’re interested and maybe want some mentorship.

lae · September 30, 2024, 7:28am

I figure I can just reuse this thread instead of creating a new one to talk about the role in general, instead of just asking for help.

1.9.0 was cut 2 weeks ago with VFIO support and some other neat things.

An example minimal configuration of enabling VFIO and stubbing a single NVIDIA graphics card (there are other optional variables you may want to set, so check the docs for that):

pve_pcie_passthrough_enabled: true
pve_pci_device_ids:
  - id: "10de:1381"