Documentation

Migrations

Version schema changes with controlled rollout.

Overview

Run migrations at startup or via CI/CD steps with clear ordering.

Example

Go

migs, _ := migrate.Load("migrations", "")
_, _ = engine.Up(ctx, migs, 0)

Best Practices

  • Prefer forward-only migrations in production.
  • Test migration plans against snapshots.

Common Pitfalls

  • Mixing DDL and risky data rewrites in one step.
  • No rollback strategy for critical releases.