ansible/ansible-collection-infrastructure

T

patrick aae89f5f5e fix(proxmox_lxc_provision): apply idmaps/GPU config via lineinfile, wire into flow

edit-config.yml was never included by the role, so lxc_id_mappings and GPU
passthrough were silently ignored. It also used blockinfile, whose comment
markers are incompatible with Proxmox hoisting all comments to the top of the
.conf on every write -- which orphans the markers and empties the managed block.

Rewrite edit-config.yml to manage raw lxc.* lines with lineinfile (keyed on each
exact line, churn-free, immune to comment hoisting), delegated to the Proxmox
host. Include it from main.yml after clone/create but before start.yml, while the
container is stopped, since ID mappings can't change on a running container.

2026-07-27 17:58:15 -04:00

roles

fix(proxmox_lxc_provision): apply idmaps/GPU config via lineinfile, wire into flow

2026-07-27 17:58:15 -04:00

galaxy.yml

chore: migrate proxmox module from community.general.proxmox to community.proxmox

2026-04-14 17:40:03 -04:00

README.md

chore: migrate proxmox module from community.general.proxmox to community.proxmox

2026-04-14 17:40:03 -04:00

README.md

Infrastructure Collection

Ansible collection for infrastructure management, system configuration, and virtualization.

Roles

proxmox_lxc_provision

Manages Proxmox LXC containers with comprehensive lifecycle operations.

Create, clone, start, stop, and delete containers
Template conversion and configuration editing
Post-provisioning tasks and health checks

system_setup

Performs initial system configuration for new servers.

Creates admin user with SSH key authentication
Hardens SSH configuration
Installs essential packages
Optional passwordless sudo configurations

system_maintenance

Updates packages and handles maintenance across multiple distributions.

Multi-distribution support (Debian/Ubuntu/Alpine)
Package updates and cleanup
Automatic reboot handling when required

nvidia_drivers

Installs NVIDIA drivers and CUDA runtime with proper idempotency and error handling.

Supports Debian/Ubuntu with automatic OS detection
Choice between proprietary and open-source drivers
Post-installation verification and cleanup
Architecture detection (x86_64/arm64)

Installation

ansible-galaxy collection install patrickj.infrastructure

Quick Start

Proxmox API Configuration

Set up your Proxmox API connection variables in group vars:

# group_vars/all.yml
proxmox_api_host: "10.0.1.1"
proxmox_api_port: 8006
proxmox_api_user: "automation@pve"
proxmox_api_token_id: "mytoken"
proxmox_api_token_secret: "{{ vault_proxmox_token }}"
proxmox_api_validate_certs: false
proxmox_node: "pve01"

Basic Proxmox LXC Container Setup

- name: Create and start an LXC container
  hosts: localhost
  connection: local
  vars:
    lxc_vmid: 100
    lxc_hostname: new-debian-container
    lxc_template: "local:vztmpl/debian-12_amd64.tar.zst"
    lxc_ipv4: "10.0.0.99/24"
  roles:
    - role: proxmox_lxc_provision

- name: Configure the LXC container
  hosts: new-debian-container
  become: yes
  tasks:
    - include_role:
        name: patrickj.infrastructure.system_setup
      vars:
        password: "{{ admin_password }}"
        ssh_pubkey_file: "~/.ssh/id_rsa.pub"

    - include_role:
        name: patrickj.infrastructure.nvidia_drivers
      vars:
        nvidia_install_kernel_modules: true
      when: gpu_server | default(false)

Requirements

Ansible >= 2.12
Root/sudo privileges on target hosts
community.general collection
community.proxmox collection
ansible.posix collection

License

MIT

Author

Patrick Jaroszewski