BAK-02: objekt-storage-backup-snapshots

restic statt Eigenbau (Content-defined Chunking fuer Dedup, verschluesseltes Repository ab Werk, geprueftes Tooling). internal/objectbackup wrapt restic init/backup/check/forget ueber os/exec, cmd/objectbackup-cli fuer systemd-Timer (stuendliche Sicherung, woechentliche Vollstaendigkeitspruefung, taegliche Rotation). Auf 192.168.1.131 real verifiziert (kein Mock): zweiter Lauf gegen unveraenderten Bestand ueberraegt nichts (files_new=0), zwei identische Dateien erzeugen nachweislich nur 1 data_blob (echter Dedup-Nachweis), absichtlich gekipptes Byte in einer Pack-Datei wird von check --read-data zuverlaessig erkannt. Echt verdrahtet: 3 systemd-Timer installiert+ aktiviert, jeder Dienst einmal end-to-end via systemctl start ausgeloest. Im selben Rutsch BAK-01-Fund korrigiert: NEXARCH_BACKUP_DIR zeigte auf /var/backups/nexarch (Root-Dateisystem, kein Dataset) statt auf das persistente ZFS-Dataset /var/nexarch-archiv - korrigiert, erneut ausgeloest, landet nachweislich am richtigen Ort. objectbackup-cli-Repository liegt von Anfang an korrekt dort. Siehe archive/docs/BAK-02-PRUEFPROTOKOLL.md fuer alle Pruefungsergebnisse. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ
2026-08-29 23:07:59 +02:00
parent 5e4b91c4e9
commit 10ba866f0e
12 changed files with 585 additions and 1 deletions
@@ -0,0 +1,75 @@
+// objectbackup-cli ist der Aufrufpunkt für BAK-02, für systemd-Timer
+// gedacht (siehe deploy/systemd/) — "automatisiert nach Zeitplan" entsteht
+// durch die Timer-Definition, kein eigener Dauerprozess (dieselbe
+// Begründung wie BAK-01 / cmd/backup-cli).
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"os"
+	"strconv"
+
+	"gitea.perlbach24.de/scripte/nexarch/archive/internal/objectbackup"
+)
+
+func loadConfig() objectbackup.Config {
+	cfg := objectbackup.Config{
+		RepoDir:  os.Getenv("NEXARCH_OBJECTBACKUP_REPO_DIR"),
+		Password: os.Getenv("NEXARCH_OBJECTBACKUP_PASSWORD"),
+	}
+	if cfg.RepoDir == "" || cfg.Password == "" {
+		log.Fatal("NEXARCH_OBJECTBACKUP_REPO_DIR und NEXARCH_OBJECTBACKUP_PASSWORD muessen gesetzt sein")
+	}
+	return cfg
+}
+
+func main() {
+	if len(os.Args) < 2 {
+		log.Fatal("aufruf: objectbackup-cli <backup <quellverzeichnis>|check|rotate>")
+	}
+	cfg := loadConfig()
+	ctx := context.Background()
+
+	if err := objectbackup.InitRepo(ctx, cfg); err != nil {
+		log.Fatalf("repository initialisieren: %v", err)
+	}
+
+	switch os.Args[1] {
+	case "backup":
+		if len(os.Args) < 3 {
+			log.Fatal("aufruf: objectbackup-cli backup <quellverzeichnis>")
+		}
+		summary, err := objectbackup.Backup(ctx, cfg, os.Args[2])
+		if err != nil {
+			log.Fatalf("sicherung fehlgeschlagen: %v", err)
+		}
+		if err := objectbackup.Check(ctx, cfg, false); err != nil {
+			log.Fatalf("verifikation nach sicherung fehlgeschlagen: %v", err)
+		}
+		fmt.Printf("sicherung %q erstellt und verifiziert (neu=%d geaendert=%d unveraendert=%d)\n",
+			summary.SnapshotID, summary.FilesNew, summary.FilesChanged, summary.FilesUnmodified)
+
+	case "check":
+		if err := objectbackup.Check(ctx, cfg, true); err != nil {
+			log.Fatalf("verifikation fehlgeschlagen: %v", err)
+		}
+		fmt.Println("verifikation (mit vollstaendigem lesen) erfolgreich")
+
+	case "rotate":
+		keep := 7
+		if v := os.Getenv("NEXARCH_OBJECTBACKUP_KEEP_SNAPSHOTS"); v != "" {
+			if n, err := strconv.Atoi(v); err == nil {
+				keep = n
+			}
+		}
+		if err := objectbackup.Forget(ctx, cfg, keep); err != nil {
+			log.Fatalf("rotation fehlgeschlagen: %v", err)
+		}
+		fmt.Println("rotation abgeschlossen")
+
+	default:
+		log.Fatalf("unbekannter befehl %q", os.Args[1])
+	}
+}