Files
buryan-infra/ops/migration/README.md

79 lines
4.0 KiB
Markdown
Raw Permalink 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.
# Первая боевая миграция: 1 ТБ SSD → медиатека
## Проверка совместимости (факты)
| Параметр | Значение |
|---|---|
| Плата | **H610D4-P1/TPM** (десктопная mATX) |
| SATA-контроллер | **есть** — Intel Alder Lake-S PCH SATA [AHCI] |
| Текущий диск | один NVMe 476.9 ГБ |
| Разметка | LVM: root 111 ГБ, data-pool 348.8 ГБ, backups 100 ГБ |
| Свободно в data-pool | ~78 ГБ |
**Вывод: 2.5″ SATA SSD подходит.** Проверить в корпусе:
1. свободный SATA-порт на плате;
2. свободный разъём питания SATA от БП;
3. место для крепления 2.5″.
## Сценарий (рекомендуемый): диск = медиатека
```
NVMe 477 ГБ → система, контейнеры, базы
SSD 1 ТБ → /mnt/media (фильмы, сериалы, музыка, книги, загрузки)
```
Без переустановки. Простой: 10–20 минут (остановка медиасервисов на время
финальной синхронизации).
## Порядок (скрипты в этой папке)
| Шаг | Скрипт | Что делает |
|---|---|---|
| 1 | `01_prepare_disk.sh /dev/sdX` | план разметки (без изменений) |
| 1а | `01_prepare_disk.sh /dev/sdX --apply` | GPT + раздел + ext4 + метка `media` |
| 2 | `02_copy_media.sh /mnt/new-media` | копирование без простоя, с проверкой места |
| 3 | `03_switch.sh /dev/sdX1` | финальная синхронизация, fstab, запуск, проверка |
| 4 | `04_rollback.sh /etc/fstab.bak-…` | откат на старый диск |
### Встроенные защиты
* проверка свободного места перед копированием;
* отказ при пустом источнике;
* сверка размеров после синхронизации (порог 2%);
* резервная копия `/etc/fstab` с меткой времени;
* автоматический откат, если новый диск не смонтировался.
## Проверено в песочнице
Все четыре шага прогнаны на loop-устройствах:
```
01: /dev/loop2p1 отформатирован, метка media ✅
02: нужно 35 МБ, свободно 448 МБ → размеры сходятся ✅
03: источник 35 МБ, копия 35 МБ → смонтирован новый диск ✅
04: откат → смонтирован старый диск, данные на месте ✅
```
Найдено и исправлено в процессе:
1. `rsync` не должен по умолчанию брать живой `/mnt/media` — добавлен `SRC`;
2. `mount` не должен зависеть от пути fstab — монтируем по устройству;
3. нет `parted` на хосте — добавлен `sgdisk`-фолбэк;
4. не было защиты от пустого источника — добавлена.
## Что будет после миграции
* освобождается ~80 ГБ на системном диске;
* медиатека получает 1 ТБ вместо 44 ГБ;
* скорость SATA SSD для медиа достаточна (последовательное чтение 400–500 МБ/с).
## Риски
| Риск | Смягчение |
|---|---|
| Диск не определяется | проверить кабель/питание до разметки |
| Копия неполная | сверка размеров, отказ от переключения |
| Сервисы не поднялись | `04_rollback.sh` возвращает старую медиатеку |
| Потеря данных | старый каталог не удаляется до проверки |