diff --git a/Operations.md b/Operations.md new file mode 100644 index 0000000..ccfa8ee --- /dev/null +++ b/Operations.md @@ -0,0 +1,142 @@ +# Логические дампы баз + +## Зачем + +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 МБ | + +Скрипт: `/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 не дампим: это кэш, восстановление не требуется. + + +--- + +# NetBox: импорт инфраструктуры + +## Что готово + +- NetBox развёрнут: CT103, `http://192.168.1.103:8080`. +- Сайт, тип кластера и кластер создаются скриптом. +- Виртуалки и IP берутся из `pct list` и `pct config`. + +## Что мешает автоматике + +NetBox 4 требует **`API_TOKEN_PEPPERS`** и не имеет команды +`drf_create_token`. Переменная добавлена в compose, но токен +создаётся **только через веб-интерфейс**: + +1. Войти `admin` / `Netbox2026!`. +2. Меню пользователя → **API Tokens** → «Add a token». +3. Скопировать ключ в `/root/.netbox-token` на хосте. + +После этого импорт запускается одной командой: + +```bash +/opt/music-tools/venv/bin/python /root/nb_import.py +``` + +Скрипт создаёт: сайт «Buryans Home», кластер «pve», виртуалки +`ctNNN-имя` и IP-адреса с DNS-именами. + +## Ловушка + +`manage.py help` и `drf_create_token` в NetBox 4 **не работают** — +команды переименованы/удалены. Не тратьте время: токен только через UI +или через `nbshell` (тоже требует пепперы). + + +--- + +# Полная проверка системы (21.10.2026, 22:20) + +## Итог + +| Блок | Результат | +|---|---| +| Сервисы | **73/73** ✅ | +| Домены с HTTP-редиректом | **44/44** ✅ | +| SSO через Authentik | 23 | +| Свой вход/редирект | 24 | +| Сертификаты | минимум **60 дн.** (git.buryans.ru) | +| Beszel | **35/35 гостей** ✅ | +| Бэкап vzdump | 8 ч назад ✅ | +| Бэкап конфигов | 0 ч назад, 29 МБ ✅ | +| RAM | 11.8 / 15.7 ГБ (свободно 3.9) | +| Диск | 23 из 109 ГБ (22%) | +| Очередь уведомлений | пуста | +| Gitea | чисто, последний коммит на месте | + +## Таймеры (12 активны) + +| Таймер | Когда | +|---|---| +| hub-agents | каждые 30 мин | +| hub-brain | ежечасно | +| hub-mesh | **каждые 10 мин** (создан сегодня) | +| hub-digest | 12:00 | +| hub-chief | 11:50 | +| hub-finance | 09:15 | +| hub-search-index | 06:20 | +| hub-updates | 05:40 | +| hub-jf-collections | 05:30 | +| hub-actions | 04:40 | +| hub-drill | 1-го числа 04:30 | +| hub-media-maint | вс 11:00 | + +## Что исправлено в ходе проверки + +1. **Порог алерта «ВысокаяНагрузка»** был `load/cores > 2` — при общей + нагрузке срабатывал на 15 машинах одновременно. Поднят до `> 6`. + После правки: было 16 алертов, стало 1. +2. **Таймер mesh-наблюдателя отсутствовал** — скрипт запускался только + вручную. Создан `hub-mesh.timer`, каждые 10 минут. + +## Осталось разобрать + +**Алерт «СлужбаНеОтвечает: zigbee2mqtt»** — метрика `buryan_service_up` +приходит со стороны (не из Prometheus) и показывает 0, хотя порт +`192.168.1.10:8098` отвечает 200. + +- Admin API Prometheus отключён — удалить серию нельзя. +- Источник метрики надо искать в n8n-воркфлоу (healthcheck.sh её не пушит). +- Пока это ложный алерт, записан в известные проблемы. + +## Как повторить проверку + +```bash +bash /root/1-vf.sh # сервисы, таймеры, бэкапы, ресурсы +bash /root/2-vf.sh # домены, сертификаты, Beszel, уведомления, Gitea +```