re:re:actable
Урок 022 минуты чтения

Как выполнять миграции и резервное копирование в production

На этой странице
Кратко

Деплой приложения и изменение схемы БД — связанные процессы. Резервная копия полезна только тогда, когда известно, как восстановить ее в рабочую базу.

Вопрос

Как выпустить новую версию и не повредить пользовательские задачи?

Основная идея

Миграции запускают контролируемым шагом публикации, а не при каждом HTTP-запросе. Несколько экземпляров приложения не должны независимо пытаться применить одно изменение.

При постепенном обновлении некоторое время работают старый и новый код. Поэтому полезна схема expand → migrate → contract:

  1. Добавить совместимое поле или таблицу.
  2. Выпустить код, который понимает старые и новые данные.
  3. Заполнить данные и проверить результат.
  4. Удалить старую структуру отдельным последующим выпуском.

Пример: добавить необязательный срок задачи

-- 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 и восстановление на момент времени.

Что важно помнить

Копия содержит и закрытые данные авторизации. Ограничь доступ к ней, шифруй хранение и установи сроки удаления. Проверяй не только наличие файла, но и реальное восстановление таблиц и связей.

Удаление столбца, изменение типа и создание индекса на большой таблице могут надолго блокировать работу. Изучи способ выполнения и проверь его на реалистичном объеме. Откат кода не откатывает автоматически уже измененную БД.

Мини-шпаргалка

  • Миграции — отдельный управляемый этап.
  • Изменения должны учитывать старые экземпляры приложения.
  • Резервную копию проверяют восстановлением.
  • Перед опасной миграцией нужен план возврата.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам