The Pragmatic Engineer

The Pragmatic Engineer

Share this post

The Pragmatic Engineer
The Pragmatic Engineer
Migrations Done Well
Copy link
Facebook
Email
Notes
More

Migrations Done Well

A guide for executing migrations well, at both small and large scales.

Gergely Orosz's avatar
Gergely Orosz
Mar 15, 2022
∙ Paid
109

Share this post

The Pragmatic Engineer
The Pragmatic Engineer
Migrations Done Well
Copy link
Facebook
Email
Notes
More
1
Share

Migrations are one of the most overlooked topics in software engineering, especially at high-growth startups and companies. As a company’s operations grow, new systems and approaches are adopted to cope with extra load, more use cases, or more constraints. From time to time, engineers need to migrate over from an old system or approach, to a new one. 

And this is where things can get interesting, unexpected… and even ugly.

This issue is an extensive guide on the process of migration. You can use it as a blueprint when preparing and executing migrations. This guide covers:

Part 1: Typical migrations

  1. The stories of four different migrations

  2. Types of migrations

Part 2: Executing a migration

  1. Preparation

  2. Pre-migration

  3. The migration

  4. After the migration

  5. The migration’s long-tail

  6. A migration checklist

Part 3: The people and the business side of migrations

  1. The people aspect of migrations

  2. Selling migrations to the business

  3. Closing advice for migrations

  4. Further reading

If you’re not yet a full subscriber, you can read Part 1 of the series here.

This post is for paid subscribers

Already a paid subscriber? Sign in
© 2025 Gergely Orosz
Privacy ∙ Terms ∙ Collection notice
Start writingGet the app
Substack is the home for great culture

Share

Copy link
Facebook
Email
Notes
More