Cloudflare Önbellek Temizleme Eğitimi: Web ve DevOps Yöneticileri İçin Kapsamlı Bir Kılavuz

Cloudflare önbelleğini temizlemek dağıtım ve sorun gidermeyi nasıl etkiler?

Cloudflare önbelleğini temizlemek, web siteleri ve uygulamalar için sürüm ve sorun giderme döngüsünde önemli bir adımdır. Bu pratik ve uzman kılavuz, site yöneticilerinin, DevOps ekiplerinin, geliştirme ekiplerinin, yatırımcıların ve oyuncuların bir güncelleme veya hata düzeltmesinden sonra değişiklikleri hızlı ve güvenli bir şekilde uç noktalara (85'ten fazla küresel konum) gönderebilmeleri için temizleme yöntemlerini, güvenlik ipuçlarını, komut satırı komutlarını, CI/CD'de otomasyonu ve Nginx/Apache ve WordPress yapılandırmalarını kapsar.

Cloudflare önbelleğini temizlemek neden gerekli?

Önbelleği temizle Bu, eski içerik sürümlerinin (örneğin Edge'de önbelleğe alınmış CSS/JS/resimler veya HTML) hatalı görüntülemeye veya performans sorunlarına neden olduğu durumlarda gereklidir.

• Edge tarayıcısında önbelleğe alınmış statik dosyaları veya HTML içeriğini güncelledikten sonra.
• Bir uygulama dağıtıldıktan veya taşındıktan sonra, yeni sürümün Edge'lerde hemen görüntülenmesi gerekir.
• Güncel olmayan içerikle ilgili görüntüleme sorunlarını veya hatalarını düzeltmek için.
• Alım satım veya oyun gibi zamana duyarlı senaryolarda, canlı içeriğin anında güncellenmesi gerekir.

Cloudflare'da önbellek temizleme türleri

1) Her Şeyi Temizleyin

Bir bölgedeki tüm önbellekleri temizleyin. Hızlı ve basit ama Pahalı Ve bazen bu durum kaynak üzerindeki yükü artırır.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"purge_everything":true}'

2) URL'ye göre temizleme (URL'ye göre seçici temizleme)

Belirli dosyaları veya sayfaları silme; tam silme işleminin yan etkilerinden kaçınmak için belirli varlıkları veya sayfaları güncellemek için en iyi seçenektir.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"files":["https://example.com/css/app.css","https://example.com/js/app.js"]}'

3) Etikete Göre Temizleme — Gelişmiş

Etikete göre temizleme Bir etiketle işaretlenmiş kaynak grubunu geçersiz kılmak için uygundur; karmaşık uygulamalarda ve mikro hizmetlerde kullanışlıdır.

Not: Bu özellik bazı planlarda veya kurumsal hesaplarda farklılık gösterebilir.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"tags":["product-123","homepage-v2"]}'

4) Geliştirme Modu ve Önbellek Atlatma

Kontrol panelinden etkinleştirilen Geliştirme Modu, Edge'de önbelleğe almayı 3 saatliğine devre dışı bırakır; kısa süreli geliştirme için idealdir.

API rotalarını atlamak veya çerezlere dayalı olarak Sayfa Kuralları Veya İşçiler Kullanmak.

Bölge Kimliğini alma ve minimum erişimle API Token oluşturma

Bölge Kimliğini almak için API'yi kullanabilirsiniz; yanıt alanında yer almaktadır. İD Bu, Bölge Kimliği ile aynıdır.

curl -X GET "https://api.cloudflare.com/client/v4/zones?name=example.com" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json"

API belirteci oluşturmak için şu yola gidin: Cloudflare → Profilim → API Tokenları → Token Oluştur Öncelikle yalnızca gerekli izinleri verin. Genellikle izin Bölge → Önbellek Temizleme Belirli bölgeler için yeterlidir. Token'ları belirli bir bölgeyle sınırlandırmak ve bir son kullanma tarihi belirlemek. Güvenliği önemli ölçüde artırır.

Yanıtın önbellek durumunu kontrol etme (cf-cache-status)

Başlıktan hata ayıklamak için cf-önbellek-durumu Kullanım alanları, tipik değerleri şunlardır: VURMAK, KAYIP, GÜNÜ GEÇMİŞ, DİNAMİK, BYPASS, YENİDEN ONAYLANDI.

curl -I -s -D - https://example.com | grep -i cf-cache-status

Sunucu Yapılandırma İpuçları ve Başlıklar (Nginx/Apache)

Statik dosyalar için (sıkıştırılmış ve değiştirilemez)

Uzun vadeli önbellek kontrolünü, dosya adına uygulanan karma değer (parmak izi) ile birlikte kullanmak, varlıkların tamamen temizlenmesi ihtiyacını azaltmak için en iyi yaklaşımdır.

location ~* \.(js|css|jpg|jpeg|png|svg|woff2?)$ {
    expires 30d;
    add_header Cache-Control "public, max-age=2592000, s-maxage=2592000, immutable";
}

Bu ayar, mevcut ayarlara ek olarak yapılır. Her Şeyi Önbelleğe Al / Uç Önbellek TTL Cloudflare, varlıkların uzun süre uç sunucularda depolanmasına neden olur.

HTML sayfaları için (güncellenebilir)

location / {
    add_header Cache-Control "no-cache, must-revalidate, max-age=0";
}

Cloudflare'da, daha düşük bir Edge Cache TTL değeri ayarlayabilir veya önemli sayfalar üzerinde daha fazla kontrol sağlamak için Sayfa Kuralları kullanabilirsiniz.

Origin başlığına saygı gösterin

Cloudflare kontrol panelinde, Önbellekleme bölümünde Cloudflare'ın kaynak başlıklarını dikkate alıp almayacağını veya kendi ayarlarını kullanıp kullanmayacağını belirleyen bir seçenek bulunmaktadır. Daha fazla kontrol için bunu etkinleştirmeniz önerilir. Origin Önbellek Kontrolü Kullanmak.

WordPress ve eklentilerle entegrasyon

WordPress için resmi Cloudflare eklentisi, yayınlama veya güncelleme sonrasında otomatik temizleme işlemine olanak tanır.

• WP Rocket veya W3 Total Cache gibi önbellek eklentilerinin yerel temizleme seçenekleri vardır; uç sunucuyu da güncellemek için Cloudflare ile aynı anda temizleme işlemini kullanın.
• Kritik öneme sahip siteler (ticaret VPS'leri veya oyun siteleri) için, gecikmeyi ve istikrarı korumak amacıyla TTL ayarlarını kısaltın ve seçici temizlemeyi etkinleştirin.

CI/CD'de önbellek temizleme otomasyonu

Otomatik dağıtım sonrasında (GitHub Actions / GitLab CI / Jenkins) oluşturulan URL'leri temizlemek için basit bir adım ekleyin. Token'ları saklamak için gizli anahtar yönetimini kullandığınızdan emin olun.

- name: Purge Cloudflare cache
  run: |
    curl -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/purge_cache" \
    -H "Authorization: Bearer ${{ secrets.CF_API_TOKEN }}" \
    -H "Content-Type: application/json" \
    --data "{\"files\": [\"https://example.com/path/to/file.js\"]}"

Toplu temizlik için Linux komut dosyaları

URL listesini temizlemek için bir dosya ve jq kullanabilirsiniz. Daha hızlı performans için, grupları 30'ar parçaya bölün ve paralel olarak çalıştırın.

cat urls.txt | jq -R -s -c 'split("\n")[:-1]' | \
xargs -I{} curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
 -H "Authorization: Bearer <API_TOKEN>" -H "Content-Type: application/json" \
 --data '{"files":'{}'}'

Güvenlik ipuçları ve sınırlamalar

Minimum izinler API Token için: Yalnızca "Önbellek Temizleme" işlemi ve gerekli bölgelerle sınırlı; bir son kullanma tarihi belirleyin.

• Hız sınırlamaları: Temizleme API'sinin istek sınırları vardır; Her Şeyi Sürekli Temizleme işleminden kaçının ve gerektiğinde toplu temizleme işlemlerini kullanın.
• Günlük Kaydı: Her temizleme işlemini CI veya sistem günlüklerine kaydederek nedenini ve zamanını görün; bu, denetimler için faydalıdır.

Özel durumlar — Çalışanlar, KV ve işleme/GPU

Cloudflare Workers kullanıyorsanız, standart bölge önbelleği temizleme işlemi Workers önbelleğini temizlemeyebilir; Worker kodunda şunu kullanın: önbellek.sil Ve özel çözümler kullanın.

Model veya render dosyaları gibi büyük dosyalar için, değiştirilemez dosyalar için uzun vadeli Cache-Control, güncellemeler için ise seçici temizleme kullanın.

Alım satım yapanlar ve oyuncular gibi hassas kullanıcılar için, ping süresini azaltmak amacıyla doğru konum seçimi ve CDN yapılandırması önemlidir; kritik içeriklerin güncel kalması için önbellekleme akıllıca yapılandırılmalıdır.

En iyi uygulamalar ve pratik tavsiyeler

• "Her Şeyi Temizle" özelliğini yalnızca son çare olarak kullanın. Kullanmak.
• Yan etkileri en aza indirmek için URL veya Etiketlere Göre Temizleme özelliğini kullanın.
• Başlıklar Önbellek Kontrolü Başlangıç noktasını doğru şekilde ayarlayın.
• Statik içerik için, yeni dosyaları tam bir silme işlemi yapmadan yayınlamak üzere uzun ömürlü önbellek ve parmak izi özelliğini kullanın.
• Hassas rotalar veya atlanması gereken API'ler için Sayfa Kuralları veya Cloudflare Workers kullanın.
• Otomasyon: Her dağıtım sonrasında vaka temizleme (yeni dosyalar) işlemini CI ile birleştirin.
• Güvenlik: Kısıtlı erişim belirteçleri kullanın ve erişimi periyodik olarak gözden geçirin.

Hız ve istikrar arasında bir denge sağlamak için, isteğe bağlı kaynak ve tahliye başlıklarının bir kombinasyonu en iyi sonuçları verir.

Çözüm

Cloudflare önbelleğini temizlemek basit bir işlem gibi görünse de, temizleme türlerini, başlıkları ve performans ile güvenlik etkilerini anlamayı gerektirir. Origin Cache-Control, etiketler ve seçici temizlemeler de dahil olmak üzere doğru yapılandırmayla, özellikle 85'ten fazla küresel lokasyona sahip altyapılarda ve GPU sunucuları, özel VPS veya DDoS saldırılarına karşı koruma hizmetleri kullanan ortamlarda uygulamanızın hem hızını hem de kararlılığını koruyabilirsiniz.

Planlar, önbellek ayarları ve sürüm sonrası otomasyon hakkında daha fazla bilgi edinmek isterseniz, ilgili kaynaklara ve sayfalara göz atabilir veya destek ekibiyle iletişime geçebilirsiniz.

Sıkça Sorulan Sorular