Files
buryan-infra/ops/audit/SPRINT-F6-PLAN-v2.md
T

118 lines
6.7 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.
# 🚀 СПРИНТ 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) — аудит
---
## 📝 Задачи
- [x] 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.
- [x] F6-2: Self-Service Registration (Authentik)
n8n-форма заявки → одобрение владельцем в Telegram → Authentik API:
пользователь + группы + enrollment-линк (24ч) → инструкция владельцу.
Приёмка: тест-пользователь создан, вошёл по SSO минимум в один сервис;
владелец получил линк и инструкцию; создан audit issue.
- [x] F6-3: Version Watch
cron 6ч: version-watch.sh сверяет Docker Hub / GitHub releases со
stable-versions.json → Gitea issue + Telegram.
Приёмка: получено реальное уведомление о доступном обновлении.
- [x] F6-4: Approval-поток обновлений
Кнопки в Telegram → n8n → update_queue (PG) → update-runner.sh (cron 1 мин)
→ safe-update.sh → результат в Telegram (+ Gitea issue при откате).
Приёмка: одобренное обновление прошло end-to-end, результат в Telegram.
- [x] F6-5: Rollback-drill
Намеренно "сломать" обновление тест-сервиса (битый тег / healthcheck).
Приёмка: авто-откат < 5 мин, сервис восстановлен, алерт + Gitea issue sev:1.
- [x] F6-6: Проактивный мониторинг
Grafana rules: диск >85% (node_exporter); cert-check.sh: TLS <14 дней → алерт.
Приёмка: тестовые алерты по диску и сертификату получены в Telegram.
- [x] 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.