Files
buryan-infra/docs/NIGHT-SPRINT-PLAN.md
T

12 KiB

Ночной спринт: централизация баз — план и правила

Дата создания: 2026-10-14 Статус: ожидает подтверждения владельцем


1. Прямые ответы на два вопроса

Смогу ли я сделать это за ночь?

Да, работать ночью смогу — но не бесконечно и не «всё подряд».

Механика такая: я работаю не непрерывно, а раундами. Чтобы раунды шли один за другим без вашего участия, в начале спринта я ставлю цель — она включает автоматическое продолжение. Пока цель активна, я после каждого раунда продолжаю сам.

Но честно: обещать, что я закончу весь список, я не могу. Причины:

  • Перенос баз — это цепочка, где каждое звено зависит от предыдущего. Ускорить её нельзя, не рискуя данными.
  • Часть шагов требует остановки сервиса и проверки, что он поднялся.
  • Если что-то пойдёт не так, я обязан остановиться и разобраться, а не идти дальше по плану.

Я предпочту сделать пять пунктов полностью проверенными, чем двенадцать недоделанными. Для инфраструктуры второе хуже, чем ничего.

Что произойдёт, если закончится лимит?

Работа остановится на полуслове. Это главный риск ночного спринта, и защита от него — не надежда, а конструкция:

Риск Защита
Остановка посреди переноса Каждый шаг атомарный: либо выполнен и проверен, либо откачен. Незавершённых «наполовину» состояний быть не должно
Потеря памяти о сделанном Журнал пишется после каждого шага, а не в конце. Контекст может сжаться — журнал останется
Сервис остался нерабочим Пока цель не проверена, источник не трогается. Переключение конфигурации — последним шагом и обратимо
Невозможно понять, где остановились Каждый пункт имеет статус: не начат / выполняется / проверен. Возобновление — с первого непроверенного

При исчерпании лимита состояние будет ровно таким: всё, что отмечено проверенным, — работает; всё, что не отмечено, — не тронуто. Именно ради этого журнал и атомарность.


2. Что мне нужно от вас

  1. Полный доступ — да.
  2. Подтверждение списка работ (раздел 4).
  3. Запреты — что мне нельзя трогать ни при каких обстоятельствах (раздел 3).
  4. Правило остановки — по какому признаку я обязан прекратить и ждать вас.
  5. Время на сон — если вам нужно, чтобы в 8:00 всё работало, я должен знать это заранее: незавершённый перенос базы может занять сервис на несколько минут.

3. Правила безопасности, которые я предлагаю

Я буду соблюдать их без напоминаний. Если правило мешает выполнить задачу — я останавливаюсь и спрашиваю, а не нарушаю его.

  1. Ничего не удаляю без проверенной копии, снятой непосредственно перед этим. И «проверенной» означает: я открыл копию и убедился, что в ней есть данные, а не что команда завершилась нулём.
  2. Ни один сервис не остаётся нерабочим. Пока новая база не проверена, старая цела. Переключение конфигурации — обратимо, прежний файл сохраняется.
  3. Один пункт за раз. Следующий начинается только после проверки предыдущего.
  4. После каждого шага — запись в журнал и коммит. Память спринта — это журнал и репозиторий, а не мой контекст.
  5. Стоп-условия. Я останавливаюсь и жду вас, если:
    • пул томов выше 70%;
    • проверка здоровья сервиса не прошла после отката;
    • копия не создалась или не проверяется;
    • обнаружилось расхождение между планом и фактическим состоянием;
    • что-то пошло не так способом, которого нет в плане.
  6. Никаких необратимых действий ночью. В отдельный список (раздел 5).
  7. Всё записывается в репозиторий: что сделано, зачем, как проверено, как откатить.

4. Предлагаемый порядок работ

Этап 0. Аудит — до спринта, при вас

Полная инвентаризация: сервисы, базы, копии, что работает и что нет. Результат — этот план, уточнённый по фактам. Проверяю, что каждый пункт имеет путь отката, и что откат действительно работает.

Этап 1. Уборка безопасного

Что Размер Условие
Мёртвые файловые базы n8n и mealie 99 МБ Подтверждено: сервисы работают с центральной базой, файлы не открыты
Осиротевшая база gitea в PostgreSQL 30 МБ Сначала доказать, что Gitea с ней не работает
Старый кластер PostgreSQL 14 381 МБ Сначала убедиться, что в нём нет баз, которых нет в рабочем

Освободит около 500 МБ и уберёт путаницу.

Этап 2. Кодировка: образец

buryan_monitoring (16 МБ) — наша собственная база, риск минимальный. Отрабатываю процедуру: выгрузка → создание с UTF8 → загрузка → сверка числа строк и таблиц → проверка сервиса.

Без этого этапа дальше идти нельзя: если процедура не отработана, повторять её на боевых базах нельзя.

Этап 3. Кодировка: остальные базы

По одной, от меньшей к большей. После каждой — проверка сервиса.

Этап 4. Перенос файловых баз в PostgreSQL

Сервис Размер Почему в таком порядке
Vaultwarden 288 КБ Маленькая, ценность высокая — проверка процедуры
Grafana 1,5 МБ Простая, отказ безболезненный
Gitea 14 МБ Главный сервис — ближе к концу, чтобы не потерять возможность фиксировать работу
Sonarr, Radarr, Prowlarr, Bazarr 6 МБ Однотипные, идут подряд
Uptime Kuma 160 МБ Самый крупный, отдельным этапом

Paperless — отдельный разговор: он развёрнут дважды и пуст. Сначала решить, какой экземпляр остаётся, потом переносить.

Этап 5. Проверка восстановления

Развернуть копию базы в отдельную базу и сверить число таблиц и строк. Без этого копия не считается копией.

Этап 6. Отчёт

Полный: что сделано, чем подтверждено, что не сделано и почему, что требует внимания, цифры до и после.


5. Что я НЕ буду делать без вас

Даже при полном доступе. Это не обсуждается в ночном режиме:

  1. Удалять резервные копии — ни одной.
  2. Менять секреты и пароли — включая ротацию из отдельного плана.
  3. Трогать сетевые правила, firewall, маршрутизацию.
  4. Удалять данные, для которых нет проверенной копии.
  5. Обновлять ядро, Proxmox, Docker или систему на хосте.
  6. Пересоздавать контейнеры, состояние которых я не могу восстановить.
  7. Работать с внешним VPS — он вне зоны задачи.
  8. Принимать решения о железе — это ваша часть.

6. Формат отчёта в конце

Таблица по каждому пункту:

Пункт Что сделано Чем подтверждено Путь откатa Состояние

Плюс отдельно:

  • что не сделано и почему — честно, без «почти получилось»;
  • что требует вашего решения;
  • что я нашёл попутно — за сегодня таких находок было больше, чем выполненных задач, и они ценнее;
  • цифры до и после: размеры, время, число проверок.

7. Главный принцип спринта

За сегодняшний день мы трижды видели одно и то же: система сообщала об успехе, ничего не сделав. Пустой снимок внешней копии, старый образ в обновлённом контейнере, задача, созданная только в журнале.

Поэтому в ночном спринте «сделано» означает «проверено», и ничто другое. Каждый пункт отчёта будет содержать не «команда выполнена», а чем именно подтверждён результат.