---
argument_specs:
  main:
    short_description: Create a Proxmox VM for Single Node OpenShift
    description:
      - Creates a q35/UEFI virtual machine in Proxmox suitable for SNO deployment.
      - Retrieves the assigned VM ID and MAC address as cacheable facts.
    options:
      proxmox_node:
        description: Proxmox cluster node to create the VM on.
        type: str
        default: pve1
      proxmox_api_user:
        description: Proxmox API username.
        type: str
        default: ansible@pam
      proxmox_api_token_id:
        description: Proxmox API token ID.
        type: str
        default: ansible
      proxmox_api_token_secret:
        description: Proxmox API token secret.
        type: str
        required: true
        no_log: true
      proxmox_validate_certs:
        description: Whether to validate TLS certificates for the Proxmox API.
        type: bool
        default: false
      proxmox_storage:
        description: Proxmox storage pool for VM disks.
        type: str
        default: local-lvm
      proxmox_iso_storage:
        description: Proxmox storage pool name for ISO images.
        type: str
        default: local
      proxmox_iso_dir:
        description: Filesystem path on the Proxmox host where ISOs are stored.
        type: str
        default: /var/lib/vz/template/iso
      sno_credentials_dir:
        description: >-
          Directory on proxmox_host where kubeconfig and kubeadmin-password
          are persisted after installation.
        type: str
        default: "/root/sno-{{ ocp_cluster_name }}"
      sno_vm_name:
        description: Name of the VM in Proxmox.
        type: str
        default: "sno-{{ ocp_cluster_name }}"
      sno_cpu:
        description: Number of CPU cores for the VM.
        type: int
        default: 8
      sno_memory_mb:
        description: Memory in megabytes for the VM.
        type: int
        default: 32768
      sno_disk_gb:
        description: Primary disk size in gigabytes.
        type: int
        default: 120
      sno_bridge:
        description: Proxmox network bridge for the VM NIC.
        type: str
        default: vmbr0
      sno_vlan:
        description: VLAN tag for the VM NIC.
        type: int
        default: 40
      sno_mac:
        description: >-
          MAC address to assign. Leave empty for auto-assignment by Proxmox.
          Set explicitly to pin a MAC for static IP reservations.
        type: str
        default: ""
      sno_vm_id:
        description: >-
          Proxmox VM ID. Set to 0 for auto-assignment.
          Populated as a cacheable fact after VM creation.
        type: int
        default: 0