Newer
Older
gnexus-book / 10-systems / hosts / gnsynapse.md

owner: gmikcon status: active last_reviewed: 2026-11-04 review_interval: 90d confidence: high source_of_truth: ssh-host

reviewed_by: navi rei

gnsynapse

VM in home LAN dedicated to the Gnexus Synapse project — the centralized notification hub of the Gnexus ecosystem (see gntodo project "Gnexus Synapse", id 9).

Identity

  • Hostname: gnsynapse
  • IP: 192.168.1.172 (static, configured inside the guest)
  • Type: KVM/libvirt VM on hp-proliant-dl380-g6
  • MAC: 52:54:00:79:23:90
  • User: ubuntu (sudo with same password)
  • Credentials: gnexus-creds secret gnsynapse-ssh (SSH = sudo password)

Platform

  • OS: Ubuntu 22.04.5 LTS (Jammy Jellyfish)
  • Kernel: 5.15.0-202-generic (live 2026-11-04; в доках ранее 5.15.0-198)
  • CPU: 2 vCPU (Intel Xeon X5650 @ 2.67GHz)
  • RAM: 2 GB
  • Disk: 15 GB LVM (/dev/mapper/ubuntu--vg-ubuntu--lv), ~47% used at provisioning
  • Timezone: Europe/Kyiv (set 2026-10-04 by navi rei, was Etc/UTC)

Network

Static configuration inside the guest via netplan (/etc/netplan/50-static.yaml, since 2026-10-17; before that /etc/netplan/50-cloud-init.yaml):

  • enp1s0: 192.168.1.172/24
  • Gateway: 192.168.1.1
  • DNS: 192.168.1.1, 1.1.1.1
  • dhcp4: no — no pfSense static mapping needed; the address survives reboots and is not part of any DHCP pool.
  • Cloud-init network configuration disabled (/etc/cloud/cloud.cfg.d/99-disable-network-config.cfg: network: {config: disabled}) — netplan-файл больше не перегенерируется при загрузке.

Services

  • ssh.service — listening port 22
  • docker.service + containerd.service — Gnexus Synapse stack (docker compose, /home/ubuntu/gnsynapse): containers api, worker, postgres, redis; host port 8013; repo root/gn-synapse on GitBucket. Details: 10-systems/services/gnexus-synapse.md.
  • hard-monitor.service — GHard Monitor agent (see Monitoring below)

Monitoring

Агент hard-monitor (GHard Monitor) установлен 2026-10-04 (navi rei):

  • Установка: /opt/hard-monitor (venv: psutil, requests), конфиг /opt/hard-monitor/.env — PANEL_URL=http://192.168.1.176:8000, SERVER_KEY=ghm_…, INTERVAL=30
  • systemd-юнит hard-monitor.service — enabled, active
  • На панели: сервер gnsynapse, id 46, статус online (флот 19/19)
  • Ключ сервера в доках не дублируется: лежит в /opt/hard-monitor/.env на самом хосте; при переустановке взять оттуда или перерегистрировать сервер на панели (DELETE + POST /api/v1/servers)
  • Нюанс свежей VM: нет пакета python3.10-venv — перед install.sh нужен apt-get update && apt-get install -y python3.10-venv

2026-10-17: блэкаут, возврат на .172 (navi rei)

  • Ночной блэкаут 2026-10-16/17: VM погашена владельцем, утром 2026-10-17 запущена заново. Netplan-статика на момент блэкаута ещё не была настроена (файл был cloud-init DHCP) — VM получила от pfSense временный адрес 192.168.1.29, старый .172 освободился.
  • Временные фиксы (утро): nginx-апстрим на internal-proxy (.183) → http://192.168.1.29:8013; TGCLIENT_SYNAPSE_URL на tgclient → http://192.168.1.29:8013; MCP-конфиг navi → http://192.168.1.29:8013/mcp.
  • Возврат (решение владельца, день 2026-10-17): netplan-статика 192.168.1.172/24 (gateway 192.168.1.1, DNS 192.168.1.1 + 1.1.1.1), cloud-init network config disabled, 50-cloud-init.yaml удалён, создан 50-static.yaml; все зависимые конфиги откатаны на .172:8013. Проверено: synapse public/direct 200, hard-panel gnexus-synapse up, MCP synapse connected.
  • Открытый пункт: Kea-резервация на pfSense (MAC 52:54:00:79:23:90 → .172) не требуется, пока в госте статика; при отказе от статики — добавить резервацию (нужен админ-доступ к pfSense).

2026-11-04: блэкаут стенда, server_offline волна (navi rei)

  • Триггер: Synapse envelope 9b290f76-37d9-4a47-987c-7c2fdca554f3 — hard-panel server_offline, server_id 46 (gnsynapse), silent_minutes 353, priority high. Часть массовой волны server_offline ×18 (09:58:45 UTC) после полного блэкаута стенда 04:05–09:54 UTC — выключено всё, включая хост панели (слепое окно мониторинга ~5 ч 49 м). Канонический отчёт: workspace/incident_infra_blackout_2026-11-04.md (repo navi-1).
  • Хронология VM: последний пакет до провала ~04:05 UTC (silent 353 мин от 09:58:45); бут ~09:55 UTC (uptime 1261 с при проверке 10:16) — VM перезагрузилась вместе со стендом.
  • Верификация 10:16 UTC: панель — gnsynapse online, last_seen 10:16:12 UTC, интервал 30 с; CPU 3.2%, RAM 41%, swap 0, load 0.17, диск / 71.1% (на 2026-10-04 при provisioning было ~47% — рост за месяц, наблюдение; алертов по диску нет). Docker-стек Synapse api/worker/postgres/redis — Up 19 мин (api/postgres/redis healthy) — поднялся сам после бута; hard-monitor.service возобновил репортинг сам, рестарт не потребовался.
  • Сервисы панели: 8/8 up, gnexus-synapse [up] 24.8 ms (код 200).
  • Вывод: последствий для данных и сервисов Synapse нет; вмешательство не потребовалось — всё самовосстановилось после возврата питания. Причина провала — питание стенда (см. канонический инцидент-файл; рекомендация внешнего зонда — там же, на решение владельца).

Notes

  • Provisioned 2026-10-04 as the host for the new Synapse project; IP chosen from verified free range 192.168.1.170–180.
  • Docker bridge docker0 (172.17.0.1/16) present from default install.