diff --git a/10-systems/services/hard-panel.md b/10-systems/services/hard-panel.md index ea08e75..b1273c3 100644 --- a/10-systems/services/hard-panel.md +++ b/10-systems/services/hard-panel.md @@ -9,9 +9,9 @@ # hard-panel (GHard Monitor) -Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через `os.statvfs`). +Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через `os.statvfs`). С версии 2026-10-04 (`b6080d0`, v1.30.0) — gnexus-auth (OAuth PKCE), health-чекер сервисов, журнал событий, интеграция с Gnexus Synapse, i18n (en/uk/ru), MCP-промпт `agent_guide`. -- Репозиторий: `https://git.gnexus.space/root/hard-panel` +- Репозиторий: `https://git.gnexus.space/root/hard-panel` (ветка `master`) - Хост: VM `service` на `hp-proliant-dl380-g6`, адрес `192.168.1.176` - SSH: `root` / пароль в gnexus-creds (секрет `hard-panel (192.168.1.176)`), также `ubuntu` с тем же паролем - ОС: Ubuntu 22.04.5 LTS, 4 GB RAM, 31 GB диск @@ -23,18 +23,29 @@ - Конфиг: `/opt/hard-panel/.env` (GHARD_ADMIN_TOKEN, GHARD_DATABASE_PATH=/data/hard-panel.db, GHARD_OFFLINE_MULTIPLIER=3) - Данные: docker volume `panel-data` (SQLite, WAL) - Health: `http://192.168.1.176:8000/api/v1/health` → `{"status":"ok"}` -- UI: `http://192.168.1.176:8000/` (без логина) +- UI: `http://192.168.1.176:8000/` (без логина; после включения gnexus-auth — вход через OAuth PKCE) - API: `http://192.168.1.176:8000/docs` (OpenAPI) -- MCP: `http://192.168.1.176:8000/mcp` (streamable HTTP; инструменты `panel_overview`, `server_details`, `server_history`) +- MCP: `http://192.168.1.176:8000/mcp` (streamable HTTP; тулы `panel_overview`, `server_details`, `server_history`, `services_overview`, `service_incidents`, `events_recent`; промпт `agent_guide` — инструкции агенту) - Логи: `docker logs ghard-panel` ## Важно про GHARD_ADMIN_TOKEN - Веб-интерфейс не умеет подписывать запросы токеном (`panel/frontend/src/api.js`): если токен задан, UI получает 401 и показывает пустой список серверов. -- В `docker-compose.yml` дефолт `${GHARD_ADMIN_TOKEN:-change-me}` подставляет `change-me` даже при пустой переменной в `.env`. Локально исправлено на строгую форму `${GHARD_ADMIN_TOKEN-}` (2026-09-10) — при `git pull` проверить, не вернулся ли старый синтаксис. +- В `docker-compose.yml` дефолт `${GHARD_ADMIN_TOKEN:-change-me}` подставляет `change-me` даже при пустой переменной в `.env`. Локально исправлено на строгую форму `${GHARD_ADMIN_TOKEN-}` (2026-09-10) — при `git pull` проверить, не вернулся ли старый синтаксис (проверено 2026-10-04, форма сохранена). - Текущее состояние: токен пустой (API и UI открыты, доступ только из LAN). Если панель когда-нибудь выйдет в интернет — задать токен и закрыть `/mcp` на reverse proxy. - Старый сгенерированный токен хранится в gnexus-creds (секрет `hard-panel (192.168.1.176)`, поле `admin_token`) на случай, если токен снова включат. +## Update 2026-10-04 21:30 (navi rei) — auth, ui-kit 1.0, health-чекер, Synapse + +- Обновление `edb6cff..b6080d0` (19 коммитов, 44 файла +3897/−251), версия MCP serverInfo `1.30.0`. +- Новое: закрытие панели за gnexus-auth (OAuth PKCE, `f52c853`), gnexus-ui-kit 1.0 + тема Verdant + новый логотип (`9625022`, `cd5b630`), health-чекер сервисов — раздел «Сервисы», страницы сервисов с графиком и журналом недоступности (`c6e8698`, `19812b4`, `5eef1bd`), парсер самосвидетельства health-ответов по handbook spec §5 (`fe202ff`), журнал событий (`fe6b21e`), интеграция с Gnexus Synapse — этап 4 (`fe6b21e`), MCP: промпт `agent_guide` + тулы сервисов и журнала (`fc0de93`), i18n en/uk/ru + раздел Settings (`b1a82e2`), заметка сервера 184px + resize (`af2cd8f`), фиксы графиков/навигации/no-store (`dfc511f`, `50a9262`, `9953bae`, `84dfcfc`). +- Апстрим compose прокидывает все задокументированные env: `GHARD_AUTH_*` (BASE_URL, CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, WEBHOOK_SECRET, ALLOWLIST), `GHARD_SHARE_INTERVAL`, `GHARD_HEALTH_INTERVAL/TIMEOUT`, `GHARD_SYNAPSE_URL/API_KEY/DEFAULT_SOURCE/TIMEOUT`. +- Конфликт stash pop в `docker-compose.yml` разрешён вручную: апстримный env-блок + локальные правки (строгая форма токена, 4 NAS-тома `:slave`). `docker compose config` валиден. +- Бэкап БД до обновления: внутри volume `/data` — `hard-panel.db.bak-preupdate-20261004-2127` (файловая копия) и `hard-panel.db.bak-sqlite-20261004-2127` (консистентный sqlite3 backup API, 1.6 GB). +- Миграции: новых таблиц нет как отдельного шага — схема создана/расширена при старте (`oauth_states`, `sessions`, `users`, `services`, `service_samples`, `events` на месте). +- Проверено после обновления: `/api/v1/health` ok, флот 19/19 online, агенты инжестят 200 OK, MCP initialize OK (GHard Monitor 1.30.0, 6 тулов + промпт agent_guide), `/mcp` без auth 406, SPA 200 с i18n-строками, synapse reporter корректно disabled (`GHARD_SYNAPSE_API_KEY` не задан). +- Известное ожидаемое поведение: `/auth/login` → 500 `ConfigurationException: Invalid gnexus-auth base URL` — `GHARD_AUTH_BASE_URL` ещё не задан; привязка к gnexus-auth — следующий этап (владелец). + ## Агенты (fleet, 2026-10-04) Агент hard-monitor установлен на все серверы home LAN. Все 19 серверов online (интервал 30 с): @@ -148,3 +159,4 @@ - 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. - 2026-10-04: добавлен сервер `gnsynapse` (192.168.1.172, панель id 46) — агент установлен через scp из `/opt/hard-monitor-src` + `install.sh` (navi rei). Флот 19/19 online. +- 2026-10-04: крупное обновление панели `edb6cff..b6080d0` (19 коммитов, v1.30.0): gnexus-auth (OAuth PKCE), ui-kit 1.0 Verdant, health-чекер сервисов, журнал событий, Synapse-интеграция, i18n, MCP agent_guide (navi rei). Бэкапы БД в volume; конфликт compose разрешён, локальные правки сохранены.