Files
proxmox-snapshot-service/handbuch/werkstatt/bin/rbd
T
duffyduckandClaude Opus 5 59e7224297 Handbuch auf MkDocs-Basis, mit Bildschirmfotos aus dem Programm
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>
2026-08-09 12:39:30 +02:00

72 lines
1.9 KiB
Python
Executable File

#!/usr/bin/env python3
"""Attrappe von `rbd` - nur lesende Auskuenfte fuer die Bildschirmfotos.
VM 9101 ist ein Linked Clone (haengt am Quell-Snapshot), VM 9102 ist bereits
geloest. Genau diese beiden Zustaende soll das Handbuch zeigen.
"""
import sys
VERBUNDEN = "vm-9101-disk-0" # haengt noch am Snapshot
QUELLE = "vmdaten/vm-101-disk-0@auto-stuendlich-20260809-100000"
# Optionen, hinter denen noch ein Wert steht - sonst haelt man "-m <monhost>"
# fuer den Befehl.
MIT_WERT = {"-m", "--id", "--keyring", "-c", "--conf", "-p", "--pool",
"--namespace", "-n", "--name"}
def zerlege(argv):
"""(Befehl, Abbild) aus der Kommandozeile."""
rest = []
index = 0
while index < len(argv):
wort = argv[index]
if wort in MIT_WERT:
index += 2
continue
if wort.startswith("-"):
index += 1
continue
rest.append(wort)
index += 1
return (rest[0] if rest else ""), (rest[1] if len(rest) > 1 else "")
def main(argv):
if not argv:
return 1
befehl, ziel = zerlege(argv)
name = ziel.split("/")[-1].split("@")[0]
if befehl == "info":
print("rbd image '%s':" % name)
print("\tsize 400 GiB in 102400 objects")
print("\torder 22 (4 MiB objects)")
print("\tsnapshot_count: 0")
print("\tid: 1f5c3d9a7b2e")
print("\tblock_name_prefix: rbd_data.1f5c3d9a7b2e")
print("\tformat: 2")
print("\tfeatures: layering, exclusive-lock")
print("\top_features:")
print("\tflags:")
if name == VERBUNDEN:
print("\tparent: %s" % QUELLE)
print("\toverlap: 400 GiB")
return 0
if befehl == "du":
print("NAME PROVISIONED USED")
print("%-19s 400 GiB 2.4 GiB" % name)
return 0
if befehl in ("flatten", "snap"):
return 0
return 0
if __name__ == "__main__":
sys.exit(main(sys.argv[1:]))