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

6.7 KiB
Raw Blame History

🚀 СПРИНТ 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.