Files
kevin_janssenandClaude Opus 5.5 9fa6c05af7
Rust development slice / linux (push) Failing after 15s
Document the Proxmox host, its read-only access and the local Proxmox test VM
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-20 12:17:23 +01:00
..

Proxmox-VE-Host

Ein Proxmox-VE-Host ist ein Debian-System. Er verwendet deshalb den regulären Linux-Agenten, seinen Helper und seinen Updater. Zusätzlich liest der Agent über die lokale Proxmox-API die gehosteten Gäste, die geplanten Backupjobs und die Ergebnisse der letzten vzdump-Läufe. Er meldet sie als Inventarbereich linux.proxmox. Die WebUI zeigt diese Daten in den Gerätedetails des Hosts. Der Agent ordnet die gemeldeten VMs automatisch dem Host zu. Sammelmodul · API-Zugriff

Aufnahme

Für die Aufnahme den gemeinsamen HTTPS-Installer als root auf dem Proxmox-Host ausführen. Der Installer erkennt Proxmox VE an pveversion und pveum und richtet einen nur lesenden Zugang ein:

  • Proxmox-Benutzer rmm-discovery@pve und das privilegiengetrennte API-Token rmm-discovery@pve!inventory. Beide erhalten auf / ausschließlich die Rolle PVEAuditor. Bei einem privilegiengetrennten Token gilt die Schnittmenge aus Benutzer- und Tokenrechten. Deshalb braucht auch der Benutzer die Rolle.
  • Den Tokenwert schreibt er nach /opt/rust-discovery-client/proxmox-token (Eigentümer root, Modus 0600). Die Cluster-CA landet als /opt/rust-discovery-client/pve-ca.pem.
  • Das systemd-Drop-in rmm-discovery-agent.service.d/41-proxmox-api.conf übergibt den Token mit LoadCredential=rmm-proxmox-token an den Dienst und setzt RMM_PROXMOX_CA_FILE.

Der Agent läuft weiter unprivilegiert als rmm-discovery. Er verbindet sich nur mit https://127.0.0.1:8006 und prüft das Zertifikat ausschließlich gegen die kopierte Cluster-CA. Token und Tokenwert erscheinen weder im Inventar noch im Log. Bei einer erneuten Installation bleiben ein vorhandener Token und die Geräteidentität erhalten. Fehlt die lokale Kopie, erzeugt der Installer das Token neu, weil Proxmox den Wert nur bei der Erstellung ausgibt.

Gemeldete Daten

  • Gäste des lokalen Nodes: VMID, Name, VM oder Container, Status, Vorlage, vCPU, RAM, Disk, Pool, MAC-Adressen der netN-Schnittstellen und für QEMU die SMBIOS-UUID. Höchstens 512 Gäste. Gäste auf anderen Cluster-Nodes meldet der Agent des jeweiligen Nodes.
  • Backupjobs aus /cluster/backup: Zeitplan, Storage, Modus, Auswahl (alle, Pool oder VMIDs, abzüglich Ausnahmen) und die danach gesicherten lokalen Gäste. Den letzten fälligen Zeitpunkt berechnet der Proxmox-Scheduler selbst über /cluster/jobs/schedule-analyze.
  • vzdump-Läufe der letzten acht Tage (höchstens 64) mit Start, Ende und Gesamtstatus. Das Ergebnis je Gast stammt aus den Zeilen Finished Backup of VM bzw. Backup of VM … failed des Tasklogs.
  • Gäste ohne Backupjob aus /cluster/backup-info/not-backed-up.

Der Server bewertet jeden aktiven Job: Gelaufen, wenn jeder gesicherte Gast seit dem letzten fälligen Zeitpunkt (zwei Minuten Toleranz) erfolgreich gesichert wurde. Fehlgeschlagen bei einem gemeldeten Fehler, Verpasst ohne Lauf, Läuft bei aktivem vzdump. Ein Job, der in den letzten acht Tagen noch nicht fällig war, gilt als Noch nicht fällig. „Alle geplanten Backups sind gelaufen“ steht nur, wenn kein aktiver Job fehlgeschlagen oder verpasst ist. Bewertung

Zuordnung der VMs

Nach jeder Linux- oder Windows-Inventarmeldung vergleicht der Server die MAC-Adressen der aktuellen Proxmox-Gastlisten mit den Netzwerkkarten der aktuellen virtuellen Geräte desselben Kunden. Bei einem eindeutigen Treffer trägt er den Proxmox-Host als Hypervisor ein (hypervisor_source = proxmox) und auditiert device_hypervisor_detected. Eine MAC, die mehrere Geräte oder mehrere Hosts melden, führt zu keiner Zuordnung. Verschwindet der Gast aus der gültigen Gastliste seines Hosts, wird die automatische Zuordnung gelöst. Eine manuelle Auswahl unter Gerät verwalten → Hypervisor zuordnen hat Vorrang. Die Option Automatisch (Proxmox-Gastliste) gibt die Entscheidung an die Erkennung zurück. Abgleich

Diagnose

Anzeige im Gerätedetail Ursache
„kein Lesezugang eingerichtet“ (PROXMOX_NOT_CONFIGURED) Credential fehlt. HTTPS-Installer erneut als root ausführen und den Agentdienst neu starten.
PROXMOX_TOKEN_REJECTED Token gelöscht oder abgelaufen. /opt/rust-discovery-client/proxmox-token entfernen und den Installer erneut ausführen.
PROXMOX_PERMISSION_DENIED Der Benutzer oder das Token hat keine Rolle PVEAuditor auf /.
PROXMOX_CA_UNAVAILABLE, PROXMOX_UNREACHABLE CA-Kopie fehlt bzw. pveproxy ist auf Port 8006 nicht erreichbar.

Zum Widerrufen pveum user token remove rmm-discovery@pve inventory ausführen. Die übrige Inventur läuft dann weiter, der Proxmox-Bereich meldet einen Fehler.

Testhost auf dem Entwicklungsnotebook

VM proxmox auf qemu:///system: 4 vCPU (host-passthrough, verschachtelte Virtualisierung), 4 GiB RAM, 64 GiB qcow2 im Pool default, Netz default mit fester DHCP-Reservierung 192.168.122.50 (MAC 52:54:00:50:7e:01). Basis ist das offizielle proxmox-ve_9.2-1.iso (SHA-256 4e88fe416df9b527624a175f24c9aa07c714d3332afb1ee3dbf3879573ef2c6c). Die Installation erfolgte unbeaufsichtigt mit dem proxmox-auto-install-assistant aus dem Proxmox-Repository. Die Paketquelle ist pve-no-subscription. FQDN pve.discovery.lan, WebUI https://192.168.122.50:8006.

Testobjekte: VM 100 debian-guest (Debian-13-Cloud-Image, 1 GiB, cloud-init) und Container 101 alpine-ct (Alpine 3.24, ohne Backupjob). Der Backupjob backup-debian sichert VM 100 alle zwei Stunden (*/2:00) nach local.

SSH-Zugang, Root-Passwort und Hostpin liegen im privaten Zugangsverzeichnis (proxmox-vm.conf, proxmox-dev-key, proxmox-dev-root, proxmox-dev.known_hosts). tools/dev_stage.py proxmox … verwendet diese Dateien. Start bei Bedarf: virsh -c qemu:///system start proxmox.