Bagaimana Anda menangani migrasi database di CI/CD?

Question

Accepted Answer

**Migrasi database** (perubahan schema) adalah salah satu bagian paling rumit dari CI/CD — berbeda dengan kode aplikasi yang stateless, database menyimpan **state** yang tidak dapat begitu saja diganti atau di-rollback. Menangani migrasi dengan hati-hati (otomasi, kompatibilitas backward, pola aman) sangat penting untuk deployment yang andal.

## Mengapa migrasi database itu sulit

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

## Mengotomatisasi migrasi di 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
```

## Pola migrasi yang aman (kompatibilitas backward)

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

## Mengapa ini penting

Memahami cara menangani migrasi database di CI/CD penting karena **migrasi adalah salah satu bagian tersulit dan paling berisiko dari automated deployment**, sehingga merupakan pengetahuan praktis yang berharga untuk reliable delivery.

Tantangan inti adalah bahwa, berbeda dengan kode aplikasi stateless (yang dapat diganti dan di-rollback dengan bebas), **database menyimpan state** — jadi migrasi yang menghapus kolom atau mengubah data **tidak dapat begitu saja di-rollback** (data mungkin hilang), membuat perubahan yang bersifat destructive berisiko atau tidak dapat dipulihkan, dan selama rolling deployments **kode lama dan baru berjalan bersamaan**, keduanya harus bekerja dengan schema pada saat itu.

Ini membuat perubahan schema memerlukan koordinasi yang hati-hati, tidak seperti bagian lain dari CI/CD.

Memahami cara **mengotomatisasi migrasi** (mendefinisikannya sebagai versioned code melalui tools seperti Flyway, Liquibase, atau ORM migrations, menjalankannya sebagai langkah pipeline yang diterapkan secara berurutan dan idempotent, dan testing di staging terlebih dahulu) membawa migrasi ke dalam automated pipeline dengan aman.

Paling penting, memahami **pola migrasi yang aman** — membuat migrasi **backward-compatible** sehingga kode lama dan baru sama-sama bekerja selama transisi, menggunakan **expand-contract pattern (parallel change)** (expand: tambahkan schema baru tanpa merusak kode lama; migrate: transisikan kode dan backfill data; contract: hapus schema lama di deployment kemudian hari) dan **jangan pernah menghapus/rename dalam deployment yang sama yang membutuhkannya untuk dihapus** — adalah keterampilan kunci yang memungkinkan **zero-downtime deployments dan safe rollbacks** terlepas dari sifat stateful dari database.

Ini benar-benar pengetahuan real-world yang rumit, penting, dan membedakan mereka yang dapat melakukan deploy perubahan database dengan aman dari mereka yang menyebabkan outage atau kehilangan data.

Karena migrasi database adalah bagian yang sulit, berisiko, dan tidak terelakkan dari mendeploy aplikasi dengan database, dan karena menangani mereka dengan hati-hati (otomasi ditambah pola expand-contract yang backward-compatible) sangat penting untuk reliable, zero-downtime deployments, memahami migrasi database di CI/CD adalah pengetahuan yang berharga dan praktis-penting — mengatasi salah satu aspek paling rumit dari continuous delivery dan mencerminkan maturity yang diperlukan untuk melakukan deploy aplikasi stateful dengan aman.