Безопасное обновление начинается с ответа на два вопроса: какой точный артефакт мы выпускаем и до какого момента можем вернуться без потери данных. Сборка на production-сервере, ручное копирование отдельных файлов и необратимая миграция в начале деплоя не дают надёжного ответа ни на один.
Соберите пакет или контейнер один раз в CI, присвойте ему версию или digest и продвигайте тот же артефакт через staging в production. Конфигурация окружения и секреты подключаются отдельно. Тогда проверенная версия не меняется между этапами из-за новой установки зависимостей.
Release manifest делает выпуск воспроизводимым
release_id: 2026-10-01.4
commit: abc123-demo
artifact_digest: sha256:example
database_migration: 20261001_add_state_nullable
feature_flags: [new_checkout=false]
previous_release: 2026-10-01.3
rollback_owner: on-callЗначения условные, но набор должен быть реальным для вашего проекта. Запись релиза связывает код, схему, конфигурацию и владельца решения. Тег latest для аудита недостаточен: через час он может указывать на другой образ.
Миграция данных проходит через совместимое окно
Используйте expand-and-contract: сначала добавить новую nullable-колонку или таблицу, затем выпустить код, который понимает старую и новую схему, заполнить данные отдельно и только после наблюдения удалить старое. Откат кода в таком окне не требует мгновенно откатывать данные.
Резервная копия помогает только после проверки восстановления. Зафиксируйте время создания, охват, шифрование, место хранения и команду restore в изолированное окружение. Для большой таблицы оцените lock и длительность на копии production-объёма; слово «миграция» в логе не означает, что она безопасна под нагрузкой.
Новая версия сначала доказывает готовность
| Проверка | Что подтверждает | Что делать при провале |
|---|---|---|
| Startup | Процесс закончил инициализацию | Не перезапускать его бесконечно liveness-проверкой |
| Readiness | Экземпляр способен принимать трафик | Убрать из балансировки |
| Smoke | Критический путь работает с зависимостями | Остановить продвижение |
| Ошибки и latency | Пользовательский результат не ухудшился | Поставить rollout на паузу |
| Очереди и миграции | Фоновые процессы совместимы | Не считать HTTP 200 достаточным |
Kubernetes разделяет startup, readiness и liveness probes: они отвечают на разные вопросы. Readiness не должна лгать ради зелёного deployment. Если база недоступна и экземпляр не может обслужить запрос, трафик к нему преждевременен; если временно не готов к трафику, это ещё не повод убивать процесс.
Малая порция трафика ограничивает радиус ошибки
- Сначала выпускается один экземпляр или небольшой процент трафика.
- Сравниваются error rate, latency и бизнес-сигнал критического сценария.
- Автоматический порог останавливает продвижение, а не ждёт ручного просмотра графика.
- Дальнейшие порции увеличиваются только после заданного окна наблюдения.
- Deployment environment ограничивает ветки, доступ к секретам и условия допуска.
GitHub environments позволяют ставить protection rules перед job, ограничивать deploy-ветки и выдавать environment secrets только после прохождения условий. Это один из вариантов реализации барьера; независимо от инструмента выпуск должен оставлять журнал, кто или какое правило разрешило production.
Rollback возвращает код, но не стирает последствия
Kubernetes хранит историю rollout для изменений Pod template и позволяет откатить Deployment, однако такой откат не возвращает базу, сообщения очереди или вызовы внешних API. Поэтому команда rollback сопровождается планом данных: feature flag, forward fix, компенсирующая операция или восстановление из проверенной копии.
- Развернуть новую версию без трафика и выполнить smoke-проверку.
- Направить малую порцию, затем искусственно нарушить один контрольный критерий.
- Убедиться, что rollout остановился и оповещение содержит release ID.
- Вернуть предыдущий артефакт и проверить критический пользовательский путь.
- Отдельно восстановить тестовую копию базы и измерить фактическое время.
Для настройки процесса пригодятся текущая схема деплоя, список миграций, требования к простою, объём базы, критические URL и доступные метрики. Начните с одного проекта и одного отрепетированного отката; сложная платформа без рабочего аварийного пути только быстрее доставляет ошибки.