[HOME] Стандарт новых сервисов: SSO Authentik + PostgreSQL на 151; база house3d заведена
lint / hygiene (push) Successful in 13s
lint / hygiene (push) Successful in 13s
This commit is contained in:
1 parent
d1d62ec6a9
commit
81bcdf8047
1 file changed
+58
@@ -0,0 +1,58 @@
|
||||
# Стандарт для новых сервисов 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 |
|
||||
Reference in new issue
Block a user