CDN ve Kenar Önbellek — Kampanya Sayfası Hızlansın, Hesap Sayfası Karışmasın

Gazeteyi matbaadan değil, mahalledeki bayiden alırsın; bayi her sabah birkaç kopya tutar. Ama sana gelen kişisel bir mektup bayide bekletilmez. Bekletilirse, onu ilk soran kişi alır.

Kenar sunucu ne yapar?

Bir CDN?Terimin tanımını açCDNİçerik dağıtım ağı: cevapların kopyasını kullanıcılara yakın kenar sunucularda tutar. Herkese açık sayfalar ana sunucuya gitmeden gelir.Sözlükte gör →, cevapların kopyasını kullanıcılara yakın kenar sunucularda tutar. Aynı sayfayı isteyen ikinci kullanıcı, ana sunucuya gitmeden cevap alır.

Neyin ne kadar süre tutulacağını ana sunucunun gönderdiği Cache-Control?Terimin tanımını açCache-ControlSunucunun bir cevapla gönderdiği başlık: tarayıcının bu cevabı saklayıp saklamayacağını ve ne kadar süre sormadan kullanacağını söyler.Sözlükte gör → başlığı söyler. public, max-age=3600, “bunu bir saat boyunca herkese verebilirsin” demektir.

Kişisel olan kenara girmez

Kişiye özel cevaplar private, no-store ile gönderilir: kenar sunucu onları hiç saklamaz, her istek ana sunucuya gider. Kampanya sayfası gibi herkese açık olanlar ise public kalır.

Herkese açık sayfa değişince kenar sunucular eski kopyayı süresi dolana kadar vermeye devam eder. Yayında önbellek temizleme?Terimin tanımını açönbellek temizlemeKenar sunuculardaki bir sayfanın kopyasını süresi dolmadan silme isteği. Yayından sonra eski sürümün dağıtılmasını önler.Sözlükte gör → isteği gönderirsen, bir sonraki istek yeni sürümü getirir.

Kendin gör

1. Varsayılanla oynat. Her istek ana sunucuya gitti; değişmeyen kampanya sayfası bile.
2. “Her cevap 1 saat public” seç. Bora, Ayşe’nin hesap sayfasını kenar sunucudan aldı.
3. “Kişisel sayfalar private” seç. Sızıntı bitti, ama yayından sonra üç istek eski kampanyayı gördü.
4. Temizlemeyi de aç. Yayından sonraki ilk istek yeni sürümü ana sunucudan aldı, sonraki kenardan geldi.

Tuzaklar

Varsayılan kuralları körü körüne açmak. “Bütün HTML’i önbelleğe al” gibi bir CDN ayarı, oturum çerezine bakmadan kişisel sayfaları da saklayabilir. Kişisel sayfalar başlıklarıyla açıkça hariç tutulmalı.

Temizlemeyi unutmak. Yayın betiği, değişen herkese açık sayfalar için temizleme isteğini de göndermeli. Dosya adında içerik özeti olan dosyalar ise hiç temizlenmek zorunda değildir.

Önbelleği test etmemek. “Kişisel sayfa no-store mu?” sorusu bir testle kontrol edilmeli; bir başlık kaybolursa sızıntı sessizce başlar.

1
@RestController
2
class CampaignController {
3

4
    private final CampaignService campaigns;
5

6
    CampaignController(CampaignService campaigns) {
7
        this.campaigns = campaigns;
8
    }
9

10
    // Same page for everyone: an edge may keep it for an hour.
11
    @GetMapping("/api/kampanyalar")
12
    ResponseEntity<List<Campaign>> campaigns() {
13
        return ResponseEntity.ok()
14
                .cacheControl(CacheControl.maxAge(Duration.ofHours(1)).cachePublic())
15
                .body(campaigns.active());
16
    }
17
}

1
@RestController
2
class AccountController {
3

4
    private final AccountService accounts;
5

6
    AccountController(AccountService accounts) {
7
        this.accounts = accounts;
8
    }
9

10
    // One customer's data: never stored by an edge or a shared cache.
11
    @GetMapping("/api/hesabim")
12
    ResponseEntity<AccountSummary> mine(@AuthenticationPrincipal BankUser user) {
13
        return ResponseEntity.ok()
14
                .cacheControl(CacheControl.noStore().cachePrivate())
15
                .body(accounts.summaryFor(user.account()));
16
    }
17
}

1
@Component
2
class CampaignPurger {
3

4
    private final RestClient cdn;
5

6
    CampaignPurger(RestClient.Builder builder, @Value("${cdn.purge-url}") String purgeUrl) {
7
        this.cdn = builder.baseUrl(purgeUrl).build();
8
    }
9

10
    // A new campaign is live: drop the old copy from every edge.
11
    @EventListener
12
    void on(CampaignPublished event) {
13
        cdn.post()
14
                .body(Map.of("paths", List.of("/api/kampanyalar")))
15
                .retrieve()
16
                .toBodilessEntity();
17
    }
18
}

1
@SpringBootTest
2
@AutoConfigureMockMvc
3
class CacheHeadersTest {
4

5
    @Autowired MockMvc mvc;
6

7
    @Test
8
    void campaignsArePublicForAnHour() throws Exception {
9
        mvc.perform(get("/api/kampanyalar"))
10
                .andExpect(header().string("Cache-Control", allOf(containsString("public"), containsString("max-age=3600"))));
11
    }
12

13
    @Test
14
    @WithMockUser
15
    void theAccountPageIsNeverStored() throws Exception {
16
        mvc.perform(get("/api/hesabim"))
17
                .andExpect(header().string("Cache-Control", allOf(containsString("no-store"), containsString("private"))));
18
    }
19
}

Kendini sına