Adds a logical-dump path so apps with a database can be backed up with zero downtime and full consistency, instead of stopping the container. - backup_db.sh: dump each declared DB live (mysqldump --single-transaction / pg_dump / sqlite3 .backup), exclude the raw data dir from the snapshot, and replay the dump on restore (pre-start rehydrate for sqlite, post-start load for server engines). - Databases are declared via a 'libreportal.backup.db' compose label so the metadata travels with the app in the snapshot. - New 'auto' strategy (now the default): live where a DB is dumpable or the app is marked live-safe, stop-snapshot-start otherwise. Explicit stop/pause/live remain as overrides. - restic/borg/kopia adapters honour an exclude list on the live path. - Manifest records the resolved per-app strategy and dumped databases. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> Signed-off-by: librelad <librelad@digitalangels.vip>
63 lines
2.1 KiB
Bash
63 lines
2.1 KiB
Bash
#!/bin/bash
|
|
|
|
kopiaBackupAppToLocation()
|
|
{
|
|
local idx="$1"
|
|
local app_name="$2"
|
|
local manifest_sha="$3"
|
|
local source_path="$containers_dir$app_name"
|
|
|
|
if [[ ! -d "$source_path" ]]; then
|
|
isError "Source path missing for $app_name: $source_path"
|
|
return 1
|
|
fi
|
|
|
|
kopiaEnvExport "$idx" || return 1
|
|
|
|
local host_tag="${CFG_INSTALL_NAME:-libreportal}"
|
|
local tags=("--tags" "app:$app_name" "--tags" "host:$host_tag" "--tags" "engine:libreportal")
|
|
[[ -n "$manifest_sha" ]] && tags+=("--tags" "manifest:$manifest_sha")
|
|
|
|
local loc_name
|
|
loc_name=$(resticLocationName "$idx")
|
|
isNotice "Snapshotting $app_name → $loc_name (kopia)"
|
|
|
|
# Kopia has no per-run --exclude; it reads .kopiaignore from the source
|
|
# tree. On the live path write the raw DB data dirs (made relative to the
|
|
# source) as ignore patterns, snapshot, then remove it so the rule never
|
|
# leaks into a later non-live backup of the same app.
|
|
local ignore_file="$source_path/.kopiaignore"
|
|
local wrote_ignore=false
|
|
if [[ -n "${backup_exclude_paths:-}" ]]; then
|
|
local rel
|
|
: | sudo tee "$ignore_file" >/dev/null
|
|
while IFS= read -r p; do
|
|
[[ -z "$p" ]] && continue
|
|
rel="/${p#"$source_path"/}"
|
|
echo "$rel" | sudo tee -a "$ignore_file" >/dev/null
|
|
done <<< "$backup_exclude_paths"
|
|
sudo chown "$docker_install_user":"$docker_install_user" "$ignore_file" 2>/dev/null
|
|
wrote_ignore=true
|
|
fi
|
|
|
|
local output
|
|
output=$(sudo -E -u "$docker_install_user" kopia snapshot create "$source_path" "${tags[@]}" --json 2>&1)
|
|
local rc=$?
|
|
|
|
[[ "$wrote_ignore" == true ]] && sudo rm -f "$ignore_file"
|
|
|
|
local snapshot_id
|
|
snapshot_id=$(echo "$output" | grep -oE '"id":\s*"[^"]+"' | head -1 | cut -d'"' -f4)
|
|
|
|
if [[ $rc -eq 0 ]]; then
|
|
isSuccessful "Backup created in $loc_name: ${snapshot_id:0:12}"
|
|
echo "$snapshot_id"
|
|
else
|
|
isError "Kopia backup to $loc_name failed for $app_name"
|
|
echo "$output" | tail -10
|
|
fi
|
|
|
|
kopiaEnvUnset
|
|
return $rc
|
|
}
|