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

76 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ЕДИНЫЙ СТАНДАРТ СЕРВИСА Buryans Hub
Дата: 07.11.2026. Проверка автоматическая: `/tmp/standard_check.py`,
отчёт: `/tmp/standard-report.csv`. Сервисов проверено: **64**.
## 1. Пять требований
| # | Требование | Как проверяется |
|---|---|---|
| S1 | **Идентичность** — вход через Authentik | есть свой oauth2-proxy или нативный OIDC |
| S2 | **Данные** — есть бэкап | архив в `/mnt/backups` (сервисный, БД или общий) |
| S3 | **Здоровье** — сервис отвечает | HTTP < 500 по `/`, `/health`, `/api/health` и др. |
| S4 | **Документация** — есть описание | каталог `deploy/ctNNN` в репозитории |
| S5 | **Уникальность** — нет дубля роли | ручная проверка при добавлении |
## 2. Текущее соответствие
| Требование | Соответствует | Процент |
|---|---|---|
| S1 идентичность | 32 / 64 | **50%** |
| S2 бэкап данных | 60 / 64 | **94%** |
| S3 здоровье | 40 / 64 | **62%** |
| S4 документация | 64 / 64 | **100%** |
| **полный стандарт (4/4)** | **19 / 64** | **30%** |
## 3. Что уже приведено к стандарту полностью (4/4)
bazarr (CT120), beszel (CT110), docmost (CT103), element-web (CT155), firefly (CT110), grocy (CT110), house3d-web (CT110), monica (CT110), n8n (CT108), nextcloud (CT109), node_red (CT108), paperless (CT105), podfetch (CT103), prometheus (CT134), prowlarr (CT119), radarr (CT118), sonarr (CT117), uptime_kuma (CT107), vaultwarden (CT109)
## 4. Где не хватает идентичности (S1)
Это внутренние сервисы, боты, экспортёры и те, что ещё не закрыты SSO:
adguard (CT107), alertmanager (CT134), authentik-security-server-1 (CT114), authentik-security-worker-1 (CT114), book-bot (CT111), buryan-alert-webhook (CT134), duplicati (CT111), exportarr-bazarr (CT134), exportarr-prowlarr (CT134), exportarr-radarr (CT134), exportarr-sonarr (CT134), frigate (CT126), gitea-runner (CT140), grafana (CT113), ha-strip (CT106), homebox (CT110), jackett (CT124), jellystat (CT103), kavita (CT111), lidarr (CT111), livekit (CT155), loki (CT113), matrix-coturn (CT155), matrix-synapse (CT155), mautrix-telegram (CT155), mealie (CT110), memos (CT110), mosquitto (CT107), seerr (CT121), syncthing (CT139), tg-admin-bot (CT108), vikunja (CT110)
## 5. Где не подтверждено здоровье (S3)
Часть сервисов не отдаёт HTTP на порту (внутренние экспортёры, MQTT, coturn,
livekit) — для них нужен отдельный тип проверки (TCP/процесс), а не HTTP.
adguard (CT107), alertmanager (CT134), audiobookshelf (CT111), authentik-security-worker-1 (CT114), book-bot (CT111), buryan-alert-webhook (CT134), calibre-web (CT111), catalog (CT111), dashy (CT102), dozzle (CT110), duplicati (CT111), freshrss (CT111), gitea (CT140), gitea-runner (CT140), homeassistant (CT106), jellyfin (CT103), lidarr (CT111), livekit (CT155), matrix-coturn (CT155), mosquitto (CT107), navidrome (CT125), openclaw (CT115), stirling-pdf (CT110), tg-admin-bot (CT108)
## 6. Что сделано для стандарта в эту ночь
| Требование | Действие | Результат |
|---|---|---|
| S2 | Ночной бэкап данных сервисов: `/usr/local/bin/hub-services-backup.sh`, таймер 03:45, ротация 7 дней | **28% → 94%** |
| S2 | Ежемесячные restore-учения (таймер) + проверка Immich/Paperless | работает |
| S1 | SSO для Nextcloud, Gitea, Jellyfin, Paperless, Vaultwarden | 5 сервисов |
| S4 | deploy/ для всех CT, удалён deploy/ct116 | 100% |
| S5 | Удалены Plex, Tautulli, Paperless-дубль, Mosquitto-дубль, Kavita | дублей нет |
## 7. Следующие шаги по стандарту (от центра к периферии)
| Приоритет | Что | Требование |
|---|---|---|
| 1 | TCP-проверки для MQTT, coturn, livekit, экспортёров | S3 |
| 2 | SSO для внутренних веб-сервисов (adguard, jackett, seerr, syncthing, frigate) | S1 |
| 3 | Бэкап медиа-метаданных (Jellyfin, Frigate записи) | S2 |
| 4 | Реестр сервисов в одном файле (роль, владелец, бэкап, SSO) | S4 |
| 5 | Автопроверка стандарта в CI (Gitea Actions) | все |
## 8. Правило приёмки нового сервиса
```
Сервис не добавляется, пока не выполнены S1–S4:
S1 — вход через Authentik
S2 — бэкап данных в /mnt/backups
S3 — health-проверка (HTTP или TCP)
S4 — deploy/ctNNN с compose и описанием
```
## 9. Как проверять
```bash
python3 /tmp/standard_check.py # таблица + сводка
cat /tmp/standard-report.csv # машинный отчёт
```