Files
buryan-infra/ops/backup/DB-DUMPS.md

101 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Логические дампы баз
## Зачем
vzdump копирует машины целиком, но не даёт быстрого восстановления
отдельной базы. Логические дампы закрывают это: `.sql.gz` можно залить
в чистую базу за минуты.
## Что дампится
| База | CT | Контейнер | Размер |
|---|---|---|---|
| netbox | 103 | netbox-postgres | 88 КБ |
| nextcloud | 109 | files_db | 514 КБ |
| monica | 110 | monica-db | 24 КБ |
| authentik | 114 | authentik-security-postgresql-1 | 1.1 МБ |
| docmost | 103 | docmost-db | 12 КБ |
Скрипт: `/opt/hub-core/db_dumps.py`
Расписание: `hub-db-dumps.timer`, ежедневно **03:15**
Каталог: `/mnt/backups/db`, хранение **14 дней**
## Как проверить
```bash
/opt/music-tools/venv/bin/python /opt/hub-core/db_dumps.py
ls -lh /mnt/backups/db
```
## Восстановление (пример для NetBox)
```bash
gunzip -c /mnt/backups/db/netbox-DATE.sql.gz | \
pct exec 103 -- docker exec -i netbox-postgres psql -U netbox -d netbox
```
## Ловушки
1. **MariaDB-контейнеры не хранят пароль в переменной `MYSQL_ROOT_PASSWORD`**
в едином виде — скрипт читает обе переменные и подставляет в `-p`.
2. **`mariadb-dump -uroot` без пароля** даёт `Access denied` — тихая
ошибка, дамп просто не создаётся.
3. Redis не дампим: это кэш, восстановление не требуется.
## Контроль thin pool (добавлено 22.10)
`agent_runner.py` теперь считает занятость `pve/data` (`thin_pool_pct`)
и печатает её в отчёте. При **≥85%** отправляется уведомление
(не чаще раза в сутки) — потому что при переполнении пула vzdump
перестаёт создавать снапшоты.
Проверка вручную:
```bash
lvs -o lv_name,data_percent pve/data
```
## Хостовые конфиги (23.10)
В архив добавлены каталоги хоста — раньше их не было вовсе:
| В архиве | Что |
|---|---|
| `host/host-nginx/` | все vhost'ы, сертификаты-ссылки (94 файла) |
| `host/host-pve/` | `jobs.cfg`, `storage.cfg`, `firewall/`, `user.cfg` |
| `host/host-systemd/` | юниты и таймеры `hub-*` |
| `host/host-vzdump-conf` | настройки vzdump |
Проверка распаковкой: 459 записей, nginx-конфиги и pve-конфиги на месте.
**Почему это важно**: при потере `/etc/nginx` пришлось бы вручную
восстанавливать 44 домена, редиректы и привязки к сертификатам.
## Бэкап VPS (23.10)
VPS — точка входа для 48 доменов. Его конфиги теперь тоже сохраняются:
| Что | Где |
|---|---|
| `/etc/nginx` (212 файлов) | `/mnt/backups/vps/vps-nginx-*.tar.gz` |
| `certbot renewal` (51 конфиг) | там же |
| Расписание | `hub-vps-backup.timer`, ежедневно 04:20 |
| Хранение | 14 дней |
Размер ~120 КБ. Забирается по SSH с VPS.
## Синхронизация сертификатов (23.10)
`hub-cert-sync.timer` (ежедневно 04:10) копирует обновлённые сертификаты
с VPS в `/etc/nginx/certs/<домен>/` и перезагружает nginx, если что-то
изменилось.
**Проверено сквозным тестом**: принудительно обновил сертификат
`grafana.buryans.ru` на VPS (`certbot renew --force-renewal`), затем
запустил синхронизацию — дома сертификат обновился, `nginx -t` прошёл,
сайт отдал 302 (редирект на SSO). Контрольные суммы дома и на VPS совпали.
Без этой синхронизации через ~59 дней домены начали бы отдавать
просроченный сертификат: certbot на VPS обновлял файлы в
`/etc/letsencrypt/live/`, а домашний nginx использует свои копии.