refactor(hosts): organize repository by server profiles (hosts/raspberrypi5, hosts/llm-node) and add host-aware installer

This commit is contained in:
Lars committed 2026-10-29 14:27:49 +01:00
1 parent c53fc0a939
commit c2740c9542
44 files changed
+528 -40

No files matched your search

+91
View File
@@ -0,0 +1,91 @@
#!/usr/bin/env bash
set -Eeuo pipefail
umask 077
# Verwendung:
# db-mariadb-docker.sh CONTAINER DATEINAME mariadb|mysql
if [[ $# -ne 3 ]]; then
echo "FEHLER: Drei Parameter erforderlich" >&2
exit 2
fi
CONTAINER="$1"
FILENAME="$2"
PROFILE="$3"
BACKUP_DIR="/media/lars/paperless/db-backup"
[[ "$FILENAME" =~ ^[a-zA-Z0-9_-]+\.sql$ ]] || exit 2
[[ -d "$BACKUP_DIR" && -w "$BACKUP_DIR" ]] || {
echo "FEHLER: Backup-Verzeichnis nicht verfuegbar" >&2
exit 1
}
TARGET="$BACKUP_DIR/$FILENAME"
TEMP="$(mktemp "$BACKUP_DIR/.${FILENAME}.XXXXXXXX")"
trap 'rm -f -- "$TEMP"' EXIT
echo "Starte MariaDB-Export: $CONTAINER"
case "$PROFILE" in
mariadb)
docker exec "$CONTAINER" sh -ec '
: "${MARIADB_USER:?Benutzer fehlt}"
: "${MARIADB_PASSWORD:?Passwort fehlt}"
: "${MARIADB_DATABASE:?Datenbank fehlt}"
export MYSQL_PWD="$MARIADB_PASSWORD"
exec mariadb-dump \
--host=127.0.0.1 \
--user="$MARIADB_USER" \
--single-transaction \
--quick \
--routines \
--events \
--triggers \
--databases "$MARIADB_DATABASE"
' > "$TEMP"
;;
mysql)
docker exec "$CONTAINER" sh -ec '
: "${MYSQL_USER:?Benutzer fehlt}"
: "${MYSQL_PASSWORD:?Passwort fehlt}"
: "${MYSQL_DATABASE:?Datenbank fehlt}"
export MYSQL_PWD="$MYSQL_PASSWORD"
exec mariadb-dump \
--host=127.0.0.1 \
--user="$MYSQL_USER" \
--single-transaction \
--quick \
--routines \
--events \
--triggers \
--databases "$MYSQL_DATABASE"
' > "$TEMP"
;;
*)
echo "FEHLER: Unbekanntes Profil" >&2
exit 2
;;
esac
[[ -s "$TEMP" ]] || {
echo "FEHLER: Dump ist leer" >&2
exit 1
}
chgrp lars "$TEMP"
chmod 640 "$TEMP"
mv -f -- "$TEMP" "$TARGET"
echo "OK: $TARGET"
stat -c 'Groesse: %s Bytes' "$TARGET"
+80
View File
@@ -0,0 +1,80 @@
#!/usr/bin/env bash
set -Eeuo pipefail
umask 077
# Verwendung:
# db-postgres-docker.sh CONTAINER DATEINAME
# db-postgres-docker.sh CONTAINER DATEINAME DB_USER DB_NAME
BACKUP_DIR="/media/lars/paperless/db-backup"
if [[ $# -ne 2 && $# -ne 4 ]]; then
echo "FEHLER: Ungueltige Parameteranzahl" >&2
exit 2
fi
CONTAINER="$1"
FILENAME="$2"
if [[ ! "$FILENAME" =~ ^[a-zA-Z0-9_-]+\.sql$ ]]; then
echo "FEHLER: Ungueltiger Dateiname" >&2
exit 2
fi
if [[ ! -d "$BACKUP_DIR" || ! -w "$BACKUP_DIR" ]]; then
echo "FEHLER: Backup-Verzeichnis nicht verfuegbar" >&2
exit 1
fi
TARGET="$BACKUP_DIR/$FILENAME"
TEMP_FILE="$(mktemp "$BACKUP_DIR/.${FILENAME}.XXXXXXXX")"
trap 'rm -f -- "$TEMP_FILE"' EXIT
echo "Starte PostgreSQL-Backup: $CONTAINER"
# Standard: Datenbankparameter aus Container-Umgebung.
# Ausnahme: explizite Parameter, z.B. Mitai Dev.
if [[ $# -eq 2 ]]; then
CMD=(
docker exec "$CONTAINER"
sh -ec '
: "${POSTGRES_USER:?POSTGRES_USER fehlt}"
: "${POSTGRES_DB:?POSTGRES_DB fehlt}"
export PGPASSWORD="${POSTGRES_PASSWORD:-}"
exec pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB"
'
)
else
CMD=(
docker exec "$CONTAINER"
pg_dump -U "$3" "$4"
)
fi
if "${CMD[@]}" > "$TEMP_FILE"; then
echo "Datenbankexport abgeschlossen"
else
RC=$?
echo "FEHLER: pg_dump fehlgeschlagen (Code $RC)" >&2
exit "$RC"
fi
if [[ ! -s "$TEMP_FILE" ]]; then
echo "FEHLER: Datenbank-Dump ist leer" >&2
exit 1
fi
# Auch der Benutzer lars muss die Dateien spaeter
# mit dem NAS-Kopierskript lesen koennen.
chgrp lars "$TEMP_FILE"
chmod 640 "$TEMP_FILE"
# Atomarer Austausch auf demselben Dateisystem.
mv -f -- "$TEMP_FILE" "$TARGET"
echo "OK: $TARGET"
stat -c 'Groesse: %s Bytes' "$TARGET"
exit 0
+66
View File
@@ -0,0 +1,66 @@
#!/usr/bin/env bash
# ============================================================================
# publish-backup-set.sh
# Atomically publishes a complete Backup Set (Dump + .sha256 + .manifest.json
# + optional .media.jsonl) to the NAS generation archive and rotates old sets.
# Implements RECOVERY_CONTRACT.md section 5.1 & 5.2.
# ============================================================================
set -Eeuo pipefail
umask 027
if [[ $# -lt 3 ]]; then
echo "Verwendung: $0 <TARGET_ID> <DUMP_DATEI> <ARCHIVE_ROOT>" >&2
exit 2
fi
TARGET_ID="$1"
DUMP_FILE="$2"
ARCHIVE_ROOT="$3"
SHA_FILE="${DUMP_FILE}.sha256"
MANIFEST_FILE="${DUMP_FILE}.manifest.json"
MEDIA_FILE="${DUMP_FILE}.media.jsonl"
[[ -s "$DUMP_FILE" ]] || { echo "FEHLER: Dump fehlt oder ist leer: $DUMP_FILE" >&2; exit 2; }
[[ -s "$SHA_FILE" ]] || { echo "FEHLER: SHA256-Datei fehlt: $SHA_FILE" >&2; exit 2; }
[[ -s "$MANIFEST_FILE" ]] || { echo "FEHLER: Manifest-Datei fehlt: $MANIFEST_FILE" >&2; exit 2; }
# Verify checksum before publishing
(
cd "$(dirname "$DUMP_FILE")"
sha256sum -c "$(basename "$SHA_FILE")" >/dev/null
) || {
echo "FEHLER: SHA256-Pruefsumme stimmt nicht!" >&2
exit 4
}
TIMESTAMP="$(date +%Y%m%d-%H%M%S)"
TARGET_DIR="$ARCHIVE_ROOT/$TARGET_ID"
mkdir -p "$TARGET_DIR"
STAGING_DIR="$(mktemp -d "$TARGET_DIR/.staging-${TIMESTAMP}.XXXXXXXX")"
FINAL_DIR="$TARGET_DIR/$TIMESTAMP"
cleanup() {
if [[ -n "${STAGING_DIR:-}" && -d "$STAGING_DIR" ]]; then
rm -rf -- "$STAGING_DIR" || true
fi
}
trap cleanup EXIT
cp -p -- "$DUMP_FILE" "$STAGING_DIR/"
cp -p -- "$SHA_FILE" "$STAGING_DIR/"
cp -p -- "$MANIFEST_FILE" "$STAGING_DIR/"
if [[ -f "$MEDIA_FILE" ]]; then
cp -p -- "$MEDIA_FILE" "$STAGING_DIR/"
fi
mv -T -- "$STAGING_DIR" "$FINAL_DIR"
STAGING_DIR=""
TEMP_LINK="$TARGET_DIR/.latest-$$"
ln -s -- "$FINAL_DIR" "$TEMP_LINK"
mv -Tf -- "$TEMP_LINK" "$TARGET_DIR/latest"
echo "OK: Backup-Satz veroeffentlicht unter $FINAL_DIR (latest aktualisiert)"
exit 0