Cache Reserve

Cache Reserve nedir?

Cloudflare’in kenar cache’i sınırlıdır ve sık istenmeyen içerik oradan düşer. Düştüğü anda bir sonraki istek origin’e gider — ve origin bir bulut sağlayıcısındaysa bu, egress faturası demektir.

Cache Reserve bu boşluğu doldurur. Resmî tanım:

“Cache Reserve is a large, persistent data store implemented on top of R2… Cache Reserve serves as the ultimate upper-tier cache, that will reserve storage space for your assets for as long as you want. This ensures that your content is served from cache longer, shielding your origin from unneeded egress fees.”

Nasıl çalışır?

Nerede duruyor

Kullanıcı → Kenar cache → Tiered Cache üst katman → Cache Reserve → Origin

Cache Reserve en üst katmandır: kenar ve Tiered Cache ıskaladığında devreye girer, o da ıskalarsa origin’e gidilir.

Uygunluk — üç şart

Bir varlığın Cache Reserve’e girmesi için üçünün de sağlanması gerekir:

1. Standart cache’lenebilirlik kriterlerini karşılamalı
2. Tazelik süresi en az 10 saat olmalı
3. Yanıtta Content-Length başlığı bulunmalı

Tazelik ve saklama — iki ayrı saat

Bu ayrım sürekli karıştırılıyor:

Yani bir varlık bayat olabilir ama hâlâ saklanıyor olabilir — ve depolama ücreti işlemeye devam eder.

İşlem modeli

“In most cases, a Cache Reserve miss will result in both one class A and one class B operation, and a Cache Reserve hit will result in one class B operation. Assets larger than 1 GB will incur more operations proportional to their size.”

Yani ıska pahalı, isabet ucuz. Düşük cache isabet oranı olan bir sitede Cache Reserve maliyeti hızla artar.

Purge davranışı — dikkat gerektiren kısım

Ne zaman kullanılır, ne zaman kullanılmaz

Uygun olduğu işler

• Uzun TTL’li, büyük statik medya kütüphaneleri
• Kenar cache’inden düşen ama pahalı olan uzun kuyruk içerik
• Yazılım ve paket dağıtım aynaları
• AWS/GCP üzerinde barındırılan origin’in egress faturasını düşürme

Uygun olmadığı işler

• TTL 10 saatin altındaysa. Hiç dolmaz.
• Origin aynı zone’daki R2 public bucket ise. Devreye girmez, üstelik gereksizdir.
• Origin Range istekleri gerekiyorsa. Desteklenmiyor — byte-range video kırılır.
• Görseller için Vary kullanıyorsan. Uyumlu değil.
• Cloudflare for SaaS orange-to-orange kurulumundaysan. Tamamen atlanır.
• Origin gzip pazarlığına bağımlıysa. Cache Reserve Accept-Encoding: gzip göndermez.
• Cache isabet oranı düşük, içerik sık değişiyorsa. Class A yazma maliyeti patlar.
• Tiered Cache açık değilse. Maliyet artar; panel uyarı verir.

Somut örnekler

1. Varlıkları uygun hâle getirme

Cache Reserve’in dolması için önce TTL’i 10 saatin üstüne çıkarman gerekir.

# Origin yanıt başlığı
Cache-Control: public, max-age=86400
Content-Length: 2451920

Origin’i değiştiremiyorsan Cache Rules ile Edge Cache TTL ayarla — ama unutma, Cache Reserve uygunluğu tazelik süresine bakar.

2. Uygunluğu doğrulama

# Content-Length var mı, TTL yeterli mi?
curl -sI https://alanadin.com/varlik/buyuk-dosya.zip | \
  grep -iE 'cache-control|content-length|cf-cache-status'

3. Cache Reserve isabetini görme

# Aynı varlığı iki kez iste, ikinci istekte durum değişmeli
curl -sI https://alanadin.com/varlik/buyuk-dosya.zip | grep -i cf-cache-status

Logpush’ta CacheReserveUsed alanı hangi isteklerin Cache Reserve’den karşılandığını gösterir.

4. API ile durum sorgulama ve temizleme

# Durumu oku
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cache/cache_reserve" \
  --header "Authorization: Bearer $CF_TOKEN"

# Tüm veriyi sil — önce etkinleştirilmiş sonra duraklatılmış olmalı
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cache/cache_reserve_clear" \
  --request POST \
  --header "Authorization: Bearer $CF_TOKEN"

Silme işlemi 24 saate kadar sürebilir.

Demo 1: Şirket içi origin önünde Cache Reserve

Bu demo senin on-prem sunucunla yapılacak — asıl ölçmek istediğimiz, origin’e giden istek sayısındaki düşüş.

Adım 1 — Başlangıç durumunu ölç

Cloudflare Analytics — cache hit oranı ve origin'e giden istek sayısı; on-prem sunucu tarafındaki erişim log sayısı

Adım 2 — Tiered Cache’i aç

Caching → Tiered Cache ekranı, seçilen topoloji

Adım 3 — Varlıkların uygunluğunu doğrula

curl -sI https://alanadin.com/varlik/ornek.zip | grep -iE 'cache-control|content-length'

curl -I çıktısı — Cache-Control max-age değeri 10 saatin üstünde ve Content-Length başlığı mevcut

Adım 4 — Cache Reserve’i aç

Caching → Cache Reserve → 'Enable storage sync' butonu ve etkinleşmiş durum

Adım 5 — Dolmasını bekle ve isabeti gör

Cache Reserve Analytics — saklanan veri miktarının zaman içinde artışı

Cache Reserve Analytics ekranındaki 'Egress savings (bandwidth)' değeri

Adım 6 — Origin tarafından doğrula

Şirket içi web sunucusunun erişim log'u veya izleme grafiği — Cache Reserve öncesi ve sonrası istek sayısı

Demo 2: Uygunluk kurallarını ve purge davranışını test etme

Adım 1 — Kısa TTL’li varlığın girmediğini göster

Cache-Control: max-age=300 ile bir varlık sun ve Cache Reserve’e girmediğini doğrula.

İki varlığın karşılaştırması — kısa TTL'li olan Cache Reserve'de yok, uzun TTL'li var

Adım 2 — Content-Length eksikliğini test et

Chunked transfer ile sunulan bir yanıt ve Cache Reserve'e girmediğini gösteren ölçüm

Adım 3 — URL bazlı purge ile Purge Everything’i karşılaştır

Cache Reserve depolama grafiği — URL purge sonrası anlık düşüş

Aynı grafik — Purge Everything sonrası depolamanın değişmediği, soft purge davranışı

Adım 4 — Range isteğinin çalışmadığını göster

curl -sI -H 'Range: bytes=0-1023' https://alanadin.com/varlik/video.mp4

curl çıktısı — Range isteğinin origin'e gittiğini gösteren başlıklar

Ölçüm

Fiyatlandırma

Faturalanan miktar en yakın milyona yukarı yuvarlanır.

Cloudflare’in kendi örnekleri

Örnek 1 — az sayıda büyük varlık, çok okuma 1.000 varlık × 1 GB, her biri 1 yazma + 1.000 okuma:

Örnek 2 — çok sayıda küçük varlık, günlük yeniden yazma 1.000.000 varlık × 1 MB, günde 1 kez yeniden yazılıyor, günde 2 kez okunuyor:

Plan gereksinimi — çözülmemiş çelişki

Limitler

Resmî ifade: “Cache Reserve file limits are the same as R2 limits.” Yani nesne boyutu 5 TiB, anahtar uzunluğu 1.024 bayt gibi R2 sınırları geçerlidir.

Buna ek olarak beş dışlama:

Lisanslama ve hukuki çerçeve

Cache Reserve tescilli bir hizmettir; Cloudflare Hizmet Şartları kapsamındadır.

Veri açısından dikkat edilmesi gereken: Cache Reserve, origin’inden gelen yanıtları aylarca saklar. Kişisel veri içeren bir yanıt yanlışlıkla cache’lenebilir hâle gelirse (ör. Cache-Control başlığı hatalı ayarlanmışsa) o veri 30 gün boyunca Cloudflare’de durur.

Pratik önlemler:

• Kişiselleştirilmiş yanıtlarda Cache-Control: private veya no-store kullan
• Kimlik doğrulama gerektiren yolları cache dışında tut
• Yanlışlıkla cache’lenen bir yanıtı temizlemek için URL bazlı purge kullan — Purge Everything depolamayı boşaltmaz

Veri yerleşimi kısıtı Cache Reserve için tanımlı değildir.

Sık yapılan hatalar

Tiered Cache açmadan etkinleştirmek. Class A işlemleri çoğalır ve maliyet artar; panel de uyarı gösterir.

Purge Everything’in depolamayı boşaltacağını sanmak. Soft purge yapar; varlıklar saklama süresi dolana kadar ücretlendirilmeye devam eder.

Etiket, host veya önek bazlı purge’ün CDN’deki gibi davranacağını sanmak. Cache Reserve’de yalnızca yeniden doğrulamaya zorlar.

Aynı zone’daki R2 public bucket’ın önünde çalıştırmak. Devreye girmez; çift harcamadır.

Byte-range video sunmak. Origin Range istekleri desteklenmiyor.

Sık değişen içerikte kullanmak. Cloudflare’in kendi örneğinde 171,60 USD’nin 135,00 USD’si yazma işlemlerinden geliyor.

R2’nin ücretsiz katmanının geçerli olduğunu varsaymak. Uygulanmaz.

gzip pazarlığının çalıştığını varsaymak. Cache Reserve origin’den sıkıştırılmamış içerik çeker.

TTL’i kontrol etmeden “çalışmıyor” demek. 10 saat kuralı en sık takılınan yerdir.