Как выполнять миграции и резервное копирование в production
На этой странице
Деплой приложения и изменение схемы БД — связанные процессы. Резервная копия полезна только тогда, когда известно, как восстановить ее в рабочую базу.
Вопрос
Как выпустить новую версию и не повредить пользовательские задачи?
Основная идея
Миграции запускают контролируемым шагом публикации, а не при каждом HTTP-запросе. Несколько экземпляров приложения не должны независимо пытаться применить одно изменение.
При постепенном обновлении некоторое время работают старый и новый код. Поэтому полезна схема expand → migrate → contract:
- Добавить совместимое поле или таблицу.
- Выпустить код, который понимает старые и новые данные.
- Заполнить данные и проверить результат.
- Удалить старую структуру отдельным последующим выпуском.
Пример: добавить необязательный срок задачи
-- migrations/003_task_due_date.sql
ALTER TABLE tasks ADD COLUMN due_at timestamptz;Старые запросы с явным списком столбцов продолжают работать. Новое поле допускает NULL, поэтому существующие задачи не требуют немедленного заполнения.
Не назначай номер 003, если предыдущие дополнительные миграции не использовались: в реальном проекте номера идут по фактической истории. Migration runner хранит журнал примененных версий.
Пример: копия и проверка восстановления
При установленных PostgreSQL client tools, с заменой учебного хоста и пользователя:
pg_dump --host=localhost --username=next_app --dbname=next_tasks --format=custom --file=tasks-backup.dump --password
createdb --host=localhost --username=next_app next_tasks_restore --password
pg_restore --host=localhost --username=next_app --dbname=next_tasks_restore --password tasks-backup.dumpПароль вводится по запросу. Восстановление направлено в новую отдельную базу next_tasks_restore. Для управляемого сервиса вместо этих команд могут использоваться snapshot и восстановление на момент времени.
Что важно помнить
Копия содержит и закрытые данные авторизации. Ограничь доступ к ней, шифруй хранение и установи сроки удаления. Проверяй не только наличие файла, но и реальное восстановление таблиц и связей.
Удаление столбца, изменение типа и создание индекса на большой таблице могут надолго блокировать работу. Изучи способ выполнения и проверь его на реалистичном объеме. Откат кода не откатывает автоматически уже измененную БД.
Мини-шпаргалка
- Миграции — отдельный управляемый этап.
- Изменения должны учитывать старые экземпляры приложения.
- Резервную копию проверяют восстановлением.
- Перед опасной миграцией нужен план возврата.