Strangler Fig ve API Sürümleme — Monoliti Kimseyi Kırmadan Taşımak

Bir restoranın mutfağını yenilemen gerekiyor, ama restoran bir akşam bile kapanamaz. Masalar dolu, siparişler durmadan geliyor.

Önde bir kapı, arkada adım adım taşınma

Strangler fig?Terimin tanımını açstrangler figBir monoliti tek seferde yeniden yazmak yerine önüne bir yönlendirici koyup yetenekleri tek tek yeni servislere taşımak. Adını, konak ağacını yavaşça saran incir türünden alır.Sözlükte gör → deseninde monolitin önüne bir yönlendirici konur: bir facade, çoğu zaman bir API gateway. Başta bütün istekleri olduğu gibi monolite geçirir.

Sonra yetenekler tek tek yeni servislere taşınır. Facade yalnızca taşınan yeteneğin yolunu yeni adrese çevirir; istemciler hep aynı adresi çağırır. Bir adım ters giderse geri almak, o tek yolu eski yerine çevirmektir.

İlk taşınan yetenek genellikle az bağımlı ve kaybı küçük olandır, katalog gibi. Para taşıyan ödeme sona kalır.

Yeni servis eski modeli miras almaz. Arada bir anti-corruption layer?Terimin tanımını açanti-corruption layerYeni sistemle eski sistem arasında modelleri birbirine çeviren ince katman. Eski modelin kavramları yeni servisin içine sızmaz, eski istemciler de eski şekli görmeye devam eder.Sözlükte gör → durur ve iki modeli birbirine çevirir. Böylece monolitin eski tuhaflıkları yeni servise sızmaz.

Sözleşmeyi kırmadan değiştirmek

Taşırken modeller de değişir. Yeni sipariş servisi tutarı artık para birimiyle birlikte tutuyor.

Bir API’nin cevabı, onu çağıran herkesle yapılmış bir sözleşmedir. Kısa kural: eklemek güvenlidir; silmek, adını ya da şeklini değiştirmek kırar.

Eklemenin güvenli olması istemciye bağlıdır. Tolerant reader?Terimin tanımını açtolerant readerCevaptan yalnızca ihtiyaç duyduğu alanları okuyan, tanımadığı alanları görmezden gelen istemci. Sunucunun alan eklemesi onu kırmaz.Sözlükte gör → yalnızca ihtiyacı olan alanları okur ve tanımadığını görmezden gelir. Tanımadığı alanda hata veren katı bir istemci, masum bir eklemede bile kırılır.

Şekli gerçekten değiştirmen gerekiyorsa yeni bir sürüm açar, eskisini bir süre yaşatırsın. İki yaygın yol var:

İkisi de işe yarar. Önemli olan, eski sürümün bir çeviri katmanıyla yaşaması ve duyurularak kapatılmasıdır: cevaba Sunset başlığı eklenir, log’dan onu kimin çağırdığı izlenir.

Satır satır: bir yolu yeni servise çevirmek

Gateway taşımanın ortasında: katalog ve sipariş taşındı, gerisi monolitte.

Çeviri katmanı ve katı olmayan bir istemci kodda şöyle görünür:

1
public record Money(BigDecimal amount, String currency) {}
2

3
public record OrderV2(String id, Money total, String status) {}
4

5
@RestController
6
@RequestMapping("/api/v2/orders")
7
class OrderV2Controller {
8

9
    private final OrderQueries orders;
10

11
    OrderV2Controller(OrderQueries orders) {
12
        this.orders = orders;
13
    }
14

15
    @GetMapping("/{id}")
16
    OrderV2 get(@PathVariable String id) {
17
        return orders.find(id);
18
    }
19
}

1
// The shape old clients were built against: total is a plain number in TRY.
2
public record OrderV1(String id, BigDecimal total, String status) {}
3

4
// Anti-corruption layer: the new model never learns about the old shape.
5
@RestController
6
@RequestMapping("/api/orders")   // the path old clients already call
7
class OrderV1Controller {
8

9
    private final OrderQueries orders;
10

11
    OrderV1Controller(OrderQueries orders) {
12
        this.orders = orders;
13
    }
14

15
    @GetMapping("/{id}")
16
    ResponseEntity<OrderV1> get(@PathVariable String id) {
17
        OrderV2 order = orders.find(id);
18
        OrderV1 old = new OrderV1(order.id(), order.total().amount(), order.status());
19
        return ResponseEntity.ok()
20
                .header("Deprecation", "true")
21
                .header("Sunset", "Wed, 31 Mar 2027 23:59:59 GMT")   // announced, not a surprise
22
                .body(old);
23
    }
24
}

1
// Read only what we need and ignore the rest: a field added tomorrow cannot break us.
2
@JsonIgnoreProperties(ignoreUnknown = true)
3
public record OrderView(String id, BigDecimal total) {}

Kendin gör

Dört yetenek, üç istemci. Her adımda kimin hâlâ çalıştığına bak.

1. Varsayılanla oynat. Katalog ve sepet sessizce taşınıyor; sipariş modeli yerinde değişince iki eski istemci kırılıyor.
2. “Yeni alan ekle” seç. Mobil v1 kurtuldu, Partner hâlâ kırık: aradaki fark okuma biçimi.
3. URI ya da başlık sürümü seç. Dört adımın hiçbirinde kırmızı kutu yok.
4. Önde facade olmasın. Daha ilk adımda, katalogda bile, iki istemci 404 alıyor.
5. Çift yazmayı seç. Sipariş taşınınca bir istemcinin ödemesi sarıya dönüyor: iki veritabanı ayrıştı.

Tuzaklar

İki yere birden yazmak. Taşırken aynı siparişi hem monolite hem yeni servise yazmak cazip gelir. Bu bir dual write?Terimin tanımını açdual writeAynı işlemde iki ayrı sisteme (ör. veritabanı ve mesaj kuyruğu) yazmak. Ortak bir transaction olmadığı için biri başarılı olup diğeri başarısız olabilir.Sözlükte gör →: ikisini kapsayan bir transaction yok, ikinci yazma düşerse iki farklı gerçek kalır.

Çözüm, her verinin tek bir yazanı olması. Yazma sahipliği bir anda yeni servise geçer; monolit kopyasını olaylardan (outbox) ya da veritabanı değişikliklerini okuyan CDC’den alır.

“Başlık yoksa en yeni sürüm.” Başlıksız istek en yeni sürüme düşerse, başlığı hiç bilmeyen eski istemciler her yeni sürümde kırılır. Başlıksız istek desteklenen en eski sürümü almalı.

Kendini sına