backup-manager

Backup Manager

Verify, test, and manage backups across the infrastructure.

Quick Start

Verify a Git Backup

# Clone to temp directory and check integrity
TEMP_DIR=$(mktemp -d)
git clone --bare <repo-url> "$TEMP_DIR/test-repo" 2>&1
cd "$TEMP_DIR/test-repo"
git fsck --full --no-dangling
echo "Exit code: $?"
rm -rf "$TEMP_DIR"

Check Gitea Backup Status

# List repos on Gitea
curl -s "http://<gitea-host>:3000/api/v1/user/repos" \
  -H "Authorization: token <token>" | jq '.[].name'

# Check last push time
curl -s "http://<gitea-host>:3000/api/v1/repos/<owner>/<repo>" \
  -H "Authorization: token <token>" | jq '.updated_at'

---

Backup Verification

Git Repository Integrity

# Full integrity check
git fsck --full --no-dangling

# Check for corruption
git fsck --strict

# Verify all objects are reachable
git rev-list --all --objects | wc -l

Expected: Exit code 0, no errors. Any "broken link", "missing", or "corrupt" messages indicate problems.

File Count Verification

# Compare file counts between source and backup
# Source
find /path/to/source -type f | wc -l

# Backup
find /path/to/backup -type f | wc -l

Backup Freshness

A backup is only useful if it's recent enough. Check age:

# Last commit date in a git backup
git log -1 --format="%ci"

# Age of newest file in a directory backup
find /path/to/backup -type f -printf '%T@\n' | sort -n | tail -1 | xargs -I{} date -d @{}

Freshness criteria:

• < 24h: Fresh
• 24h–72h: Acceptable (check if auto-backup is running)

• 72h: Stale (investigate why backups stopped)

---

Restore Testing

Git Restore Test

Full restore test to verify disaster recovery:

# 1. Create isolated test directory
TEST_DIR=$(mktemp -d)
echo "Testing restore in: $TEST_DIR"

# 2. Clone from backup source
git clone <backup-repo-url> "$TEST_DIR/restored" 2>&1

# 3. Verify integrity
cd "$TEST_DIR/restored"
git fsck --full

# 4. Verify structure (check key files exist)
for f in AGENTS.md APPEND_SYSTEM.md MEMORY.md; do
  if [ -f "$f" ]; then
    echo "OK: $f exists"
  else
    echo "MISSING: $f"
  fi
done

# 5. Count files
echo "Total files: $(find . -type f | wc -l)"

# 6. Cleanup
rm -rf "$TEST_DIR"