Jak řešíte migraci databází v CI/CD?

Question

Accepted Answer

**Migrace databází** (změny schématu) jsou jednou z nejtrickiest částí CI/CD — na rozdíl od bezstavového kódu aplikace uchovávají databáze **stav**, který nelze jednoduše nahradit nebo vrátit. Pečlivé řešení migrací (automatizace, zpětná kompatibilita, bezpečné vzory) je nezbytné pro spolehlivá nasazení.

## Proč jsou migrace databází náročné

```text
App code is stateless (replace it, roll back freely). DATABASES hold STATE:
  → can't just "roll back" a migration that dropped a column or transformed data
    (the data may be gone) → rollbacks are risky/impossible for destructive changes
  → during deployment, OLD and NEW app code may run SIMULTANEOUSLY (rolling deploy) —
    both must work with the database schema at that moment
→ Schema changes need careful coordination with code deployment.
```

## Automatizace migrací v pipeline

```text
→ Migrations defined as CODE (versioned migration files; Flyway, Liquibase, ORM tools)
→ Run migrations as a pipeline STEP (apply pending migrations on deploy)
→ Migrations are versioned and applied in order, idempotently
→ Test migrations in staging before production
```

## Bezpečné vzory migrací (zpětná kompatibilita)

```text
KEY PRINCIPLE: make migrations BACKWARD-COMPATIBLE so old AND new code both work during
the transition. Use the EXPAND-CONTRACT (parallel change) pattern:
  1. EXPAND → add the new schema (e.g. add a new column) — old code still works
  2. MIGRATE → deploy code that writes to both / reads new; backfill data
  3. CONTRACT → once all code uses the new schema, remove the old (in a LATER deploy)
→ NEVER drop/rename in the same deploy that needs it gone — split across deploys.
→ This enables zero-downtime deploys and safe rollbacks.
```

## Proč na tom záleží

Rozmění si, jak zvládat migrace databází v CI/CD, je důležité, protože **migrace patří mezi nejtěžší a nejrizikovější části automatizovaného nasazování**, takže je to cenné praktické znalosti pro spolehlivé nasazování.

Jádrem problému je, že na rozdíl od bezstavového kódu aplikace (který lze bez problémů nahradit a vrátit), **databáze uchovávají stav** — takže migrace, která smaže sloupec nebo transformuje data, **se nemůže jednoduše vrátit** (data mohou být ztracena), čímž se destruktivní změny stávají rizikovými nebo nevratitelnými, a během postupného nasazování **starý a nový kód běží současně**, přičemž oba musí pracovat se schématem v daný čas.

To vyžaduje, aby byly změny schématu pečlivě koordinovány, na rozdíl od zbytku CI/CD.

Pochopení **automatizace migrací** (jejich definování jako verzovaného kódu prostřednictvím nástrojů jako Flyway, Liquibase nebo ORM migrací, jejich spouštění jako kroku pipeline aplikovaného v pořadí a idempotentně a testování nejdříve v staging prostředí) přináší migrace do automatizovaného pipeline bezpečně.

Nejdůležitější je pochopení **bezpečných vzorů migrací** — vytvoření migrací **zpětně kompatibilních**, aby starý i nový kód fungovaly během přechodu, využití **vzoru expand-contract (paralelní změny)** (expand: přidání nového schématu bez porušení starého kódu; migrate: přechod kódu a backfill dat; contract: odebrání starého schématu v pozdějším nasazení) a **nikdy se neodstraňují/přejmenovávají ve stejném nasazení, které je již nepotřebuje** — je to klíčová dovednost, která umožňuje **nasazování bez prostojů a bezpečné vrácení** navzdory stavovému charakteru databází.

Jde opravdu o trický, důležitý praktický problém z reálného světa, který rozlišuje ty, kdo dokážou bezpečně nasadit změny databází, od těch, kdo způsobují výpadky nebo ztrátu dat.

Praktická důležitost řešení migrací databází v CI/CD spočívá v tom, že migrace databází jsou náročná, riziková a nevyhnutelná součást nasazování aplikací s databázemi, a protože jejich pečlivé zvládání (automatizace plus vzory zpětně kompatibilního expand-contract) je nezbytné pro spolehlivá nasazování bez prostojů, pochopení migrací databází v CI/CD je cenné, prakticky důležité znalosti — řeší jeden z nejtrickiest aspektů continuální dodávky a odráží zralost potřebnou k bezpečnému nasazování stavových aplikací.