Files
buryan-infra/ops/hub-core/PG-VERIFY.md
T
buryan-agent 9b94c24e6f Проверка бэкапа PostgreSQL: что реально внутри дампа
pg_verify.py считает строки в COPY-блоках критичных таблиц дампа
(pg_dumpall) и сравнивает с живой базой: пользователи и приложения
Authentik, аккаунты и события Matrix, снимки Immich, документы Paperless,
репозитории Gitea, карточки hub_core.

Проверено на свежем дампе: значимые таблицы на месте, проблем 0. Разница
в числах объясняется данными после 02:00; hub_core создана сегодня и
помечена отдельно.

Результат уходит событием backup.done/backup.failed в ядро, расписание 02:40.

Ловушка: каталог ops/backups исключён .gitignore, поэтому скрипты лежат
в ops/hub-core.
2026-10-19 20:34:51 +03:00

53 lines
2.6 KiB
Markdown

# Проверка бэкапа PostgreSQL
Ежедневный `pg_dumpall` (02:00, 37 МБ, 14 копий) — главный бэкап: в нём
все базы (Authentik, Matrix, Immich, Paperless, Gitea, hub_core).
«Файл есть» не значит «данные целы». Проверка (02:40) смотрит внутрь
дампа и сравнивает с живой базой.
## Что проверяется
| База.таблица | Зачем |
|---|---|
| `authentik_db.authentik_core_user` | пользователи SSO |
| `authentik_db.authentik_core_application` | приложения SSO |
| `matrix_db.users` / `matrix_db.events` | аккаунты и сообщения |
| `immich_db.asset` | снимки |
| `paperless_db.documents_document` | документы |
| `gitea_db.repository` | репозитории |
| `hub_core.entities` | карточки платформы |
Считаются строки внутри COPY-блоков дампа, затем те же таблицы в живой
базе. Проблема: таблицы нет в дампе, она пуста при данных в живой, или
строк меньше половины от живой.
## Результат прогона
```
authentik_db.authentik_core_user 11 12 ок
authentik_db.authentik_core_application 34 37 ок
matrix_db.users 22 30 ок
matrix_db.events 4108 4766 ок
immich_db.asset 0 0 пусто (норма)
paperless_db.documents_document 0 0 пусто (норма)
gitea_db.repository 5 5 ок
hub_core.entities None 65 базы ещё не было в дампе
проблемных: 0
```
Разница в числах — данные, появившиеся после 02:00 (боты, сообщения).
`hub_core` создана сегодня, поэтому в старом дампе её нет — это не ошибка.
## Уведомление
Результат уходит событием в ядро: `backup.done` или `backup.failed`,
дальше по маршрутизации боту Инфраструктура. Проверено: `backup.done`
записан с именем дампа.
## Ловушка репозитория
Каталог `ops/backups/` целиком в `.gitignore` (правило `backups/`),
поэтому скрипты проверки лежат в `ops/hub-core/`, а не рядом с бэкапами.