feat: proxmox_upgrade role and playbook

roles/proxmox_upgrade/tasks/main.yml

@@ -0,0 +1,33 @@
+---
+# =============================================================================
+# proxmox_upgrade — main.yml
+# Orchestrates rolling Proxmox cluster upgrade
+# Runs on the first node in upgrade_order, delegates API calls to localhost
+# =============================================================================
+
+- name: Proxmox Upgrade | Start
+  ansible.builtin.debug:
+    msg: >-
+      Starting Proxmox rolling upgrade for {{ client_name }}
+      — {{ upgrade_order | length }} nodes in order: {{ upgrade_order | join(' → ') }}
+      — migration_bulk={{ migration_bulk }}
+      — live_migrate_fallback={{ live_migrate_fallback }}
+      — migration_restore={{ migration_restore }}
+      — ceph_enabled={{ ceph_enabled }}
+
+# ── Cluster health preflight ──────────────────────────────────────────────────
+- name: Proxmox Upgrade | Cluster preflight
+  include_tasks: preflight.yml
+
+# ── Rolling upgrade — one node at a time ─────────────────────────────────────
+- name: Proxmox Upgrade | Rolling upgrade loop
+  include_tasks: node_upgrade.yml
+  loop: "{{ upgrade_order }}"
+  loop_var: current_node
+
+- name: Proxmox Upgrade | Complete
+  ansible.builtin.debug:
+    msg: >-
+      Proxmox rolling upgrade complete for {{ client_name }}
+      — all {{ upgrade_order | length }} nodes upgraded successfully
+