Команда validate полезна, но не доказывает, что новая миграция выполнится на ваших данных. Она обнаруживает расхождения имён, типов, checksum и истории. Добавьте второй барьер: разверните временную базу, примените миграции с нуля, затем отдельно обновите обезличенную копию схемы и репрезентативных данных из состояния, близкого к production.

До запуска договоритесь о неизменяемом артефакте: CI проверяет конкретный commit, набор migration files, образ приложения и версию migration tool. После approval нельзя заново собирать «тот же» релиз из изменившейся ветки. Отчёт должен показывать, что именно было проверено, к какой исходной версии базы применялось и сколько заняли шаги.

Одна проверка ловит только один класс ошибок

БарьерЧто обнаруживаетЧто не доказывает
Lint или парсер SQLОпечатки и запрещённые конструкции проектаСовместимость с данными и версией СУБД
Flyway validateИзменённые checksum, отсутствующие и pending migrationsУспешное выполнение новой логики
Migrate на пустой базеПолноту цепочки и порядок создания объектовUpgrade старой populated schema
Migrate на копииКонфликт с данными, constraints и driftТочное время на production hardware
Интеграционные тестыОжидания приложения после измененияБлокировки под реальным трафиком
Canary или первая волнаОшибки реального окруженияБезопасность без стоп-сигналов

Если CI использует только новую пустую базу, он не увидит NOT NULL на таблице со старыми null, дубликаты перед UNIQUE или данные, которые не помещаются в новый тип. Если тестирует только копию, может скрыться пропущенная ранняя миграция. Два пути дополняют друг друга.

Минимальный pipeline сохраняет следы решения

stages:
  - migration-static-check
  - flyway-info-and-validate
  - migrate-empty-database
  - migrate-sanitized-production-shape
  - run-old-and-new-app-contract-tests
  - estimate-locks-and-duration
  - produce-plan-and-artifacts
  - approval
  - production-migrate
  - smoke-test-and-observe

artifacts:
  commit: exact-sha
  migration_checksums: recorded
  database_engine_version: recorded
  tool_version: recorded
  logs: secrets-masked

Flyway info показывает состояние и pending migrations, а validate сравнивает применённую историю с доступными файлами. Следом migrate должен выполняться на временной базе именно той версии СУБД, которую вы поддерживаете. Connection string и пароль приходят из CI secret store и не печатаются в command trace.

Изменение схемы переживает две версии приложения

При rolling deploy старая и новая версии некоторое время работают одновременно. Поэтому удаление или переименование столбца в том же релизе, где новый код перестал его использовать, ломает ещё не обновлённые instances. Безопасная последовательность — expand, переключение, contract.

  1. Expand: добавить совместимый столбец или таблицу без удаления старого пути.
  2. Deploy кода: новая версия умеет читать прежнее состояние и заполнять новое.
  3. Backfill: переносить данные порциями с checkpoints и наблюдаемой скоростью.
  4. Switch: перевести чтение на новую структуру и проверить расхождения.
  5. Contract: удалить старый объект отдельной миграцией после периода совместимости.

Откат кода не равен откату схемы. Если новая версия уже записала данные в новом формате, обратная migration может быть разрушительной. Для каждого шага укажите: можно ли повторить выполнение, что произойдёт после частичного сбоя, какая версия приложения совместима и каким запросом проверяется завершение.

Блокировки и длительность проверяются отдельно

ИзменениеРиск на живой базеРепетиция
Индекс большой таблицыОбычная сборка может блокировать writesКопия размера production, locks и progress
Новый NOT NULLСтарые строки нарушают constraintPrecheck count, backfill, затем constraint
Изменение типаПерезапись или несовместимые значенияРазмер, duration, disk headroom, bad rows
Backfill одним UPDATEДлинная transaction, WAL и lock pressureПорции, паузы, checkpoint и restart
Удаление столбцаСтарый код ещё читает объектContract test обеих версий

В PostgreSQL обычный CREATE INDEX блокирует записи в таблицу на время построения, а CREATE INDEX CONCURRENTLY снимает эту конкретную блокировку ценой дополнительных проходов и ограничений. Это не универсальный совет для любой СУБД. Выберите конструкцию по документации вашей версии и измерьте её на близком объёме данных.

Стоп-сигналы задаются до production запуска

  • Migration tool сообщает checksum mismatch, missing migration или unexpected state.
  • Precheck находит строки, которые нарушат новый constraint.
  • Время репетиции превышает допустимое окно с согласованным запасом.
  • Появляется lock wait выше порога проекта или растёт очередь запросов приложения.
  • Старая либо новая версия приложения не проходит общий contract test.
  • Нет проверенного способа остановить backfill и продолжить с checkpoint.

При stop-сигнале pipeline не выполняет repair автоматически. Эта команда меняет schema history и может спрятать причину расхождения; её применяют только после разбирательства и зафиксированного решения. Аналогично автоматический destructive rollback опасен, если миграция успела удалить или преобразовать данные.

Релиз заканчивается проверкой состояния, а не exit code

После migrate сохраните info, текущую schema version и длительность, затем выполните smoke tests чтения и записи через приложение. Смотрите error rate, latency, lock waits, replication lag и ресурсы базы в заранее выбранном окне. Первая волна или canary нужна для остановки до массового обновления, а не для наблюдения уже завершённого глобального сбоя.

Для внедрения подготовьте migration directory, текущую schema history, версии СУБД и инструмента, размеры затронутых таблиц, topology развёртывания и требования к простою. Снимок данных должен быть обезличен, а production credential не должен покидать защищённое окружение. По этому набору можно построить реальный preflight без доступа разработчиков к боевой базе.

Проверенные источники