Newer
Older
gnexus-book / 10-systems / services / gnexus-synapse.md

owner: gmikcon status: active last_reviewed: 2026-10-04 review_interval: 90d confidence: high

source_of_truth: ssh-host-and-live-verified

Gnexus Synapse

Централизованный хаб уведомлений экосистемы Gnexus: сервисы присылают событие «что случилось», Synapse решает, кому, куда и каким каналом доставить (Telegram, Email, Push, internal log, system-to-system в Navi). Проект gntodo id 9; репозиторий root/gn-synapse на GitBucket.

Identity

  • Host: gnsynapse (192.168.1.172), VM на hp-proliant-dl380-g6
  • Deploy path: /home/ubuntu/gnsynapse (git clone, HEAD 82d9181 на момент деплоя)
  • Stack: docker compose (api + worker + postgres:17 + redis:7), порт хоста 8013
  • Public URL: https://synapse.gnexus.space
  • Credentials: gnexus-creds secret gn-synapse-prod-secrets (id 616b707b-8194-4c98-a031-374b39012e9c) — POSTGRES_PASSWORD, MCP_TOKEN; SSH хоста — secret gnsynapse-ssh

Deployment (2026-10-04, navi rei)

  • docker compose up -d --build через sudo (user ubuntu не в docker-группе — ловушка как на bugtrail).
  • Alembic-миграции применяются entrypoint'ом api автоматически; голова b7d3e8f04a92.
  • .env создан из .env.example: POSTGRES_PASSWORD и MCP_TOKEN = openssl rand -hex, GAUTH_BASE_URL=https://auth.gnexus.space, GAUTH_VERIFY_TLS=true, GAUTH_REDIRECT_URI=https://synapse.gnexus.space/auth/callback, SYNAPSE_PORT=8013.
  • docker-compose.override.yml (локальная модификация, переживает git pull): extra_hosts auth.gnexus.space:192.168.1.226 для api и worker — серверный call-home (валидация opaque-токенов через userinfo) идёт в LAN через internal-proxy, где валидный LE-сертификат. Браузерный редирект остаётся на публичный auth.gnexus.space (GAUTH_BASE_URL).

Public entry

  • Route: internet → external-vps (catch-all → internal-proxy) → nginx на internal-proxy-vps (.226) → http://192.168.1.172:8013.
  • nginx site: /etc/nginx/sites-available/synapse.gnexus.space на .226; TLS Let's Encrypt synapse.gnexus.space (certbot --nginx, до 2027-01-02, автопродление); HTTP→HTTPS 301 добавлен вручную (certbot не вписал).
  • DNS: wildcard *.gnexus.space → 51.83.131.93 (external-vps), отдельной записи не потребовалось.
  • proxy_buffering off + proxy_read_timeout 300s — для SSE/MCP.

Verified smoke (2026-10-04)

  • /api/healthz → {"status":"ok","service":"synapse"}; /api/readyz → postgres ok, redis ok.
  • Worker: celery@... ready. в логах.
  • SPA отдаётся на / (Vue 3, lang=ru).
  • /mcp без токена → 401 (MCP включён, MCP_TOKEN задан).
  • Полный конвейер: source monitoring + type (container/down) + target internal_log/smoke-log + rule + API-ключ созданы через python -m app.cli; POST /api/v1/events через публичный HTTPS → 202; доставка в БД delivered с отрендеренным шаблоном.

Pending (владелец, рантбук §5)

  1. Зарегистрировать OAuth-клиент synapse в gnexus-auth: redirect URI https://synapse.gnexus.space/auth/callback, скоупы openid email profile roles permissions, вебхуки auth.logout/auth.global_logout/session.revoked → https://synapse.gnexus.space/auth/webhooks.
  2. Вписать GAUTH_CLIENT_ID, GAUTH_CLIENT_SECRET, GAUTH_WEBHOOK_SECRET в .env на хосте + gnexus-creds, затем docker compose up -d (api пересоздастся).
  3. Проверка: curl -s localhost:8013/auth/login -o /dev/null -w '%{http_code}' → 302/307 на authorize с реальным client_id.
  4. Telegram-канал — отложен до задачи #29 (не создавать цель telegram).
  5. Push-канал (VAPID) — опционально, рантбук §7.

Operations

  • Обновление: cd /home/ubuntu/gnsynapse && git pull && sudo docker compose up -d --build (перед этим pg_dump — откат миграций вниз не поддерживается всеми ревизиями).
  • Бэкап БД: sudo docker compose exec -T postgres pg_dump -U synapse synapse > backup-$(date +%F).sql.
  • MCP-управление: https://synapse.gnexus.space/mcp с Bearer MCP_TOKEN (31 тул, docs/07).
  • Smoke-объекты приёмки (source monitoring, key smoke-key, target smoke-log, rule id=1) — можно архивировать через админку/MCP после реальной настройки.