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

5.3 KiB
Raw Permalink Blame History

ЕДИНЫЙ СТАНДАРТ СЕРВИСА 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. Как проверять

python3 /tmp/standard_check.py          # таблица + сводка
cat /tmp/standard-report.csv            # машинный отчёт