¿Cómo se manejan las migraciones de base de datos en CI/CD?

Question

Accepted Answer

**Las migraciones de base de datos** (cambios de esquema) son una de las partes más complicadas de CI/CD — a diferencia del código de aplicación sin estado, las bases de datos contienen **estado** que no puede simplemente reemplazarse o revertirse. Manejar las migraciones cuidadosamente (automatización, compatibilidad hacia atrás, patrones seguros) es esencial para despliegues confiables.

## Por qué es 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.
```

## Automatizar migraciones en el 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
```

## Patrones de migración seguros (compatibilidad hacia atrás)

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

## Por qué es importante

Entender cómo manejar las migraciones de base de datos en CI/CD es importante porque **las migraciones son una de las partes más difíciles y riesgosas del despliegue automatizado**, por lo que es un conocimiento práctico valioso para la entrega confiable.

El desafío central es que, a diferencia del código de aplicación sin estado (que puede ser reemplazado y revertido libremente), **las bases de datos contienen estado** — por lo que una migración que elimina una columna o transforma datos **no puede simplemente revertirse** (los datos pueden estar perdidos), haciendo que los cambios destructivos sean riesgosos o irreversibles, y durante despliegues gradientes **el código antiguo y nuevo se ejecutan simultáneamente**, ambos necesitando funcionar con el esquema en ese momento.

Esto hace que los cambios de esquema requieran coordinación cuidadosa, a diferencia del resto de CI/CD.

Entender cómo **automatizar migraciones** (definiéndolas como código versionado mediante herramientas como Flyway, Liquibase u migraciones ORM, ejecutándolas como un paso del pipeline aplicado en orden e idempotentemente, y probando primero en staging) trae migraciones al pipeline automatizado de forma segura.

Lo más importante es entender **patrones de migración seguros** — hacer migraciones **hacia atrás compatibles** para que el código antiguo y nuevo funcionen durante la transición, usando el **patrón expand-contract (cambio paralelo)** (expandir: añadir nuevo esquema sin romper código antiguo; migrar: transicionar código y rellenar datos; contraer: eliminar esquema antiguo en un despliegue posterior) y **nunca eliminar/renombrar en el mismo despliegue que lo necesita eliminado** — es la habilidad clave que permite **despliegues sin tiempo de inactividad y reversiones seguras** a pesar de la naturaleza con estado de las bases de datos.

Este es genuinamente un conocimiento complicado, importante y real que distingue a quienes pueden desplegar cambios de base de datos de forma segura de quienes causan interrupciones o pérdida de datos.

Puesto que las migraciones de base de datos son una parte difícil, riesgosa e inevitable de desplegar aplicaciones con bases de datos, y puesto que manejarlas cuidadosamente (automatización más patrones expand-contract compatibles hacia atrás) es esencial para despliegues confiables y sin tiempo de inactividad, entender las migraciones de base de datos en CI/CD es un conocimiento valioso y prácticamente importante — abordando uno de los aspectos más complicados de la entrega continua y reflejando la madurez necesaria para desplegar aplicaciones con estado de forma segura.