Files
clean-architecture-backend-…/docs/runbooks/migration-failed.md
T

883 B

title, category, error_codes, severity, owner, last_updated, status
title category error_codes severity owner last_updated status
Runbook — MIGRATION_FAILED (DB 마이그레이션 실패) INTERNAL
MIGRATION_FAILED
P1 oncall 2026-06-15 stub

Runbook: MIGRATION_FAILED (runbook://migration/failed)

Symptoms

  • Container exits with code 70 (migration failure exit)
  • Structured log with error.code=MIGRATION_FAILED, startup.phase=migration
  • App refuses to start (fail-fast)

Diagnosis

  • Check Flyway migration log for which script failed and why
  • Review latest migration script for SQL errors

Action

  • Fix migration script or roll back to previous migration version
  • Run migration manually in repair mode if checksum mismatch

Escalation

  • P1 immediate: app cannot start until migration is resolved

Stub: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)