Marek Miklewicz
65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
# borg-restore 2.x - state snapshot
|
|
|
|
## Current state
|
|
- Working dir: `borg-restore_2x/borg-restore`
|
|
- Latest version in `plugin.conf`: `2.0.7`
|
|
- Latest package: `borg-restore_2x/2.0.7/borg-restore.tar.gz`
|
|
|
|
## Packaging layout (required)
|
|
- Source (editable): `borg-restore_2x/borg-restore/`
|
|
- Packages: `borg-restore_2x/<version>/borg-restore.tar.gz`
|
|
|
|
## Key behavior (current)
|
|
- Restore types:
|
|
- `web` (Pliki www)
|
|
- `mail` (Zawartosc skrzynki pocztowej)
|
|
- Restore modes:
|
|
- `location` (przywracanie do lokalizacji)
|
|
- `overwrite` (nadpisywanie)
|
|
- `update` (scalenie; UI label: "Polaczenie danych kopii zapasowej z obecnymi danymi")
|
|
- For mail merge:
|
|
- rsync excludes Dovecot indexes and can optionally delete them after merge.
|
|
- Target path picker (location mode) is limited to `/home/DA_USER`.
|
|
- Restore path restriction (if enabled) is applied only to restore path and overwrite/update.
|
|
- Warning modal uses pink background; overlay uses transparent dark scrim.
|
|
|
|
## Config (plugin-settings.conf)
|
|
- `BB_PATH=/opt/bb`
|
|
- `BORG_PATH=/usr/bin/borg`
|
|
- `BORG_VARIABLES_FILE=/opt/bb/bbvars.sh`
|
|
- `WEB_RESTORE_LOCATION=/home/DA_USER/domains`
|
|
- `MAIL_RESTORE_LOCATION=/home/DA_USER/imap`
|
|
- `DEFAULT_RESTORE_DESTINATION=/home/DA_USER/bb`
|
|
- `BLOCK_RESTORE_OUTSIDE_LOCATION=TRUE`
|
|
- `PREVENT_RESTORE_MAIN_DOMAINS_DIR=TRUE`
|
|
- `PREVENT_RESTORE_MAIN_IMAP_DIR=TRUE`
|
|
- `CLEAR_DOVECOT_INDEXES_AFTER_MERGE=TRUE`
|
|
- `RESTORE_PATH_MODE=full`
|
|
|
|
## Notable logic changes
|
|
- Mail merge uses rsync with excludes for:
|
|
- `dovecot.index*`, `dovecot-uidlist`, `dovecot-uidvalidity`,
|
|
`dovecot.list.index*`, `dovecot.list.log`
|
|
- Optional cleanup of these indexes after merge if config flag is TRUE.
|
|
- Logs: lines containing "Permanently added" and "known host" are filtered out of user-facing logs.
|
|
- New config flags to allow/deny restoring whole `/home/DA_USER/domains` and `/home/DA_USER/imap`.
|
|
- Default target path for location mode uses `DEFAULT_RESTORE_DESTINATION`.
|
|
- Picker: creating a new dir jumps into it.
|
|
|
|
## CSS/UI
|
|
- Overlay: `rgba(15, 23, 42, 0.35)`
|
|
- Warning modal: class `br-modal-warning` with background `#f3c8c8`
|
|
- Picker modal: white background (default `.br-modal`)
|
|
|
|
## Recent files touched
|
|
- `borg-restore_2x/borg-restore/user/index.html`
|
|
- `borg-restore_2x/borg-restore/scripts/restore.sh`
|
|
- `borg-restore_2x/borg-restore/plugin-settings.conf`
|
|
- `borg-restore_2x/borg-restore/user/enhanced.css`
|
|
- `borg-restore_2x/borg-restore/user/evolution.css`
|
|
|
|
## Next step template (for new chat)
|
|
- "Pracujemy w `borg-restore_2x/borg-restore/`. Aktualna wersja w plugin.conf: 2.0.7."
|
|
- "Ostatnia paczka: `borg-restore_2x/2.0.7/borg-restore.tar.gz`."
|
|
- "Cel: <opis zmiany>."
|