Blog
Practical writing on MongoDB migrations — safe rollbacks, locking for concurrent deploys, running migrations in CI/CD and on app startup, and lessons from real production incidents.
- MongoDB Migration Best Practices: Lessons From a Bad Friday Deploy
July 29, 2026 · 5 min read
Ten MongoDB migration best practices learned the hard way — reversibility, checksums, locking, dry runs, transactions, never deleting history, and running them in CI.
- MongoDB Migrations in CI/CD: A Practical GitHub Actions Setup
July 22, 2026 · 4 min read
A practical setup for running MongoDB migrations in CI/CD — a pending-check gate, machine-readable JSON output, dry-run previews, and locking that survives concurrent pipeline runs.
- Running MongoDB Migrations on App Startup and in Serverless (Safely)
July 15, 2026 · 4 min read
How to run MongoDB migrations safely from your app's startup code or a serverless function — without leaking connections or letting parallel instances race.
- Stop Concurrent Deploys From Corrupting Your Database: MongoDB Migration Locking
July 8, 2026 · 5 min read
Two deploys running migrations at the same time can corrupt your database. Here's how a MongoDB-native distributed lock prevents it — with TTLs, stale-lock reclaim, and heartbeats.
- How to Roll Back a Single MongoDB Migration (Without Nuking the Rest)
July 1, 2026 · 4 min read
migrate-mongo only rolls back the last migration. Here's how to roll back one specific MongoDB migration safely — by file, by batch, or the last N — without nuking the rest.
- 7 Things migrate-mongo Can't Do (That Cost Me in Production)
June 24, 2026 · 5 min read
Seven real gaps in migrate-mongo that cost time and caused production incidents — single-file rollback, dry-run, native locking, checksums, transactions, and more.
- Switching from migrate-mongo to mongo-migrate-kit: A Zero-Downtime, Non-Destructive Guide
June 17, 2026 · 5 min read
A step-by-step, zero-downtime guide to switching from migrate-mongo to mongo-migrate-kit without breaking anything that already works.
- Why I Built a New MongoDB Migration Tool — and Migrated Off migrate-mongo in One Command
June 10, 2026 · 6 min read
The story behind mongo-migrate-kit: how migrate-mongo's inability to roll back one bad migration on a Friday led to a new MongoDB migration tool — and how to switch in one command.