CI/CD'de veritabanı migrasyonlarını nasıl yönetirsiniz?

Question

Accepted Answer

**Veritabanı migrasyonları** (şema değişiklikleri) CI/CD'nin en zorlu kısımlarından biridir — durum bilgisi olmayan uygulama kodundan farklı olarak, veritabanları **durumu** tutan ve basitçe değiştirilemeyecek veya geri alınamayacak veriler içerir. Migrasyonları dikkatli bir şekilde yönetmek (otomasyon, geriye dönük uyumluluk, güvenli desenler) güvenilir dağıtımlar için gereklidir.

## Neden önemli

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

## Pipeline'da migrasyonları otomatikleştirme

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

## Güvenli migrasyon desenleri (geriye dönük uyumluluk)

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

## Neden önemli

CI/CD'de veritabanı migrasyonlarını nasıl yöneticilerini anlamak önemlidir çünkü **migrasyonlar otomatik dağıtımın en zor, en riskli kısımlarından biridir** ve bu nedenle güvenilir teslimat için değerli pratik bilgidir.

Temel zorluk şudur: durum bilgisi olmayan uygulama kodundan farklı olarak (bu kod serbestçe değiştirilebilir ve geri alınabilir), **veritabanları durumu tutar** — bu nedenle bir sütunu düşüren veya veri dönüştüren bir migrasyon **basitçe geri alınamaz** (veriler kaybolmuş olabilir) ve bu da yıkıcı değişiklikleri riskli veya geri döndürülemez hale getirir. Ayrıca, hadde dağıtımları sırasında **eski ve yeni kod aynı anda çalışır** ve her ikisinin de o andaki şemayla çalışması gerekir.

Bu, şema değişikliklerin CI/CD'nin geri kalanından farklı olarak dikkatli koordinasyon gerektirmesini sağlar.

**Migrasyonları otomatikleştirmeyi** anlamak — onları Flyway, Liquibase veya ORM migrasyonları gibi araçlarla sürümlü kod olarak tanımlamak, bunları pipeline adımı olarak uygulamak, sırasıyla ve idempotent olarak uygulamak ve öncelikle staging'de test etmek — migrasyonları otomatik pipeline'a güvenli bir şekilde getirmektedir.

En önemlisi, **güvenli migrasyon desenleri** anlamak — migrasyonları **geriye dönük uyumlu** hale getirmek, böylece eski ve yeni kod geçiş sırasında her ikisi de çalışabilsin, **expand-contract (paralel değişim) desenini** kullanmak (genişlet: eski kodu bozmadan yeni şema ekle; geçiş: kodu taşı ve veriyi dolundar; daralt: daha sonraki bir dağıtımda eski şemayı kaldır) ve **aynı dağıtımda ihtiyaç duyulan şeyleri düşürme/yeniden adlandırmaktan kaçınmak** — veritabanlarının durum bilgisi taşımasına rağmen **sıfır kapalı kalma süresi dağıtımları ve güvenli geri almalar** sağlayan anahtar beceridir.

Bu, gerçekten karmaşık, önemli, gerçek dünya bilgisidir ve veritabanı değişikliklerini güvenli bir şekilde dağıtabilen kişileri, kesintilere veya veri kaybına neden olan kişilerden ayırt eder.

Veritabanı migrasyonları veritabanlarıyla uygulamaları dağıtmanın zor, riskli, kaçınılmaz bir parçası olduğundan ve bunları dikkatli bir şekilde yönetmek (otomasyon artı geriye dönük uyumlu expand-contract desenleri) güvenilir, sıfır kapalı kalma süresi dağıtımları için gerekli olduğundan, CI/CD'de veritabanı migrasyonlarını anlamak değerli, pratik olarak önemli bilgidir — süregelen teslimatın en zor yönlerinden birini ele almak ve durum bilgisi taşıyan uygulamaları güvenli bir şekilde dağıtmak için gereken olgunluğu yansıtmaktadır.