Files
ProxLedger/docs/issues/022-cluster-abgleich.md
T
florian.wildeandClaude Opus 5 7728fcb565 feat(cluster): Cluster-Knoten ohne Agent erkennen (#022, #018)
Feldtest auf zwei echten Proxmox-VE-9.2-Hosts (#018): Installation, Timer,
Zwischenspeicher und Nachsenden laufen wie vorgesehen. `pvesubscription get`
kennt kein JSON, ohne Subscription fehlen fast alle Felder, `pveversion`
enthaelt den Kernel doppelt - alles im Agent beruecksichtigt.

Dabei zeigte sich: in Proxmox hat jeder Knoten eine eigene Subscription.
Der Agent meldet darum die Cluster-Mitglieder aus `pvecm nodes`, und eine
elfte Warnregel meldet Knoten, von denen sich kein Agent meldet (#022).

Ausserdem behoben: die Bilder des Handbuchs zeigten allesamt die
Anmeldeseite, weil Firefox eine selbst erzeugte Cookie-Datei stillschweigend
verwirft. Das Skript nutzt jetzt einen lokalen Vermittler und bricht ab,
wenn alle Aufnahmen gleich gross sind.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-18 18:05:08 +02:00

1.9 KiB
Raw Blame History

#022 Cluster-Abgleich

Status: erledigt Meilenstein: v0.14.0 Labels: agent, backend, alerts Geschätzt: 3 h Tatsächlich: 0 h 25 min

Ziel

In einem Proxmox-Cluster hat jeder Knoten eine eigene Subscription mit eigener Server-ID. Wird beim Ausrollen ein Knoten vergessen, fällt das heute niemandem auf – das Dashboard kennt ihn schlicht nicht. Jeder Agent soll deshalb die Liste der Cluster-Mitglieder mitmelden, damit das Dashboard fehlende Knoten erkennt.

Aufgaben

  • Agent meldet clusterMitglieder (Namen aller Knoten laut pvecm nodes)
  • Agent-API nimmt das Feld entgegen (optional, wie alle anderen)
  • Datenmodell: Feld am Host, Migration
  • Warnregel „Cluster-Knoten ohne Agent“
  • Host-Detail zeigt die Mitglieder mit Zustand (meldet sich / kein Agent)
  • Tests: Agent mit nachgebautem pvecm, Regel mit vollständigem und lückenhaftem Cluster

Akzeptanzkriterien

  • Ein Cluster mit drei Knoten und zwei Agents erzeugt genau eine Warnung
  • Sobald der dritte Agent meldet, schließt sich die Warnung von selbst
  • Hosts ohne Cluster erzeugen keine Warnung

Abhängigkeiten

#005, #011, #018

Notizen / Entscheidungen

  • Entstanden beim Feldtest (#018) an einem echten Cluster mit drei Knoten: Alle drei haben eigene Server-IDs und eigenen Status, bestätigt über pvesh get /nodes/<name>/subscription.
  • Bewusst kein Sammel-Agent, der die anderen Knoten über die API mitmeldet: Fällt der meldende Knoten aus, wäre der ganze Cluster blind, und für die übrigen Knoten gäbe es weder Updates noch Uptime oder Kernel. Stattdessen Agent je Knoten plus dieser Abgleich.
  • Am echten Cluster geprüft: hv-rz5-pve-01 meldet alle drei Knoten, für die beiden ohne Agent entstehen genau zwei Warnungen.
  • Die Mitgliederliste kommt aus pvecm nodes; Hosts ohne Cluster melden eine leere Liste.
  • Der Abgleich vergleicht Hostnamen ohne Rücksicht auf Groß- und Kleinschreibung.