Come gestisci le migrazioni del database in CI/CD?

Question

Accepted Answer

**Le migrazioni del database** (cambiamenti dello schema) sono una delle parti più complicate di CI/CD — a differenza del codice applicativo stateless, i database contengono **stato** che non può semplicemente essere sostituito o rollbackato. Gestire le migrazioni con attenzione (automazione, compatibilità all'indietro, pattern sicuri) è essenziale per deployment affidabili.

## Perché è importante

```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.
```

## Automazione delle migrazioni nella 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
```

## Pattern di migrazione sicuri (compatibilità all'indietro)

```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.
```

## Perché è importante

Capire come gestire le migrazioni del database in CI/CD è importante perché **le migrazioni sono una delle parti più difficili e rischiose del deployment automatizzato**, quindi è una conoscenza pratica preziosa per una delivery affidabile.

La sfida principale è che, a differenza del codice applicativo stateless (che può essere sostituito e rollbackato liberamente), **i database contengono stato** — quindi una migrazione che elimina una colonna o trasforma dati **non può semplicemente essere rollbackata** (i dati potrebbero essere persi), rendendo i cambiamenti distruttivi rischiosi o irreversibili, e durante i deployment rolling **il codice vecchio e nuovo girano simultaneamente**, entrambi dovendo funzionare con lo schema in quel momento.

Questo rende i cambiamenti di schema richiedenti un coordinamento attento, diversamente dal resto di CI/CD.

Capire come **automatizzare le migrazioni** (definendole come codice versionato tramite tool come Flyway, Liquibase, o ORM migrations, eseguendole come step della pipeline applicati in ordine e idempotentemente, e testando prima in staging) porta le migrazioni nella pipeline automatizzata in modo sicuro.

Più importantemente, capire i **pattern di migrazione sicuri** — rendere le migrazioni **backward-compatible** in modo che il codice vecchio e nuovo funzionino entrambi durante la transizione, usando il **pattern expand-contract (parallel change)** (expand: aggiungere nuovo schema senza rompere il codice vecchio; migrate: transitare il codice e backfill dei dati; contract: rimuovere lo schema vecchio in un deploy successivo) e **mai droppare/rinominare nello stesso deploy in cui serve eliminato** — è la skill chiave che abilita **deployment zero-downtime e rollback sicuri** nonostante la natura stateful dei database.

Questa è genuinamente una conoscenza complicata, importante nel mondo reale che distingue chi può deployare cambiamenti di database in sicurezza da chi causa outage o perdita di dati.

Poiché le migrazioni del database sono una parte difficile, rischiosa e inevitabile del deployment di applicazioni con database, e poiché gestirle con attenzione (automazione più pattern expand-contract backward-compatible) è essenziale per deployment affidabili e zero-downtime, capire le migrazioni del database in CI/CD è una conoscenza pratica e importantemente utile — affrontando uno degli aspetti più complessi della continuous delivery e riflettendo la maturità necessaria per deployare applicazioni stateful in sicurezza.