Команда 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-maskedFlyway info показывает состояние и pending migrations, а validate сравнивает применённую историю с доступными файлами. Следом migrate должен выполняться на временной базе именно той версии СУБД, которую вы поддерживаете. Connection string и пароль приходят из CI secret store и не печатаются в command trace.
Изменение схемы переживает две версии приложения
При rolling deploy старая и новая версии некоторое время работают одновременно. Поэтому удаление или переименование столбца в том же релизе, где новый код перестал его использовать, ломает ещё не обновлённые instances. Безопасная последовательность — expand, переключение, contract.
- Expand: добавить совместимый столбец или таблицу без удаления старого пути.
- Deploy кода: новая версия умеет читать прежнее состояние и заполнять новое.
- Backfill: переносить данные порциями с checkpoints и наблюдаемой скоростью.
- Switch: перевести чтение на новую структуру и проверить расхождения.
- Contract: удалить старый объект отдельной миграцией после периода совместимости.
Откат кода не равен откату схемы. Если новая версия уже записала данные в новом формате, обратная migration может быть разрушительной. Для каждого шага укажите: можно ли повторить выполнение, что произойдёт после частичного сбоя, какая версия приложения совместима и каким запросом проверяется завершение.
Блокировки и длительность проверяются отдельно
| Изменение | Риск на живой базе | Репетиция |
|---|---|---|
| Индекс большой таблицы | Обычная сборка может блокировать writes | Копия размера production, locks и progress |
| Новый NOT NULL | Старые строки нарушают constraint | Precheck 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 без доступа разработчиков к боевой базе.