Snapshots anzulegen half bisher nur halb - an die Daten darin kam man nur
ueber einen Rollback. Dafuer jetzt zwei Werkzeuge auf gemeinsamer Basis.
snapfs.py bindet einen Snapshot schreibgeschuetzt ein und liefert einen
gewoehnlichen Pfad; die Oberflaechen wissen dadurch nichts ueber Storages:
rbd (Ceph) rbd map pool/image@snap, bei nicht unterstuetzten
Image-Features faellt es auf rbd-nbd zurueck
zfspool Container ueber .zfs/snapshot, VMs ueber einen Klon
lvmthin/lvm die Snapshot-LV snap_<volume>_<snapname> aktivieren
dir/nfs/cifs qemu-nbd --load-snapshot (nur qcow2)
Gemountet wird mit ro,noload bzw. ro,norecovery,nouuid - Snapshots
laufender Gaeste haben fast immer ein unsauberes Journal. Alles Angelegte
steht in /run/pvesnap/explorer.json und laesst sich nach einem Absturz mit
"--cleanup" wieder abraeumen.
pvesnap-explorer: zwei Fenster wie im Midnight Commander, links der
Snapshot, rechts der lokale Rechner. Markieren, F5, Fortschrittsbalken,
ESC bricht ab, vorhandene Dateien werden abgefragt. In den Snapshot hinein
kann nicht kopiert werden. Geraetedateien und Sockets werden
uebersprungen, symbolische Verweise bleiben Verweise.
pvesnap-web: derselbe Inhalt im Browser, auch vom anderen Rechner.
Einzelne Dateien direkt, Verzeichnisse und Mehrfachauswahl als ZIP, das im
Strom erzeugt wird - ohne Zwischendatei auf der Platte. Zugang nur mit dem
beim Start ausgegebenen Schluessel; Pfade ausserhalb des Snapshots werden
abgewiesen; es wird ausschliesslich gelesen.
Nebenbei: die curses-Bausteine sind aus tui.py nach curses_util.py
gewandert, damit Editor und Explorer sie teilen.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
144 lines
4.9 KiB
Bash
Executable File
144 lines
4.9 KiB
Bash
Executable File
#!/bin/bash
|
|
# ---------------------------------------------------------------------
|
|
# pvesnap - Installation
|
|
#
|
|
# ./install.sh installieren, Dienst aktivieren und starten
|
|
# ./install.sh --no-start installieren, aber Dienst nicht starten
|
|
# ./install.sh --force auch ohne erkanntes Proxmox VE installieren
|
|
# ---------------------------------------------------------------------
|
|
set -euo pipefail
|
|
|
|
LIB_DIR="/usr/lib/pvesnap"
|
|
BIN="/usr/local/bin/pvesnap"
|
|
CONF_DIR="/etc/pvesnap"
|
|
CONF="${CONF_DIR}/pvesnap.conf"
|
|
STATE_DIR="/var/lib/pvesnap"
|
|
DOC_DIR="/usr/share/doc/pvesnap"
|
|
UNIT="/etc/systemd/system/pvesnap.service"
|
|
SRC="$(cd "$(dirname "$0")" && pwd)"
|
|
|
|
START=1
|
|
FORCE=0
|
|
for arg in "$@"; do
|
|
case "$arg" in
|
|
--no-start) START=0 ;;
|
|
--force) FORCE=1 ;;
|
|
-h|--help) sed -n '2,8p' "$0" | sed 's/^#[[:space:]]\{0,1\}//'; exit 0 ;;
|
|
*) echo "Unbekannte Option: $arg" >&2; exit 1 ;;
|
|
esac
|
|
done
|
|
|
|
info() { printf '\033[1;32m==>\033[0m %s\n' "$*"; }
|
|
warn() { printf '\033[1;33m==>\033[0m %s\n' "$*" >&2; }
|
|
fail() { printf '\033[1;31m==>\033[0m %s\n' "$*" >&2; exit 1; }
|
|
|
|
[ "$(id -u)" -eq 0 ] || fail "Bitte als root ausfuehren (sudo ./install.sh)."
|
|
|
|
command -v python3 >/dev/null 2>&1 || fail "python3 wird benoetigt."
|
|
python3 - <<'PY' || fail "Python 3.7 oder neuer wird benoetigt."
|
|
import sys
|
|
sys.exit(0 if sys.version_info >= (3, 7) else 1)
|
|
PY
|
|
|
|
if ! command -v pvesh >/dev/null 2>&1; then
|
|
if [ "$FORCE" -eq 1 ]; then
|
|
warn "pvesh nicht gefunden - installiere trotzdem (--force)."
|
|
START=0
|
|
else
|
|
fail "pvesh nicht gefunden. pvesnap gehoert auf einen Proxmox-VE-Host.
|
|
Mit --force laesst sich die Installation trotzdem erzwingen."
|
|
fi
|
|
fi
|
|
|
|
command -v systemctl >/dev/null 2>&1 || fail "systemd wird benoetigt."
|
|
[ -d "${SRC}/pvesnap" ] || fail "Verzeichnis 'pvesnap' nicht gefunden (Aufruf aus dem Projektordner?)."
|
|
|
|
# --- Programm ---------------------------------------------------------
|
|
info "Installiere Programm nach ${LIB_DIR}"
|
|
rm -rf "${LIB_DIR}/pvesnap"
|
|
install -d -m 0755 "${LIB_DIR}"
|
|
cp -r "${SRC}/pvesnap" "${LIB_DIR}/pvesnap"
|
|
find "${LIB_DIR}/pvesnap" -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
|
|
chmod -R go-w "${LIB_DIR}/pvesnap"
|
|
|
|
info "Installiere Startbefehle"
|
|
install_command() { # $1 = Befehlsname, $2 = Python-Modul
|
|
cat > "/usr/local/bin/$1" <<EOF
|
|
#!/bin/sh
|
|
# von install.sh erzeugt
|
|
PYTHONPATH="${LIB_DIR}\${PYTHONPATH:+:\$PYTHONPATH}" exec /usr/bin/python3 -m $2 "\$@"
|
|
EOF
|
|
chmod 0755 "/usr/local/bin/$1"
|
|
info " /usr/local/bin/$1"
|
|
}
|
|
install_command pvesnap pvesnap
|
|
install_command pvesnap-explorer pvesnap.explorer
|
|
install_command pvesnap-web pvesnap.web
|
|
|
|
# --- Konfiguration ----------------------------------------------------
|
|
install -d -m 0755 "${CONF_DIR}" "${STATE_DIR}" "${DOC_DIR}"
|
|
if [ -f "${CONF}" ]; then
|
|
info "Vorhandene Konfiguration bleibt unveraendert: ${CONF}"
|
|
install -m 0644 "${SRC}/config/pvesnap.conf.example" "${CONF_DIR}/pvesnap.conf.example"
|
|
else
|
|
info "Lege Beispielkonfiguration an: ${CONF}"
|
|
install -m 0640 "${SRC}/config/pvesnap.conf.example" "${CONF}"
|
|
install -m 0644 "${SRC}/config/pvesnap.conf.example" "${CONF_DIR}/pvesnap.conf.example"
|
|
NEW_CONFIG=1
|
|
fi
|
|
if [ -f "${SRC}/README.md" ]; then
|
|
install -m 0644 "${SRC}/README.md" "${DOC_DIR}/README.md"
|
|
fi
|
|
|
|
# --- systemd ----------------------------------------------------------
|
|
info "Installiere systemd-Unit ${UNIT}"
|
|
install -m 0644 "${SRC}/systemd/pvesnap.service" "${UNIT}"
|
|
systemctl daemon-reload
|
|
|
|
info "Pruefe Konfiguration"
|
|
if ! "${BIN}" --config "${CONF}" check; then
|
|
warn "Die Konfiguration ist noch nicht vollstaendig - Dienst wird nicht gestartet."
|
|
START=0
|
|
fi
|
|
|
|
if systemctl enable pvesnap.service >/dev/null 2>&1; then
|
|
info "Dienst beim Systemstart aktiviert"
|
|
else
|
|
warn "Dienst konnte nicht aktiviert werden - bitte 'systemctl enable pvesnap' pruefen."
|
|
fi
|
|
|
|
if [ "$START" -eq 1 ]; then
|
|
info "Starte Dienst"
|
|
systemctl restart pvesnap.service
|
|
sleep 1
|
|
systemctl --no-pager --lines=5 status pvesnap.service || true
|
|
else
|
|
warn "Dienst wurde nicht gestartet."
|
|
fi
|
|
|
|
cat <<EOF
|
|
|
|
Fertig.
|
|
|
|
Konfiguration bearbeiten : pvesnap config (ncurses-Editor)
|
|
nano ${CONF}
|
|
Konfiguration pruefen : pvesnap check
|
|
Uebersicht : pvesnap status
|
|
VMs und Gruppen : pvesnap vms
|
|
Testlauf ohne Aenderung : pvesnap run --force --dry-run
|
|
Nach Aenderungen : systemctl reload pvesnap
|
|
Protokoll : journalctl -u pvesnap -f
|
|
|
|
Dateien aus einem Snapshot holen:
|
|
pvesnap-explorer zwei Fenster wie im Midnight Commander
|
|
pvesnap-web im Browser durchsehen und herunterladen
|
|
EOF
|
|
|
|
if [ "${NEW_CONFIG:-0}" -eq 1 ]; then
|
|
cat <<EOF
|
|
|
|
Hinweis: In der Beispielkonfiguration sind alle Gruppen mit "enabled = no"
|
|
angelegt. Erst nach dem Aktivieren einer Gruppe werden Snapshots erstellt.
|
|
EOF
|
|
fi
|