Files
buryan-infra/ops/hub/HERMES-POSTGRES.md
T

99 lines
3.4 KiB
Markdown
Raw 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.
# Hermes переведён в PostgreSQL (10.11.2026)
## Причина
`/opt/hermes/hermes.db` — SQLite-файл 2.2 МБ: 8796 событий, 27 заданий.
Не входил в общий бэкап Postgres, не давал запросов по истории, и 27 заданий
писали в него параллельно.
## Что сделано
### 1. База `hermes` в PostgreSQL
```
events(id bigserial, ts, source, type, severity, title, body, dedup_key,
delivered, delivery, payload)
jobs(name pk, last_run, last_status, last_ms, runs, fails)
approvals(id bigserial, ts, kind, title, details, status)
```
Индексы `ev_ts`, `ev_dedup` сохранены.
### 2. Перенос данных
```
events перенесено: 8796
jobs перенесено: 27
approvals перенесено: 0
```
### 3. Слой совместимости
Вместо переписывания всех запросов добавлен `_PgConn`/`_PgCursor` в
`hermes.py`: принимает `?` вместо `%s`, отдаёт `lastrowid` через
`lastval()`, поддерживает `with db() as c:` с commit/rollback.
Ловушки, которые пришлось починить:
| Ошибка | Причина | Решение |
|---|---|---|
| `column "delivered" is integer but expression is boolean` | sqlite3 принимал bool как 0/1 | конвертация `bool → int` в слое |
| `column reference "runs" is ambiguous` | `runs=runs+1` в upsert | `runs=jobs.runs+1` |
## Проверка
```
hermes: active
events в Postgres: 8803
jobs: 27
events за час: 8
/health {"status":"ok","events_1h":8,"approvals_pending":0}
/events {"count":1,"items":[{"id":8808,...}]}
/metrics hermes_job_runs{job="backup-heartbeat",status="ok"} 626
Прогон задания home-heartbeat:
{"started":"home-heartbeat"} → ok, runs=3711
Запись события: id=8809 → удалено после проверки
```
## Бэкап
**Найдено при проверке:** новые базы (`rag`, `hub_state`, `hermes`) в бэкап
не попадали. `db_dumps.py` умел только контейнеры.
Добавлено: `HOST_PG_DBS = [buryan_hub, rag, hub_state, hermes]` + `dump_pg_host()`
через `pg_dump -h 192.168.1.151`.
Пробный прогон:
```
✓ buryan_hub (host): 4 КБ
✓ rag (host): 16780 КБ
✓ hub_state (host): 4 КБ
✓ hermes (host): 115 КБ
готово: ok=9, ошибок=0
```
## Итоговая картина
```
Postgres 192.168.1.151
├── hermes события(8803), задания(27) ← журнал и планировщик
├── rag chunks(5127), rag_docs(988) ← поиск по документации
├── hub_state approvals(28), media_catalog ← состояние хаба
├── buryan_hub users, roles, services ← доступы
└── … authentik, gitea, n8n, netbox, docmost
Все 9 баз — в одном бэкапе (/mnt/archive/backups/db, 14 дней).
```
## Осталось
1. SQLite-файл `hermes.db` оставлен как резерв — удалить после недели
успешной работы.
2. Книжный каталог CT111 (`polina-library.json`) — низкий приоритет.
3. Журнал агентов `.jsonl` — append-only, можно не переносить.