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

2.6 KiB

Проверка бэкапа 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/, а не рядом с бэкапами.