diff --git a/10-systems/services/gnexus-synapse.md b/10-systems/services/gnexus-synapse.md new file mode 100644 index 0000000..ae3f875 --- /dev/null +++ b/10-systems/services/gnexus-synapse.md @@ -0,0 +1,57 @@ +--- +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 после реальной настройки. diff --git a/10-systems/traffic-routes/public-gnexus-space-to-internal-nginx.md b/10-systems/traffic-routes/public-gnexus-space-to-internal-nginx.md index d271d8c..8afbaf7 100644 --- a/10-systems/traffic-routes/public-gnexus-space-to-internal-nginx.md +++ b/10-systems/traffic-routes/public-gnexus-space-to-internal-nginx.md @@ -1,7 +1,7 @@ --- owner: gmikcon status: active -last_reviewed: 2026-05-09 +last_reviewed: 2026-10-04 review_interval: 90d confidence: medium source_of_truth: owner-confirmed @@ -49,6 +49,7 @@ - `files.gnexus.space` - `gnexus.space` - `navi.gnexus.space` +- `synapse.gnexus.space` - `transmission.gnexus.space` ## Known Hosts @@ -67,6 +68,7 @@ | `gnexus.space` | `http://192.168.1.151` | | `jellyfin.gnexus.space` | `http://192.168.1.153:8096` | | `navi.gnexus.space` | `http://192.168.1.168:8000` | +| `synapse.gnexus.space` | `http://192.168.1.172:8013` | | `transmission.gnexus.space` | `http://192.168.1.154:3000` | ## Available But Not Confirmed Enabled @@ -76,8 +78,11 @@ - `lytvak.gnexus.space` -> `http://192.168.1.167` - `minecraft.gnexus.space` -> `tcp://192.168.1.218:25565` +## Verification Notes + +- 2026-10-04 (navi rei): the external VPS catch-all forwards unknown `*.gnexus.space` subdomains to the internal proxy — verified by fetching a probe file from the default site of `.226` through `http://synapse.gnexus.space`. HTTP-01 challenges therefore reach certbot on `.226` (LE certificate issued for `synapse.gnexus.space` the same day). nginx site configs live in `/etc/nginx/sites-available/` on `internal-proxy-vps` (root access required). + ## Unknowns - OpenVPN public port. -- nginx configuration file paths. - SSH forwarding details to the internal `alex` VPS. diff --git a/40-inventory/hosts.yml b/40-inventory/hosts.yml index f20d21e..147f335 100644 --- a/40-inventory/hosts.yml +++ b/40-inventory/hosts.yml @@ -557,6 +557,7 @@ - ssh.service - docker.service - containerd.service + - gn-synapse-docker-compose-stack addresses: lan: - 192.168.1.172 @@ -567,17 +568,21 @@ listening_ports: tcp: - 22 + - 8013 mac_address: 52:54:00:79:23:90 name: gnsynapse notes: 'Provisioned 2026-10-04 as dedicated host for Gnexus Synapse (notification hub, gntodo project id 9). Static IP inside guest via cloud-init netplan (dhcp4=no, gateway/DNS 192.168.1.1) — no pfSense mapping needed. Timezone Europe/Kyiv set - 2026-10-04 by navi rei (was Etc/UTC). Ubuntu 22.04.5 LTS, 2 vCPU X5650, 2GB RAM, - 15GB disk (~47% used). Docker+containerd enabled, no containers yet. Only SSH - listening. Credentials: gnexus-creds secret gnsynapse-ssh (SSH=sudo password).' + 2026-10-04 by navi rei (was Etc/UTC). Ubuntu 22.04.5 LTS, 2 vCPU X5650, 2GB RAM + (+3GB swap), 15GB disk. Synapse stack deployed 2026-10-04 by rei (commit 82d9181): + docker compose api+worker+postgres+redis, port 8013, public https://synapse.gnexus.space + (nginx on .226, LE cert). Docker via sudo (user ubuntu not in docker group). Credentials: + gnexus-creds secrets gnsynapse-ssh (SSH=sudo) and gn-synapse-prod-secrets (POSTGRES_PASSWORD, + MCP_TOKEN).' owner: gmikcon purpose: Gnexus Synapse notification hub host - source_of_truth: ssh-host + source_of_truth: ssh-host-and-live-verified status: active type: vm user: ubuntu