docs: план ночного спринта по централизации баз и правила безопасности

This commit is contained in:
root committed 2026-10-14 19:26:45 +03:00
1 parent 66288369f8
commit 16f715fd8a
1 file changed
+181
+181
View File
@@ -0,0 +1,181 @@
# Ночной спринт: централизация баз — план и правила
**Дата создания:** 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. Главный принцип спринта
За сегодняшний день мы трижды видели одно и то же: **система сообщала
об успехе, ничего не сделав.** Пустой снимок внешней копии, старый образ
в обновлённом контейнере, задача, созданная только в журнале.
Поэтому в ночном спринте **«сделано» означает «проверено»**, и ничто
другое. Каждый пункт отчёта будет содержать не «команда выполнена», а
**чем именно подтверждён результат**.