Hacker-Software/proxmox-snapshot-service
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Handbuch auf MkDocs-Basis, mit Bildschirmfotos aus dem Programm

Browse Source 
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>
This commit is contained in:
duffyduck
2026-08-09 12:39:30 +02:00
co-authored by Claude Opus 5
parent c484596702
commit 59e7224297
72 changed files with 7355 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
handbuch/docs/bilder/config-uebersicht.svg
+24
View File
@@ -0,0 +1,24 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1042.8 634.0" width="1043" height="634" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'DejaVu Sans Mono', monospace" font-size="14.5">
<rect width="1042.8" height="634.0" rx="7" fill="#1b1e24"/>
<path d="M0 7a7 7 0 0 1 7-7h1028.8a7 7 0 0 1 7 7v23.0H0z" fill="#2b2f38"/>
<circle cx="16.0" cy="15" r="5" fill="#ed6a5e"/>
<circle cx="33.0" cy="15" r="5" fill="#f4bf4f"/>
<circle cx="50.0" cy="15" r="5" fill="#61c554"/>
<text x="521.4" y="20" fill="#9aa3b2" font-size="12" text-anchor="middle">root@pve1 — pvesnap config → Uebersicht</text>
<rect x="14.0" y="44.0" width="1006.6" height="18.4" fill="#3465a4"/>
<text x="14.0" y="57.3" fill="#eeeeec" font-weight="bold" textLength="1006.2" lengthAdjust="spacing" xml:space="preserve"> pvesnap - Uebersicht: welche VM in welcher Gruppe? </text>
<text x="14.0" y="75.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 10 Gaeste </text>
<text x="31.2" y="111.3" fill="#d3d7cf" font-weight="bold" textLength="438.6" lengthAdjust="spacing" xml:space="preserve">VMID Name Status Gruppen</text>
<text x="14.0" y="129.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 100 web01 running stuendlich, taeglich, monatlich </text>
<text x="14.0" y="147.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 101 db01 running stuendlich, taeglich, monatlich </text>
<text x="14.0" y="165.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 102 fileserver running taeglich, monatlich </text>
<text x="14.0" y="183.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 105 warenwirtschaft running taeglich, monatlich </text>
<text x="14.0" y="201.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 110 mailgw running taeglich, monatlich </text>
<text x="14.0" y="219.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 111 gitlab running monatlich </text>
<text x="14.0" y="237.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 120 build-test stopped (keine Gruppe) </text>
<text x="14.0" y="255.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 130 dc01 running taeglich, monatlich </text>
<text x="14.0" y="273.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 9101 db01-live running (keine Gruppe) </text>
<text x="14.0" y="291.3" fill="#d3d7cf" textLength="1014.8" lengthAdjust="spacing" xml:space="preserve"> 9102 warenwirtschaft-w stopped (keine Gruppe) </text>
<rect x="14.0" y="602.0" width="1006.6" height="18.4" fill="#d3d7cf"/>
<text x="14.0" y="615.3" fill="#2e3436" textLength="1006.2" lengthAdjust="spacing" xml:space="preserve"> Pfeiltasten Blaettern | r Neu laden | q zurueck </text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 3.8 KiB