plan(F6): Sprint F6 v2 registered - Safe Updates & Self-Service
- F6-2 now: Self-Service Registration via Authentik (owner approval in Telegram) - Authentik added to update registry as critical service - Update pipeline: backup -> update -> healthcheck -> fix/auto-rollback - Proactive monitoring: certs <14d, disks >85% - Target baseline: v1.4
This commit is contained in:
1 parent
d6be429f7f
commit
07dd6dc8a2
1 file changed
+117
@@ -0,0 +1,117 @@
|
||||
# 🚀 СПРИНТ F6 v2: Safe Updates & Self-Service (дни 31-38)
|
||||
|
||||
**Цель:**
|
||||
1. Обновления без страха: бэкап → обновление → проверка → (успех: фиксация | провал: алерт + авто-откат < 5 мин).
|
||||
2. Self-service: регистрация пользователя = заявка → одобрение в Telegram → авто-создание в Authentik с инструкцией (2 минуты, без SSH).
|
||||
3. Проактивность: автослежение за новыми версиями, сертификатами (<14 дней) и дисками (>85%).
|
||||
|
||||
**Baseline на выходе:** v1.4
|
||||
|
||||
---
|
||||
|
||||
## 🏗 Архитектура
|
||||
|
||||
### Поток обновлений:
|
||||
Version Watch (cron 6ч) → Gitea issue (label: update-available) + Telegram
|
||||
→ ссылки [Обновить сейчас] [Отложить до 03:00] [Игнор]
|
||||
→ n8n пишет задачу в update_queue (PG)
|
||||
→ update-runner.sh (cron 1 мин на PVE) → safe-update.sh <service>:
|
||||
1. БЭКАП: снапшот volumes + pg_dump (если DB) + фиксация текущего digest
|
||||
2. ОБНОВЛЕНИЕ: docker compose pull + up -d
|
||||
3. ПРОВЕРКА: healthcheck (3 попытки × 30 сек) + smoke-test
|
||||
4a. OK → stable-versions.json → commit в Git → Telegram "✅ Обновлено"
|
||||
4b. FAIL → АВТО-ОТКАТ на прежний digest → Telegram "🚨 Откат" + Gitea issue (sev:1)
|
||||
|
||||
### Поток регистрации:
|
||||
Форма n8n /request (имя, email, сервисы)
|
||||
→ Telegram владельцу: [✅ Одобрить] [❌ Отклонить] (одноразовый токен)
|
||||
→ Authentik API: создать пользователя + группы (mealie-users, matrix-users, gitea-dev...)
|
||||
→ enrollment-линк (24ч) для установки пароля
|
||||
→ Telegram владельцу: инструкция для пересылки пользователю
|
||||
→ Gitea issue (label: provisioned) — аудит
|
||||
|
||||
---
|
||||
|
||||
## 📝 Задачи
|
||||
|
||||
- [ ] F6-1: Update Manager: ядро
|
||||
Реестр ops/update-manager/services.yaml (service, CT, compose path, image,
|
||||
healthcheck, backup type, critical flag). Authentik = critical.
|
||||
safe-update.sh: backup → update → healthcheck → fix/rollback.
|
||||
ops/state/stable-versions.json в Git.
|
||||
Приёмка: ручной прогон на тест-сервисе успешен; версия зафиксирована в Git;
|
||||
Authentik в реестре с critical flag.
|
||||
|
||||
- [ ] F6-2: Self-Service Registration (Authentik)
|
||||
n8n-форма заявки → одобрение владельцем в Telegram → Authentik API:
|
||||
пользователь + группы + enrollment-линк (24ч) → инструкция владельцу.
|
||||
Приёмка: тест-пользователь создан, вошёл по SSO минимум в один сервис;
|
||||
владелец получил линк и инструкцию; создан audit issue.
|
||||
|
||||
- [ ] F6-3: Version Watch
|
||||
cron 6ч: version-watch.sh сверяет Docker Hub / GitHub releases со
|
||||
stable-versions.json → Gitea issue + Telegram.
|
||||
Приёмка: получено реальное уведомление о доступном обновлении.
|
||||
|
||||
- [ ] F6-4: Approval-поток обновлений
|
||||
Кнопки в Telegram → n8n → update_queue (PG) → update-runner.sh (cron 1 мин)
|
||||
→ safe-update.sh → результат в Telegram (+ Gitea issue при откате).
|
||||
Приёмка: одобренное обновление прошло end-to-end, результат в Telegram.
|
||||
|
||||
- [ ] F6-5: Rollback-drill
|
||||
Намеренно "сломать" обновление тест-сервиса (битый тег / healthcheck).
|
||||
Приёмка: авто-откат < 5 мин, сервис восстановлен, алерт + Gitea issue sev:1.
|
||||
|
||||
- [ ] F6-6: Проактивный мониторинг
|
||||
Grafana rules: диск >85% (node_exporter); cert-check.sh: TLS <14 дней → алерт.
|
||||
Приёмка: тестовые алерты по диску и сертификату получены в Telegram.
|
||||
|
||||
- [ ] F6-7: Ретроспектива + runbook'и + baseline v1.4
|
||||
Runbook'и: update-manager, user-provisioning. Закрытие чек-листа.
|
||||
Приёмка: тег v1.4 в Gitea, документация в репо.
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Алгоритм safe-update (псевдокод)
|
||||
|
||||
safe-update(service):
|
||||
current = digest запущенного образа
|
||||
backup: volume snapshot + pg_dump (если DB) → /var/backups/update-manager/ (хранить 7 дней)
|
||||
pull new image; docker compose up -d
|
||||
health = wait_health(3 × 30 сек) + smoke-test
|
||||
if health == OK:
|
||||
stable-versions.json[service] = new_version; git commit; Telegram "✅ Обновлено"
|
||||
else:
|
||||
deploy(current) # авто-откат
|
||||
wait_health
|
||||
Telegram "🚨 Откат выполнен" + Gitea issue sev:1; exit 1
|
||||
|
||||
## 🔐 Алгоритм provisioning (псевдокод)
|
||||
|
||||
request(form) → provisioning_record + Telegram владельцу [Approve/Reject]
|
||||
approve(token):
|
||||
authentik.create_user(name, email)
|
||||
authentik.assign_groups(requested_services)
|
||||
link = authentik.enrollment_token(ttl=24h)
|
||||
telegram.owner(instructions + link)
|
||||
gitea.issue("User provisioned: ...", labels=[provisioned])
|
||||
reject: лог + уведомление заявителю (если есть канал)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Риски и меры
|
||||
| Риск | Мера |
|
||||
|------|------|
|
||||
| Миграции БД ломают данные | pg_dump ДО обновления; healthcheck DB-сервисов включает контрольный запрос |
|
||||
| Ложный healthcheck → лишний откат | 3 попытки × 30 сек + smoke-test per service |
|
||||
| Обновление Authentik (critical) | healthcheck: /health + OIDC discovery endpoint; окно обновлений только вручную |
|
||||
| Злоупотребление формой регистрации | Одобрение только владельцем; одноразовые токены; rate-limit в n8n |
|
||||
|
||||
## ✅ Definition of Done
|
||||
- [ ] Все 7 задач закрыты коммитами
|
||||
- [ ] Rollback-drill пройден и задокументирован
|
||||
- [ ] Тест-пользователь создан через self-service и вошёл по SSO
|
||||
- [ ] Тег v1.4 создан в Gitea
|
||||
|
||||
## 📦 Backlog (Фаза 7+)
|
||||
GitOps (ArgoCD), OpenClaw L1-ремонт, OpenTelemetry, LLM RAG-ассистент, Policy as Code.
|
||||
Reference in new issue
Block a user