inettgmbh/proxmox-ansible

Collection of Proxmox related Ansible Modules, Playbooks and Roles

proxmox-ansible

setup

this collection is to be used just like ansible galaxy or cloned into ./collections/ansible_collections/inett/pve The namespace is inett.pve

usage

VMs are part of the inventory in the form of normal hosts, but contained special groups, configured with variables.

groups

• pve_nodes must contain Proxmox VE nodes
• pve_vms all vms to be deployed/removed must be inside this group

playbooks

• vms_setup: basic setup for VMs

roles

• inett.pve.cluster_group: gather facts about Proxmox VE nodes and group them by cluster name
• inett.pve.vm_prepare_facts: assigns VMs to target nodes, set and merge some facts
• inett.pve.vms: set up VMs and group them by target state
• inett.pve.vm_disks: resize and create SCSI disks
• inett.pve.vm_cloudinit: ensure state of cloud-init drive
• inett.pve.vms_finish: wait for VMs (timeout if pve_vm_wait is an integer, connection (Linux) if pve_vm_wait is set to "connect") and finish setup

variables

pve_nodes

vm_storage and efivars_storage are automatically merged by the role inett.pve.vm_prepare_facts from the target node to the VM.

pve_vms

• pve_vmid (Integer, required): ID of VM
• pve_vm_state (running|stopped|absent, required): target state for VM
• pve_vm_memory (Integer, 1024): size of VM RAM in bytes
• pve_vm_cpu (dict):
  • cores (Integer (4)): number of cores
  • vcpus (Integer (4)): number of virtual cpus
  • limit (Integer (4)): CPU limit
• pve_vm_storage (String): default storage for VM resources
• pve_vm_scsi (dict):
  • 0:
    • storage (String, {{ pve_vm_storage }})
• pve_vm_setup_iso (dict):
  • storage (String ('cephfs'))
  • image_name (String, required)
  • media (String ('cdrom'))
• pve_vm_remove_install_media (Boolean (true)): remove media in ide1 after VM setup
• pve_target_cluster (String): Name of the target cluster for VM related tasks
• pve_target_node (String): Inventory name of target Proxmox VE node (overrides pve_target_cluster)