Bagaimanakah anda mengendalikan database migration dalam CI/CD?

Question

Accepted Answer

**Database migration** (perubahan skema) adalah salah satu bahagian CI/CD yang paling rumit — tidak seperti application code yang stateless, database menyimpan **state** yang tidak boleh sekadar diganti atau di-rollback. Mengendalikan migration dengan berhati-hati (automasi, keserasian ke belakang, pola selamat) adalah penting untuk deployment yang boleh dipercayai.

## Mengapa database migration sukar

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

## Mengautomasikan migration dalam 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 migration yang selamat (keserasian ke belakang)

```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 ia penting

Memahami bagaimana mengendalikan database migration dalam CI/CD adalah penting kerana **migration adalah salah satu bahagian deployment automatik yang paling sukar dan berisiko**, jadi ia adalah pengetahuan praktikal yang berharga untuk penyampaian yang boleh dipercayai.

Cabaran teras ialah, tidak seperti application code yang stateless (yang boleh diganti dan di-rollback dengan bebas), **database menyimpan state** — jadi migration yang menggugurkan column atau mengubah data **tidak boleh sekadar di-rollback** (data mungkin telah hilang), menjadikan perubahan yang merosakkan berisiko atau tidak boleh diterbalikkan, dan semasa rolling deployment **code lama dan baharu berjalan serentak**, kedua-duanya perlu berfungsi dengan skema pada masa itu.

Ini menjadikan perubahan skema memerlukan penyelarasan yang berhati-hati, tidak seperti selebihnya CI/CD.

Memahami bagaimana untuk **mengautomasikan migration** (mentakrifkannya sebagai code berversi melalui tool seperti Flyway, Liquibase, atau ORM migration, menjalankannya sebagai langkah pipeline yang diaplikasikan mengikut urutan dan secara idempoten, dan mengujinya dalam staging dahulu) membawa migration ke dalam pipeline automatik dengan selamat.

Yang paling penting, memahami **pola migration yang selamat** — menjadikan migration **serasi ke belakang** supaya code lama dan baharu kedua-duanya berfungsi semasa peralihan, menggunakan **pola expand-contract (parallel change)** (expand: menambah skema baharu tanpa merosakkan code lama; migrate: memindahkan code dan mengisi semula data; contract: membuang skema lama dalam deploy kemudian) dan **tidak pernah menggugurkan/menamakan semula dalam deploy yang sama yang memerlukannya hilang** — adalah kemahiran utama yang membolehkan **zero-downtime deployment dan rollback yang selamat** walaupun sifat database yang stateful.

Ini adalah pengetahuan dunia sebenar yang benar-benar rumit dan penting yang membezakan mereka yang boleh men-deploy perubahan database dengan selamat daripada mereka yang menyebabkan gangguan perkhidmatan atau kehilangan data.

Memandangkan database migration adalah bahagian deployment aplikasi dengan database yang sukar, berisiko, dan tidak dapat dielakkan, dan memandangkan mengendalikannya dengan berhati-hati (automasi serta pola expand-contract yang serasi ke belakang) adalah penting untuk deployment zero-downtime yang boleh dipercayai, memahami database migration dalam CI/CD adalah pengetahuan berharga dan penting secara praktikal — menangani salah satu aspek continuous delivery yang paling rumit dan mencerminkan kematangan yang diperlukan untuk men-deploy aplikasi stateful dengan selamat.