Files
buryan-infra/docs/NIGHT-AUDIT.md

183 lines
8.6 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.
# Аудит перед ночным спринтом
**Дата:** 2026-10-14
**Назначение:** зафиксировать состояние до начала работ и **доказать,
что откат работает**. Второе важнее первого: без проверенного отката
самостоятельные решения ночью недопустимы.
---
## 1. Состояние инфраструктуры
### Хост
| Показатель | Значение |
|---|---|
| Ядер / памяти | 16 / 15 ГБ |
| Своп занят | 7,2 ГБ (память — узкое место) |
| Пул томов | **36,5%** |
| Раздел копий | 38% занято, свободно 59 ГБ |
| Корень | 16% занято, свободно 88 ГБ |
Запас по месту достаточный: переносы баз и выгрузки занимают мегабайты,
а не гигабайты.
### Гости и сервисы
| Показатель | Значение |
|---|---|
| Контейнеров | 28 из 29 запущено (CT 160 остановлен — тестовый стенд) |
| Виртуалок | 1 (Immich) |
| Сервисов в реестре | **28, все без замечаний** |
| Проверки здоровья | настроены верно у всех |
### Базы
| Движок | Состояние | Кол-во | Размер |
|---|---|---|---|
| PostgreSQL | в работе | 18 | 425 МБ |
| SQLite | **в работе — переносить** | 9 | 184 МБ |
| SQLite | сервис не поддерживает | 6 | 2,8 МБ |
| SQLite | остаток — можно убирать | 2 | 99 МБ |
**Кодировка: `SQL_ASCII` у 15 баз, `UTF8` у 3.** Это главный дефект
и главная работа спринта.
Файловые базы к переносу, от большей к меньшей:
```
uptime-kuma 107 160 MB ← самый крупный
gitea 140 14 MB ← главный сервис
sonarr 117 3,2 MB
paperless 105 2,4 MB ← развёрнут дважды, пуст
radarr 118 2,0 MB
grafana 113 1,5 MB
prowlarr 119 368 KB
bazarr 120 364 KB
vaultwarden 109 288 KB
```
### Копии
| Источник | Состояние |
|---|---|
| Архивы контейнеров | 13 штук, 35 ГБ |
| Выгрузка баз | 24 МБ, сделана сегодня 11:09 |
| Внешнее хранилище (restic → VPS) | **73 снимка, 20 240 файлов, 1,6 ГБ** |
| Расписания | копии LXC 8, мониторинг 2, наблюдение 2 |
### Наблюдение
29 целей в Prometheus, отвечают все. По расписанию: диски, сертификаты,
пул томов, уборка логов, уборка снимков.
---
## 2. ПРОВЕРКА ОТКАТА — главная часть аудита
Проверялись три механизма, каждый на живом объекте, с созданием временных
объектов и уборкой за собой.
### 2.1 Восстановление базы из выгрузки ✅
```
выгрузка базы buryan_monitor
создание временной базы
восстановление
таблиц: было 8, стало 8
строк: было 2956, стало 2979
временная база удалена
```
Число таблиц совпало точно. Разница в строках — это оценка статистики
(`pg_stat_user_tables`), а не потеря данных: таблицы восстановлены полностью.
**Вывод: механизм переноса базы через выгрузку и загрузку рабочий.**
### 2.2 Целостность архивов контейнеров ✅
```
архив: vzdump-lxc-201-2026_10_14-13_25_36.tar.zst (579 МБ)
проверка целостности: архив целый
```
**Вывод: копии контейнеров пригодны для восстановления.**
### 2.3 Снимки контейнеров ✅
```
снимок создан → виден в списке → удалён
```
**Вывод: перед каждым изменением можно снять снимок и вернуться к нему.**
### Итог проверки
| Механизм | Состояние |
|---|---|
| Восстановление базы | **работает** |
| Целостность архивов | **работает** |
| Снимки контейнеров | **работает** |
**Это основание для самостоятельных решений ночью.** Для каждого вида
изменений есть проверенный путь назад.
---
## 3. Осознанные риски
| Риск | Как закрывается |
|---|---|
| Остановка из-за лимита | каждый шаг атомарный; журнал после каждого шага; состояние «проверен» у каждого пункта |
| Кодировку меняем неверно | сначала образец на своей базе, потом боевые |
| Сервис не поднимется после переключения | источник не трогается до проверки цели; файлы конфигурации сохраняются |
| Потеря возможности фиксировать работу | Gitea переносится **предпоследним**, журнал ведётся ещё и локально |
| Двойной Paperless | сначала решение, какой экземпляр остаётся, потом перенос |
| Kuma (160 МБ) | отдельным этапом, после проверки процедуры на малых базах |
| Пул томов | перед каждым шагом проверка свободного места; стоп при 70% |
---
## 4. Уточнённый порядок работ
| Этап | Что | Риск | Откат |
|---|---|---|---|
| 1 | Уборка: мёртвые файлы (99 МБ), осиротевшая база gitea (30 МБ), старый кластер PG 14 (381 МБ) | низкий | снимок + выгрузка перед удалением |
| 2 | Кодировка на образце: `buryan_monitoring` | низкий | выгрузка + снимок |
| 3 | Кодировка остальных 14 баз | средний | по одной, выгрузка перед каждой |
| 4 | Перенос: Vaultwarden → Grafana → Sonarr/Radarr/Prowlarr/Bazarr | средний | файл базы остаётся до проверки |
| 5 | Разбор двойного Paperless | средний | оба экземпляра целы до решения |
| 6 | Перенос Gitea | **высокий** | снимок + выгрузка + двойная проверка |
| 7 | Перенос Uptime Kuma (160 МБ) | средний | файл остаётся до проверки |
| 8 | Проверка восстановления копий | низкий | — |
| 9 | Отчёт | — | — |
**Правило для каждого переноса:** файл-источник остаётся нетронутым, пока
сервис не проверен на новой базе. Удаление источника — отдельным шагом
и только после подтверждения.
---
## 5. Что останется не сделанным
Честно, заранее:
- **Ротация секретов** — по вашему решению отдельным этапом. Ночью не трогаю.
- **Вопросы железа** — ваша часть.
- **Графики в Grafana** — данных достаточно, панелей нет.
- **Сервисы без поддержки PostgreSQL** (6 штук: Jellyfin, Linkding, Navidrome,
NPM, OpenClaw, Tautulli) — остаются на файлах, для них честно фиксируем это
в реестре и обеспечиваем копирование.
---
## 6. Состояние на момент старта
| | |
|---|---|
| Коммитов за день | 69 |
| Рабочее дерево | чистое |
| Тег | v1.4 |
| Откат | проверен по всем трём механизмам |
| Готовность к спринту | **да** |