From 07dd6dc8a25ee6c62c525bc2766a3f169d0d8cce Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Thu, 8 Oct 2026 22:32:11 +0300 Subject: [PATCH] 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 --- ops/audit/SPRINT-F6-PLAN-v2.md | 117 +++++++++++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 ops/audit/SPRINT-F6-PLAN-v2.md diff --git a/ops/audit/SPRINT-F6-PLAN-v2.md b/ops/audit/SPRINT-F6-PLAN-v2.md new file mode 100644 index 0000000..734b0d4 --- /dev/null +++ b/ops/audit/SPRINT-F6-PLAN-v2.md @@ -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 : + 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.