duffyduckandClaude Opus 5
59e7224297
26 Kapitel in vier Teilen, in der Reihenfolge, in der man sie braucht: erst sichern, dann Dateien holen, dann ganze Maschinen wiederherstellen, dahinter der Nachschlagteil. Gebaut wird mit MkDocs + Material. Bewusst ohne Netzabhaengigkeiten: keine Schriften vom CDN (font: false), Volltextsuche mit deutschem Stemming liegt neben den Seiten. Im Notfall steht vielleicht das halbe Netz - dann nuetzt eine Doku im Internet nichts. handbuch/bauen.sh baut handbuch/site/ handbuch/bauen.sh ansehen Vorschau auf 127.0.0.1:8000 install.sh nimmt das gebaute Handbuch mit nach /usr/share/doc/pvesnap/handbuch/ - falls es vorliegt. Auf dem Host selbst wird nichts gebaut, mkdocs gehoert nicht auf einen Hypervisor. Die 28 Bildschirmfotos sind nicht abfotografiert, sondern erzeugt: Der echte Programmcode laeuft in einem Pseudo-Terminal gegen einen erfundenen Proxmox-Host (Attrappen fuer pvesh, perl und rbd), pyte baut den Bildschirm nach, heraus faellt ein SVG. Damit stimmen sie garantiert mit dem Programm ueberein, sind reproduzierbar und enthalten keine echten Daten. Die Werkstatt dafuer liegt unter handbuch/werkstatt/ samt LIESMICH.md. Nebenbei: die Schlussmeldung von install.sh warb noch mit --exchange, das mit dem eingebauten Austauschlaufwerk weggefallen ist. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
5.9 KiB
Der Konfigurationseditor
pvesnap config
Braucht root — der Editor schreibt nach /etc/pvesnap/ und fragt Proxmox nach
dem Inventar.
Alles, was hier geht, geht auch von Hand in der INI-Datei. Der Editor hat aber zwei Vorteile, die man beim Tippen nicht hat: Er zeigt live, auf wie viele Gäste eine Auswahl gerade zutrifft, und er rechnet den nächsten Termin aus, bevor man speichert.
Die Gruppenliste
Der Einstiegsbildschirm. Oben steht die Datei, an der gearbeitet wird, und
rechts daneben, ob der Dienst gerade läuft. Ein * vor dem Dateinamen bedeutet:
ungespeicherte Änderungen.
| Taste | |
|---|---|
| ++enter++ | Gruppe bearbeiten |
| ++space++ | Gruppe ein- oder ausschalten |
| ++n++ | neue Gruppe |
| ++c++ | Gruppe kopieren — der schnellste Weg zu einer Variante |
| ++d++ | Gruppe löschen |
| ++g++ | globale Einstellungen |
| ++v++ | Übersicht: welche VM in welcher Gruppe? |
| ++s++ | speichern |
| ++r++ | Dienst neu laden |
| ++q++ | Ende |
Die Spalte Auswahl fasst zusammen, wie die Gruppe ihre Gäste findet —
Tags: produktion, alle VMs, VMIDs: 100-110. Wer viele Gruppen hat, sieht
hier auf einen Blick, wo eine Maschine hineinfallen könnte.
Eine Gruppe bearbeiten
Eine lange Maske in vier Abschnitten: Allgemein, Zeitplan, Vorhaltezeit, Welche VMs?, Snapshot-Optionen. Pfeiltasten bewegen sich, ++enter++ ändert ein Feld, ++space++ schaltet Ja/Nein um.
Zwei Zeilen darin sind keine Einstellungen, sondern Antworten:
!!! tip "Nächster Termin (Vorschau)"
```
Naechster Termin (Vorschau) Mo 10.08.2026 02:30 (taeglich um 02:30)
```
Rechnet sofort nach, was der eingestellte Zeitplan bedeutet. Damit fällt
ein Denkfehler auf, bevor er drei Wochen lang unbemerkt bleibt — etwa
`day_of_month = 31` in einem 30-Tage-Monat.
!!! tip "Trifft aktuell zu auf"
```
Trifft aktuell zu auf 6 Gast/Gaeste (100, 101, 102, 105, 110, 130)
```
Die Auswahlregeln, angewendet auf das echte Inventar — mitsamt VMIDs. Steht
dort `0 Gast/Gaeste`, ist meist ein Tag falsch geschrieben.
Oben in der Kopfzeile steht außerdem, wie die Snapshots dieser Gruppe heißen werden:
Kurzname im Snapshot: auto-taeglich-JJJJMMTT-HHMMSS
VMs aus einer Liste wählen
Auf dem Feld VMs aus Liste wählen … öffnet ++enter++ das Inventar; aus der Gruppenmaske heraus geht auch direkt ++v++:
| Taste | |
|---|---|
| ++space++ | Gast an- oder abwählen |
| ++a++ | alle |
| ++n++ | keine |
| ++i++ | Auswahl umkehren |
| ++slash++ | filtern (Name, VMID oder Tag) |
| ++enter++ | übernehmen |
Die Spalte Tags ist der eigentliche Grund, hier hereinzuschauen: Sie zeigt,
womit die Gäste in Proxmox markiert sind — und damit, ob eine Auswahl über
tags = … besser wäre als eine feste Liste von VMIDs.
!!! note "Feste Listen altern schlecht"
Eine Auswahl über VMIDs muss bei jeder neuen VM angefasst werden. Eine
Auswahl über Tags nicht. Für alles, was länger als ein paar Wochen leben
soll, sind [Tags](auswahl.md#tags) die bessere Wahl.
Globale Einstellungen
Taste ++g++ in der Gruppenliste:
Das gilt für alle Gruppen — Präfix, Prüfintervall, Wiederholungen bei belegter Sperre, Standard-Beschreibung. Was welcher Wert genau bedeutet, steht unter Alle Einstellungen.
Der wichtigste ist Testlauf (nichts wirklich tun) — das dry_run = yes der
INI-Datei. Damit protokolliert der Dienst nur, was er täte. Zum Ausprobieren
einer neuen Konfiguration ohne Risiko.
Die Übersicht
Taste ++v++ in der Gruppenliste:
Die Gegenprobe von der anderen Seite: nicht „welche Gäste hat diese Gruppe",
sondern „in welchen Gruppen steckt dieser Gast". Wer hier steht, wird
gesichert. Wer (keine Gruppe) daneben stehen hat, nicht.
Das ist der Bildschirm, den man nach jeder Änderung einmal ansehen sollte. Er deckt beide typischen Fehler auf: eine vergessene Maschine — und eine, die versehentlich in vier Gruppen gleichzeitig liegt.
!!! example "Was hier auffällt"
Im Bild trägt `build-test` das Tag `nosnap` und fällt damit überall heraus —
gewollt. Die beiden Maschinen `db01-live` und `warenwirtschaft-w` sind
laufende [Wiederherstellungen](../wiederherstellen/index.md); sie stehen
ebenfalls in keiner Gruppe, weil die monatliche Gruppe
`exclude_tags = nosnap, pvesnap-recovery` gesetzt hat.
**Das ist ein Griff, der sich lohnt.** Ohne ihn bekämen kurzlebige
Wiederherstellungsmaschinen eigene Snapshots — die dann wiederum verhindern,
dass ihre Klone sauber verworfen werden können.
Dienst neu laden
Taste ++r++ — entspricht systemctl reload pvesnap, ohne den Editor zu
verlassen. Der Editor nimmt einem dabei das Mitdenken ab:
Ungespeicherte Änderungen? → bietet vorher das Speichern an
Dienst gestoppt? → bietet das Starten an
Neuladen scheitert? → bietet einen Neustart an
Nach ++s++ fragt er ohnehin gleich, ob neu geladen werden soll. In der Kopfzeile steht jederzeit, ob der Dienst läuft.
Beim Speichern
!!! warning "Die INI-Datei wird neu geschrieben"
Eigene Kommentare gehen dabei verloren. Ein `[defaults]`-Abschnitt
ebenfalls — inhaltlich bleiben die Werte erhalten, sie stehen danach nur in
jeder Gruppe einzeln.
Eine Sicherung der alten Fassung wird als **`pvesnap.conf.bak`** abgelegt.
Wer eine handgepflegte Konfiguration mit vielen Kommentaren hat, bearbeitet sie besser weiter im Texteditor. Der ncurses-Editor ist für alle anderen da — und für die beiden Vorschauzeilen, die es im Texteditor nicht gibt.