CDN:Kaynakları önbellekten temizleme ve ön getirme

Kaynak önbellek temizleme (Purge)

URL tabanlı bir önbellek temizleme işlemi, hedef dosyayı uç düğümlerden siler. Dizin veya düzenli ifade tabanlı işlemlerde ise CDN, dosyaları doğrudan silmek yerine uç düğümlere bir önbellek geçersiz kılma komutu gönderir. Uç düğüm bu komutu aldığında, eşleşen önbelleğe alınmış kaynakları "geçersiz" veya "süresi dolmuş" olarak işaretler. Bir kullanıcı kaynağı bir sonraki seferde talep ettiğinde, uç düğüm önbelleğin geçersiz olduğunu tespit eder, en son sürümü almak için orijinal sunucuya istek gönderir ve yeni sürümü önbelleğe alarak kullanıcıya sunar.

Konsoldaki varsayılan önbellek temizleme yöntemi: CDN konsolunda dizin veya düzenli ifade tabanlı önbellek temizleme işlemi gerçekleştirdiğinizde, sistem varsayılan olarak yumuşak temizleme (soft purge) uygular. Yumuşak temizleme yalnızca önbelleği süresi dolmuş olarak işaretler. Uç düğüm orijinal sunucudan veri çekerken isteğe bir If-Modified-Since veya If-None-Match başlığı ekler. Orijinal sunucu 304 Not Modified yanıtını döndürürse, uç düğüm eski önbelleğe alınmış kopyayı korur. Bu yöntem orijinal sunucudan veri çekme trafiğini azaltır ancak aynı adla dosya güncellemeleri, uyumsuz içerik kaldırma veya yapılandırma değişiklikleri gibi durumlarda kullanıcıların eski içeriğe erişmesine neden olabilir. Önbelleği tamamen temizlemek için purgeObjectCaches API işlemini çağırmanızı ve Force parametresini true değerine ayarlayarak zorunlu temizleme (force purge) uygulamanızı öneririz.

Kullanım senaryoları

• Kaynak güncellemeleri ve sürümler: Orijinal sunucunuzdaki kaynakları güncelledikten veya yükselttikten sonra, ilgili URL'leri veya dizinleri önbellek temizleme işlemine gönderin. Böylece kullanıcılar en son içeriğe erişebilir ve bu içerik uç düğümlerde önbelleğe alınır.

• Uyumsuz kaynakların kaldırılması: Web sitenizde uyumsuz içerik bulunuyorsa, bu içeriği orijinal sunucudan silmeniz yeterli değildir çünkü içerik uç düğümlerin önbelleğinde hala mevcut olabilir. Uyumsuz içeriğin derhal kaldırıldığından emin olmak için URL önbellek temizleme işlemi gerçekleştirerek önbelleğe alınmış kaynakları temizlemeniz gerekir.

Kaynak ön getirme (Prefetch)

Ön getirme işlemi, uç düğümlerin kaynakları orijinal sunucunuzdan proaktif olarak çekip önbelleğe almasını sağlayan çekme tabanlı bir mekanizmadır. Bu işlem, orijinal sunucudan yapılan bir itme (push) işlemi değildir. Ön getirme, yeni kaynaklar veya etkinlik sayfaları için ilk erişim hızını artırır ve ürün veya etkinlik lansmanları sırasında orijinal sunucudan veri çekme baskısını azaltarak orijinal sunucunuzu korur.

Ön getirme mekanizması: Varsayılan olarak ön getirme işlemi, kaynakları tüm L1 uç düğümlere dağıtmak yerine L2 orijinal sunucudan çekme düğümlerine (L2 önbellek katmanı) önbelleğe alır. Bir kullanıcı bir kaynağa ilk kez eriştiğinde, L1 uç düğüm içeriği bir L2 orijinal sunucudan çekme düğümünden veya orijinal sunucudan çeker ve önbelleğe alır. Bu nedenle ön getirme öncelikli olarak orijinal sunucunuz üzerindeki yükü azaltır. L1 uç düğümlerdeki kapsamlı önbellek kapsamı, gerçek kullanıcı erişim kalıplarına bağlıdır. Yalnızca bir kullanıcının isteği bir L1 düğümünü içeriği yerel olarak önbelleğe almaya tetikledikten sonra, aynı bölgedeki diğer kullanıcılar o L1 düğümünden doğrudan önbellek isabetinden faydalanabilir.

Kullanım senaryoları

• İlk CDN kurulumu: Alan adınızı CDN'e ekledikten sonra popüler statik kaynakları uç düğümlere ön getirin. Kullanıcılar bu kaynakları talep ettiğinde, uç düğümler doğrudan yanıt verebilir; bu da yavaş ilk yükleme sürelerini ortadan kaldırır ve kullanıcı deneyimini iyileştirir.

• Promosyon etkinliklerinin başlatılması: Büyük bir etkinlikten önce, etkinlik sayfalarına ait tüm statik kaynakları ön getirin. Etkinlik başladığında, tüm statik kaynaklar zaten uç düğümlerde önbelleğe alınmış olur ve doğrudan sunulabilir; bu sayede hızlı sayfa yükleme süreleri sağlanır.

• Yükleme paketlerinin veya büyük dosyaların yayınlanması: Yeni bir sürüm veya güncelleme paketi yayınlamadan önce kaynakları uç düğümlere ön getirin. Ürün canlıya alındığında, uç düğümler indirme isteklerini doğrudan karşılar; bu da indirme hızlarını artırır ve orijinal sunucunuz üzerindeki yükü azaltır.

Ön getirme önbellek hiyerarşisi ve beklenen sonuçlar

Bir ön getirme işlemi, kaynakları öncelikli olarak L2 toplama düğümlerinde önbelleğe alır, tüm L1 uç düğümlerde (POP'lar) değil. Bir kullanıcı ön getirilen bir kaynağa ilk kez eriştiğinde, L1 POP kaynağı L2 düğümünden veya orijinal sunucudan alır. Bu nedenle ön getirmenin temel amacı, orijinal sunucu baskısını azaltmaktır, tüm L1 POP'larda anında önbellek isabeti garantisi vermek değildir.

• Maliyet değerlendirmesi: Ön getirme, önbellek isabet oranlarını iyileştirmeye yardımcı olur. Ancak küçük dosyalar veya popüler olmayan kaynaklar için ön getirme maliyetini dikkatlice değerlendirin.

Kaynakları önbellekten temizleme

1. CDN konsoluna oturum açın.

2. Sol gezinme bölmesinde, Purge and Prefetch seçeneğine tıklayın.

3. Purge/Prefetch sekmesinde, işlem türü olarak Purge seçeneğini belirleyin.

4. Bir önbellek temizleme türü seçin ve görevi gönderin.

Tüm siteyi nasıl önbellekten temizlersiniz (tam site önbellek temizleme veya kök dizin önbellek temizleme)

CDN, tek tıkla tam site önbellek temizleme seçeneği sunmaz ancak bunu aşağıdaki yöntemlerle gerçekleştirebilirsiniz:

1. Dizin önbellek temizleme: Önbellek temizleme yöntemi olarak Directory seçeneğini belirleyin ve alan adınızın kök dizin URL'sini girin (örneğin, https://<accelerated domain name>/). URL, eğik çizgi (/) ile bitmelidir.

2. Zorunlu önbellek temizleme (API): Dizin önbellek temizleme sonrasında bazı POP'lar hala eski içeriği sunuyorsa, Cache Purge API işlemini (RefreshObjectCaches) çağırın ve Force parametresini true değerine ayarlayın. Zorunlu önbellek temizleme, önbelleğe alınmış kaynakları tüm POP'lardan koşulsuz olarak kaldırır ve bir sonraki istekte orijinal sunucudan veri çekmeyi zorlar.

   Not

   Force parametresi konsol önbellek temizleme formunda mevcut değildir. Zorunlu önbellek temizleme gerçekleştirmek için API veya SDK kullanın.

3. Önbellek temizleme görevini başlatmak için Submit seçeneğine tıklayın.

   • Gönderildikten sonra bir önbellek temizleme görevi iptal edilemez.

   • Bir önbellek temizleme görevinin tüm ağda yayılması genellikle 5 ila 6 dakika sürer. Önbelleğe alınmış bir kaynağın sona erme süresi bundan kısaysa, manuel olarak önbellek temizleme yapmanız gerekmez.

   • OSS konsolunda otomatik CDN önbellek temizlemeyi etkinleştirirseniz, OSS'ten başlatılan otomatik önbellek temizleme görevlerini CDN konsolunda görüntüleyemezsiniz.

Kaynakları ön getirme

1. CDN konsoluna oturum açın.

2. Sol gezinme bölmesinde, Purge and Prefetch seçeneğine tıklayın.

3. Purge/Prefetch sekmesinde, işlem türü olarak Prefetch seçeneğini belirleyin.

4. URL giriş kutusuna, ön getirilecek dosyaların tam URL'lerini her satıra bir tane olacak şekilde girin. Dizin ön getirme desteklenmez. Örnek: https://<accelerated domain name>/install/package.zip.

5. Ön getirme görevini başlatmak için Submit seçeneğine tıklayın.

   • Gönderildikten sonra bir ön getirme görevi iptal edilemez.

   • Bir ön getirme görevinin tamamlanma süresi, dosya boyutuna, dosya sayısına ve orijinal sunucu performansına bağlıdır. Genellikle 5 ila 30 dakika sürer.

OSS dosyalarını ön getirme hakkında notlar

Orijinal sunucunuz OSS olduğunda aşağıdaki URL gereksinimlerine dikkat edin:

• URL biçimi: CDN hızlandırmalı alan adının tam URL'sini girmeniz gerekir (örneğin, https://cdn.example.com/path/file.zip). OSS paketinin dahili veya genel uç nokta URL'sini girmeyin (örneğin, https://<Origin Domain Name>/...).

• İmza parametreleri: Ön getirme URL'leri, Expires, OSSAccessKeyId veya Signature gibi OSS geçici imza parametrelerini içermemelidir. Bunlar, ön getirme görevlerinin başarısız olmasına neden olan geçici yetkilendirme parametreleridir.

• Orijinal sunucu yanıt durum kodu: Bir ön getirme görevi, orijinal sunucudan 200 durum kodu gerektirir. Orijinal sunucu 308 yönlendirmesi veya 200 dışındaki herhangi bir durum kodu döndürürse, ön getirme görevi başarısız olur. Örneğin, URL'de eksik bir sondaki eğik çizgi yönlendirmeye neden oluyorsa, sondaki eğik çizgiyi ekleyin ve görevi yeniden gönderin.

Önbellek temizleme veya ön getirme görevlerini otomatikleştirme

Aşağıdaki durumlarda kaynakları otomatik bir betik kullanarak önbellekten temizlemenizi ve ön getirmenizi öneririz:

• Görevleri otomatikleştirecek geliştiricileriniz yoksa ve bunları manuel olarak göndermek yüksek işletim maliyetlerine neden oluyorsa.

• Önbellekten temizlenecek veya ön getirilecek çok sayıda URL'niz varsa ve bunları toplu halde göndermek verimsizse.

• Önbellek temizleme ve ön getirme görevlerinin beklendiği gibi çalışıp çalışmadığını manuel veya programatik olarak kontrol etmeniz gerekiyorsa.

~ % curl -I http://oss.xxx.cn/1.png
HTTP/1.1 200 OK
Server: Tengine
Content-Type: image/png
Content-Length: 1605553
Connection: keep-alive
Date: Sun, 23 Feb 2025 15:33:38 GMT
x-oss-request-id: 67BB3Fxxx32B63123
x-oss-cdn-auth: success
Accept-Ranges: bytes
ETag: "469118F2ACF477CACAF4C9xxx"
Last-Modified: Wed, 12 Feb 2025 03:29:36 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: xxx005350070
x-oss-storage-class: Standard
Content-MD5: RpEY8qz0d8rxxx
x-oss-server-time: 103
Via: cache6.12cn2655[196,195,200-0,M], cache15.12cn2655[197,0], kunlun3.cn192[0,0,200-0,H], kunlun7.cn192[3,0]
Age: 69
Ali-Swift-Global-Savetime: 1740324818
X-Cache: HIT TCP_MEM_HIT dirn:-2:-2
X-Swift-SaveTime: Sun, 23 Feb 2025 15:33:38 GMT
X-Swift-CacheTime: 3600
Timing-Allow-Origin: *
EagleId: 3adad01b1740324887846539le

Yumuşak önbellek temizleme (varsayılan CDN ilkesi)

• Kullanım durumu: Statik dosyaların yeni sürümlerini yayınlama gibi rutin içerik güncellemeleri.

• Mekanizma: Bu, konsol üzerinden gönderilen dizin ve düzenli ifade tabanlı önbellek temizlemeler için varsayılan davranıştır. Bir CDN uç düğümü orijinal sunucudan veri çekerken, isteğe bir If-Modified-Since veya If-None-Match başlığı ekler. Orijinal sunucu, kaynağın güncellenip güncellenmediğini belirlemek için bu başlıkları kullanır.

• Etkisi: Orijinal sunucudaki kaynak değişmediyse, orijinal sunucu 304 Not Modified durum kodunu döndürür. CDN uç düğümü daha sonra eski önbelleğe alınmış kopyayı sunmaya devam eder; bu da orijinal sunucudan veri çekme trafiği tüketmez. Bu, maliyetleri düşüren ve orijinal sunucu üzerindeki yükü azaltan optimize edilmiş bir yöntemdir. Not: Önbelleği tamamen temizlemeniz gerekiyorsa (örneğin, uyumsuz içeriği kaldırmak, yapılandırma değişiklikleri uygulamak veya aynı adla bir dosyayı güncellemek için), yumuşak önbellek temizleme ihtiyaçlarınızı karşılamayabilir. Bu durumlarda zorunlu önbellek temizleme kullanın.

Zorunlu önbellek temizleme

• Kullanım senaryoları: Uyumsuz veya hatalı kaynakların acilen kaldırılması, yanlış Cache-Control yanıt başlığı yapılandırmaları düzeltildikten sonra ağ genelinde bir güncellemeyi zorlama veya orijinal sunucuda aynı ada sahip bir dosyanın güncellenmesi.

• Mekanizma: Zorunlu önbellek temizlemeyi tetiklemek için RefreshObjectCaches API işlemini çağırırken Force parametresini true değerine ayarlayın. Bu modda, CDN uç düğümü önbelleğe alınmış kaynağı koşulsuz olarak geçersiz olarak işaretler ve 304 doğrulama kontrolü gerçekleştirmez.

• Etkisi: Kaynak için bir sonraki istekte, orijinal sunucudaki dosya değişmemiş olsa bile CDN uç düğümü yeni sürümü almak için orijinal sunucudan veri çekmek zorunda kalır.

API zorunlu önbellek temizleme parametre örneği:

{
  "ObjectType": "Directory",
  "ObjectPath": "https://<accelerated domain name>/static/",
  "Force": true
}

Temel parametre açıklamaları:

• ObjectType: Directory , Regex ve IgnoreParams belirtin. File ayarlamak, hedef dosyayı önbellekten siler; bu işlem Force içermez.

• ObjectPath: ObjectType'a göre tam dizin yolunu belirtin; ister dizin, ister düzenli ifade URL'si isterse parametreleri yoksayan URL olsun.

• Force: Zorunlu önbellek temizlemeyi etkinleştirmek için true değerine ayarlayın. Bu, orijinal sunucunun If-Modified-Since/If-None-Match doğrulamasını atlayarak önbelleği doğrudan temizler.

Zorunlu önbellek temizleme için tipik kullanım senaryoları

Aşağıdaki senaryolarda zorunlu önbellek temizleme kullanmanızı (Cache Purge API çağırarak ve Force=true ayarlayarak) öneririz:

• Uyumsuz içerik veya kötü amaçlı yazılım kaldırma: Kötü amaçlı dosyaları orijinal sunucudan sildikten sonra, zorunlu önbellek temizleme kullanmanız veya orijinal sunucunun silinen URL için doğru HTTP durum kodunu (örneğin 404) döndürdüğünden emin olmanız gerekir. Aksi takdirde, POP'lar standart yeniden doğrulama sonrasında uyumsuz içeriği önbellekten sunmaya devam edebilir.

• Aynı adla dosya güncellemeleri (yapılandırma değişiklikleri): Orijinal sunucudaki bir dosyayı aynı dosya adıyla yeni bir sürümle değiştirirseniz, yeniden doğrulama 304 Not Modified durum kodunu döndürebilir ve eski önbelleğe alınmış içeriği sunmaya devam edebilir. Tüm POP'larda en son içeriğin sunulduğundan emin olmak için zorunlu önbellek temizleme kullanın.

• Sayfa görüntüleme sorunları veya ana sayfa döngüleri: Web sitenizdeki diğer sayfalar ana sayfayı göstermeye devam ediyor veya resimler yanlış görüntüleniyorsa ve URL önbellek temizleme sorunu çözmediyse, API aracılığıyla Force=true ile dizin önbellek temizleme kullanın.