diff --git a/10-systems/services/hard-panel.md b/10-systems/services/hard-panel.md index e8a942c..de27323 100644 --- a/10-systems/services/hard-panel.md +++ b/10-systems/services/hard-panel.md @@ -1,7 +1,7 @@ --- owner: gmikcon status: active -last_reviewed: 2026-09-10 +last_reviewed: 2026-09-11 review_interval: 90d confidence: high source_of_truth: deployment-verified @@ -9,7 +9,7 @@ # hard-panel (GHard Monitor) -Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). +Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через `os.statvfs`). - Репозиторий: `https://git.gnexus.space/root/hard-panel` - Хост: VM `service` на `hp-proliant-dl380-g6`, адрес `192.168.1.176` @@ -66,6 +66,64 @@ - `alex` (192.168.105.195) — изолированная сеть 105.x, панель недостижима. - pfSense (.1), klipper (.102), gbook (ноут, offline), IoT-сеть 192.168.2.0/24 — не серверы. +## Сетевые шары (Storage) + +Панель умеет мониторить сетевые диски: пробер на хосте панели делает `os.statvfs` по зарегистрированным путям и пишет историю (таблица `share_samples`). Шара считается offline, если нет замера дольше `max(share_interval*3, 180)` секунд. + +Текущие шары (добавлены 2026-09-11, все online): + +| Имя на панели | NFS-экспорт | Точка монтирования на .176 | Заполнено | +| --- | --- | --- | --- | +| secraid5-jellyfin-storage | 192.168.1.130:/mnt/secraid5/jellyfin_storage | /mnt/nas/secraid5-jf | ~89% | +| secraid5-jellyfin-cache | 192.168.1.130:/mnt/secraid5/jellyfin_cache | /mnt/nas/secraid5-cache | ~0.1% | +| firstraid5 | 192.168.1.130:/mnt/firstraid5 | /mnt/nas/firstraid5 | ~90% | +| NetTera8 | 192.168.1.131:/mnt/NetTera8 | /mnt/nas/nettera8 | ~93% | + +Монтирование на .176: nfs-common, fstab-записи с `_netdev,nofail,vers=3` (бэкап `/root/fstab.backup`). В контейнер шары проброшены bind-mount с propagation `:slave` в `docker-compose.yml` — хостовые NFS-монты автоматически видны внутри контейнера. + +### Как добавить новую шару (руководство) + +1. **Смонтировать на хосте .176** (root): + + ```bash + apt-get install -y nfs-common + mkdir -p /mnt/nas/<имя> + echo "192.168.1.XXX:/экспорт /mnt/nas/<имя> nfs defaults,_netdev,nofail,vers=3 0 0" >> /etc/fstab + mount -a && df -h /mnt/nas/<имя> # проверить + ``` + +2. **Пробросить в контейнер**: в `/opt/hard-panel/docker-compose.yml` в секцию `volumes:` сервиса `panel` добавить строку: + + ```yaml + - /mnt/nas/<имя>:/mnt/nas/<имя>:slave + ``` + + и пересоздать контейнер (порядок важен — обычный `up -d --build` падает с KeyError 'ContainerConfig' на старом docker-compose 1.29): + + ```bash + cd /opt/hard-panel && docker-compose down && docker-compose up -d --build + ``` + + Проверка: `curl http://localhost:8000/api/v1/health` и `curl -s http://localhost:8000/api/v1/servers | grep -c online` (должно быть 18). + +3. **Зарегистрировать шару в панели**: + + ```bash + curl -s -X POST http://192.168.1.176:8000/api/v1/shares \ + -H "Content-Type: application/json" \ + -d '{"name": "<имя>", "path": "/mnt/nas/<имя>"}' + ``` + + (если включён GHARD_ADMIN_TOKEN — добавить заголовок `Authorization: Bearer <токен>`; UI-путь: кнопка Add share в разделе Storage). + +4. **Проверить замер**: подождать ~1 минуту (интервал пробера), затем: + + ```bash + curl -s http://192.168.1.176:8000/api/v1/shares | python3 -m json.tool + ``` + + Статус должен стать `online`, появятся `total`/`used`. Если `offline` — проверить, что шара смонтирована на хосте и видна в контейнере: `docker exec ghard-panel stat -f /mnt/nas/<имя>`. + ## Массовый деплой (как сделано) С хоста .176 (root): `sshpass` + скрипт `/root/deploy-hard-monitor.sh` (и `/root/fix-remaining.sh` для отставших). Логика: DELETE старой записи на панели → POST новой (ключ ghm_ показывается один раз) → scp файлов агента из `/opt/hard-monitor-src` → `install.sh PANEL KEY 30` через sudo. @@ -86,3 +144,4 @@ - 2026-09-10: панель развёрнута (docker-compose build), агент установлен на сам хост, сервер `hard-panel-176` online. Root-SSH на VM включён (PermitRootLogin yes, пароль задан). - 2026-09-10: UI показывал пустой список — причина: заданный GHARD_ADMIN_TOKEN, который UI не подписывает. Токен отключён, compose-дефолт исправлен на `${GHARD_ADMIN_TOKEN-}`. Проверено: `GET /api/v1/servers` без токена отдаёт `hard-panel-176 online`. - 2026-09-10: массовый деплой агентов — 18/18 серверов online (16 VM DL380 + navi + панель). Скрипты: `/root/deploy-hard-monitor.sh`, `/root/fix-remaining.sh` на .176. +- 2026-09-11: обновление панели до версии с мониторингом шар (git pull, edb6cff). Смонтированы 4 NFS-шары (secraid5-jf, secraid5-cache, firstraid5, nettera8), проброшены в контейнер с `:slave`, добавлены в мониторинг — все online. diff --git a/90-maintenance/pending-changes/20260911073052-59764fb0.json b/90-maintenance/pending-changes/20260911073052-59764fb0.json new file mode 100644 index 0000000..0a20a71 --- /dev/null +++ b/90-maintenance/pending-changes/20260911073052-59764fb0.json @@ -0,0 +1,19 @@ +{ + "id": "20260911073052-59764fb0", + "kind": "doc", + "target": "10-systems/services/hard-panel.md", + "summary": "Мониторинг NFS-шар: 4 шары online, руководство по добавлению", + "reason": "Добавлен раздел про мониторинг сетевых шар: текущие 4 шары, пошаговое руководство как добавить новую (mount → compose bind-mount :slave → POST /api/v1/shares → проверка), грабли с docker-compose down/up.", + "payload": { + "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-09-11\nreview_interval: 90d\nconfidence: high\nsource_of_truth: deployment-verified\n---\n\n# hard-panel (GHard Monitor)\n\nПанель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через `os.statvfs`).\n\n- Репозиторий: `https://git.gnexus.space/root/hard-panel`\n- Хост: VM `service` на `hp-proliant-dl380-g6`, адрес `192.168.1.176`\n- SSH: `root` / пароль в gnexus-creds (секрет `hard-panel (192.168.1.176)`), также `ubuntu` с тем же паролем\n- ОС: Ubuntu 22.04.5 LTS, 4 GB RAM, 31 GB диск\n\n## Панель\n\n- Docker Compose: `/opt/hard-panel/docker-compose.yml`, контейнер `ghard-panel`\n- Порт: `8000` (HTTP, без TLS — доступ только из LAN)\n- Конфиг: `/opt/hard-panel/.env` (GHARD_ADMIN_TOKEN, GHARD_DATABASE_PATH=/data/hard-panel.db, GHARD_OFFLINE_MULTIPLIER=3)\n- Данные: docker volume `panel-data` (SQLite, WAL)\n- Health: `http://192.168.1.176:8000/api/v1/health` → `{\"status\":\"ok\"}`\n- UI: `http://192.168.1.176:8000/` (без логина)\n- API: `http://192.168.1.176:8000/docs` (OpenAPI)\n- MCP: `http://192.168.1.176:8000/mcp` (streamable HTTP; инструменты `panel_overview`, `server_details`, `server_history`)\n- Логи: `docker logs ghard-panel`\n\n## Важно про GHARD_ADMIN_TOKEN\n\n- Веб-интерфейс не умеет подписывать запросы токеном (`panel/frontend/src/api.js`): если токен задан, UI получает 401 и показывает пустой список серверов.\n- В `docker-compose.yml` дефолт `${GHARD_ADMIN_TOKEN:-change-me}` подставляет `change-me` даже при пустой переменной в `.env`. Локально исправлено на строгую форму `${GHARD_ADMIN_TOKEN-}` (2026-09-10) — при `git pull` проверить, не вернулся ли старый синтаксис.\n- Текущее состояние: токен пустой (API и UI открыты, доступ только из LAN). Если панель когда-нибудь выйдет в интернет — задать токен и закрыть `/mcp` на reverse proxy.\n- Старый сгенерированный токен хранится в gnexus-creds (секрет `hard-panel (192.168.1.176)`, поле `admin_token`) на случай, если токен снова включат.\n\n## Агенты (fleet, 2026-09-10)\n\nАгент hard-monitor установлен на все серверы home LAN. Все 18 серверов online (интервал 30 с):\n\n| Сервер на панели | Хост | IP | Примечание |\n| --- | --- | --- | --- |\n| hard-panel-176 | VM service | 192.168.1.176 | сама панель |\n| navi | VM navi | 192.168.1.168 | локальная машина Navi |\n| gnbook | VM gnbook | 192.168.1.170 | |\n| gnauth | VM gnauth | 192.168.1.167 | |\n| gncreds | VM gncreds | 192.168.1.173 | |\n| gnexus-home | VM gnexus-home | 192.168.1.151 | диск был 100%, почищен apt-кэш/журналы |\n| nextcloud | VM nextcloud | 192.168.1.152 | |\n| transmission | VM transmission | 192.168.1.154 | |\n| files | VM files | 192.168.1.157 | |\n| gitbucket | VM gitbucket | 192.168.1.156 | Ubuntu 18.04, py3.6 — venv на python3.8 + python3.8-dev |\n| ovpn | VM ovpn | 192.168.1.150 | |\n| vmk | VM vmk (tgbots) | 192.168.1.178 | |\n| jellyfin | VM jellyfin | 192.168.1.153 | |\n| mine | VM mine | 192.168.1.160 | |\n| fuckjira | VM fuckjira | 192.168.1.175 | |\n| mctl | VM mctl | 192.168.1.169 | |\n| home | VM home | 192.168.1.159 | |\n| internal-proxy | VM ovpn_reserv | 192.168.1.226 | |\n\nНе охвачены (нет доступа или нецелевые):\n\n- `192.168.1.129` и `192.168.1.131` — неидентифицированные хосты, SSH с известными паролями отклонён (Permission denied). Добавить агента, когда появятся креды.\n- `alex` (192.168.105.195) — изолированная сеть 105.x, панель недостижима.\n- pfSense (.1), klipper (.102), gbook (ноут, offline), IoT-сеть 192.168.2.0/24 — не серверы.\n\n## Сетевые шары (Storage)\n\nПанель умеет мониторить сетевые диски: пробер на хосте панели делает `os.statvfs` по зарегистрированным путям и пишет историю (таблица `share_samples`). Шара считается offline, если нет замера дольше `max(share_interval*3, 180)` секунд.\n\nТекущие шары (добавлены 2026-09-11, все online):\n\n| Имя на панели | NFS-экспорт | Точка монтирования на .176 | Заполнено |\n| --- | --- | --- | --- |\n| secraid5-jellyfin-storage | 192.168.1.130:/mnt/secraid5/jellyfin_storage | /mnt/nas/secraid5-jf | ~89% |\n| secraid5-jellyfin-cache | 192.168.1.130:/mnt/secraid5/jellyfin_cache | /mnt/nas/secraid5-cache | ~0.1% |\n| firstraid5 | 192.168.1.130:/mnt/firstraid5 | /mnt/nas/firstraid5 | ~90% |\n| NetTera8 | 192.168.1.131:/mnt/NetTera8 | /mnt/nas/nettera8 | ~93% |\n\nМонтирование на .176: nfs-common, fstab-записи с `_netdev,nofail,vers=3` (бэкап `/root/fstab.backup`). В контейнер шары проброшены bind-mount с propagation `:slave` в `docker-compose.yml` — хостовые NFS-монты автоматически видны внутри контейнера.\n\n### Как добавить новую шару (руководство)\n\n1. **Смонтировать на хосте .176** (root):\n\n ```bash\n apt-get install -y nfs-common\n mkdir -p /mnt/nas/<имя>\n echo \"192.168.1.XXX:/экспорт /mnt/nas/<имя> nfs defaults,_netdev,nofail,vers=3 0 0\" >> /etc/fstab\n mount -a && df -h /mnt/nas/<имя> # проверить\n ```\n\n2. **Пробросить в контейнер**: в `/opt/hard-panel/docker-compose.yml` в секцию `volumes:` сервиса `panel` добавить строку:\n\n ```yaml\n - /mnt/nas/<имя>:/mnt/nas/<имя>:slave\n ```\n\n и пересоздать контейнер (порядок важен — обычный `up -d --build` падает с KeyError 'ContainerConfig' на старом docker-compose 1.29):\n\n ```bash\n cd /opt/hard-panel && docker-compose down && docker-compose up -d --build\n ```\n\n Проверка: `curl http://localhost:8000/api/v1/health` и `curl -s http://localhost:8000/api/v1/servers | grep -c online` (должно быть 18).\n\n3. **Зарегистрировать шару в панели**:\n\n ```bash\n curl -s -X POST http://192.168.1.176:8000/api/v1/shares \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\": \"<имя>\", \"path\": \"/mnt/nas/<имя>\"}'\n ```\n\n (если включён GHARD_ADMIN_TOKEN — добавить заголовок `Authorization: Bearer <токен>`; UI-путь: кнопка Add share в разделе Storage).\n\n4. **Проверить замер**: подождать ~1 минуту (интервал пробера), затем:\n\n ```bash\n curl -s http://192.168.1.176:8000/api/v1/shares | python3 -m json.tool\n ```\n\n Статус должен стать `online`, появятся `total`/`used`. Если `offline` — проверить, что шара смонтирована на хосте и видна в контейнере: `docker exec ghard-panel stat -f /mnt/nas/<имя>`.\n\n## Массовый деплой (как сделано)\n\nС хоста .176 (root): `sshpass` + скрипт `/root/deploy-hard-monitor.sh` (и `/root/fix-remaining.sh` для отставших). Логика: DELETE старой записи на панели → POST новой (ключ ghm_ показывается один раз) → scp файлов агента из `/opt/hard-monitor-src` → `install.sh PANEL KEY 30` через sudo.\n\nГрабли, проверенные на практике:\n\n- `apt-get install python3-venv` без `apt-get update` падает 404 на старых зеркалах — сначала update.\n- Ubuntu 18.04 (gitbucket): системный python3.6 не подходит (`from __future__ import annotations`, `list[str]`). Решение: `apt-get install python3.8 python3.8-venv python3.8-dev`, venv на python3.8, затем `pip install psutil requests`.\n- Если `/tmp/hm` создан root'ом до scp — Permission denied; создавать от пользователя или чистить.\n- Диск 100% (gnexus-home) ломает scp — `apt-get clean` + `journalctl --vacuum-size=50M`.\n\n## Обновление агента\n\nПовторный запуск `install.sh` с теми же PANEL_URL/SERVER_KEY перезаписывает файлы и рестартует юнит (конфиг `.env` не трогается). Файлы агента: `/opt/hard-monitor-src` на .176.\n\n## История развёртывания\n\n- 2026-09-10: панель развёрнута (docker-compose build), агент установлен на сам хост, сервер `hard-panel-176` online. Root-SSH на VM включён (PermitRootLogin yes, пароль задан).\n- 2026-09-10: UI показывал пустой список — причина: заданный GHARD_ADMIN_TOKEN, который UI не подписывает. Токен отключён, compose-дефолт исправлен на `${GHARD_ADMIN_TOKEN-}`. Проверено: `GET /api/v1/servers` без токена отдаёт `hard-panel-176 online`.\n- 2026-09-10: массовый деплой агентов — 18/18 серверов online (16 VM DL380 + navi + панель). Скрипты: `/root/deploy-hard-monitor.sh`, `/root/fix-remaining.sh` на .176.\n- 2026-09-11: обновление панели до версии с мониторингом шар (git pull, edb6cff). Смонтированы 4 NFS-шары (secraid5-jf, secraid5-cache, firstraid5, nettera8), проброшены в контейнер с `:slave`, добавлены в мониторинг — все online." + }, + "status": "applied", + "created_at": "2026-09-11T07:30:52Z", + "updated_at": "2026-09-11T07:30:54Z", + "applied_at": "2026-09-11T07:30:54Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}