[A-39] Вики: страница Operations, новые сервисы

This commit is contained in:
buryan-agent committed 2026-10-22 01:31:03 +03:00
1 parent 819fc41279
commit b44fac85a1
1 file changed
+142
+142
View File
@@ -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
```