Files
buryan-infra/ops/home/SERVICE-STANDARD.md
T

3.4 KiB
Raw Blame History

Стандарт для новых сервисов Buryans Hub (зафиксировано 30.10.2026)

Владелец: «всё делаем в нашем стиле — сразу SSO и база на 151». Это правило для любого нового сервиса, в том числе для 3D-панели дома.

1. Доступ — только через единый вход (Authentik)

  1. В Authentik создаётся Application + Provider (proxy).
  2. Перед сервисом ставится oauth2-proxy (как у остальных сервисов): контейнер в том же CT, конфиг — в deploy/ctNNN/docker-compose.yml.
  3. nginx (локальный хост + VPS) добавляет auth_request /oauth2/auth и error_page 401 = /oauth2/sign_in.
  4. Сертификат — из Let's Encrypt на VPS, синхронизируется sync_certs.py (Tailscale), локальный nginx работает с валидным сертом.

Исключения (осознанные): API-эндпоинты, которые не могут пройти SSO (Matrix client API, HA API с токеном) — для них SSO отключён точечно.

2. Данные — только на основном PostgreSQL 192.168.1.151

  1. Отдельная база и роль под сервис (никакого общего superuser).
  2. Пароль — в /root/.<service>-db.env (права 600), в репозиторий не попадает.
  3. Локальный SQLite — только как временное исключение (HA recorder — см. п. 4).
  4. Дампы — через существующий db_dumps.py, хранение в /mnt/archive/backups/db.

Уже заведено для 3D-панели:

Параметр Значение
База house3d
Роль house3d
Хост 192.168.1.151:5432
Креды /root/.house3d-db.env (600)

3. Эксплуатация (как у всех)

  • compose в deploy/ctNNN/docker-compose.yml, образ с пином;
  • сервис в ops/update-manager/services.yaml;
  • мониторинг: цель в Prometheus + монитор в Uptime Kuma;
  • бэкап: дампы БД + конфиги в общий контур;
  • документация в ops/<тема>/ и коммит с ID.

4. Открытый вопрос по HA

Сейчас история HA пишется в локальный SQLite (recorder). По новому правилу её место — Postgres на 151 (отдельная база homeassistant). Переезд возможен, но требует аккуратной миграции и остановки записи; решение за владельцем.

5. 3D-панель дома — предварительный план

Компонент Где
Рендер/сцена Blender на хосте (артефакты — PNG/SVG в репозитории)
Веб-панель (three.js) контейнер в CT110 (office-lxc) или новый CT
Данные (комнаты, устройства, сцены) Postgres house3d на 151
Доступ Authentik + oauth2-proxy, домен (предложить 3d.buryans.ru)
Мониторинг Prometheus + Kuma