Cache Purge

Fitur Purge memungkinkan Anda untuk menghapus konten yang di-cache dari Kontenum CDN sehingga permintaan berikutnya akan mengambil konten baru langsung dari origin Anda.

Purge berguna ketika Anda:

• Memperbarui file (CSS, JS, gambar, media)
• Menerapkan versi baru aplikasi Anda
• Perlu segera menghapus konten yang usang atau salah

Cara Kerja Purge

Ketika sebuah URL di-purge:

1. Kontenum menghapus objek yang di-cache dari semua lokasi edge
2. Permintaan end user berikutnya memicu pengambilan baru dari origin
3. Konten yang diperbarui di-cache kembali berdasarkan aturan caching Anda

Operasi purge adalah aman dan tidak memengaruhi konten di origin storage Anda. Hanya salinan yang di-cache di CDN yang dihapus.

Cara Memicu Purge

1. Purge via Console (Web UI)

Anda dapat mengirimkan permintaan purge secara manual melalui Kontenum Console. Ini adalah cara tercepat untuk mem-purge URL individual selama development atau pembaruan kecil.

2. Purge via API

Untuk otomatisasi dan alur kerja CI/CD, purge juga dapat dipicu menggunakan Kontenum API.

Menggunakan API memungkinkan Anda untuk:

• Mem-purge konten selama proses deployment
• Mengintegrasikan purge ke dalam pipeline build
• Mem-purge secara massal secara programatis

Kolom Input Purge

URL (Required)

Kolom URL menentukan konten yang di-cache yang harus dihapus.

Contoh:

https://example.com/path/to/file.css

Purge Wildcard Otomatis

Kontenum secara otomatis menerapkan wildcard purge berdasarkan URL yang Anda berikan.

Contoh:

https://mycdn.example.com/assets/

Akan mem-purge semua file:

https://mycdn.example.com/assets/*

Semua file yang di-cache di bawah path /assets/ akan dihapus.

⚠️ Hati-hati saat mem-purge high-level path , karena ini dapat menghapus banyak objek yang di-cache.

Origin Header (Optional)

Kolom Origin Header memungkinkan Anda untuk mem-purge konten yang di-cache secara selektif berdasarkan domain origin yang digunakan saat mengambil aset.

Value ini dikirim sebagai HTTP Origin header saat CDN melakukan validasi cache.

Contoh:

www.kontenum.com

Kapan Menggunakan Origin Header

Gunakan kolom ini ketika:

• Beberapa domain menggunakan delivery domain CDN yang sama
• Anda ingin melakukan purge hanya pada konten yang diambil dari origin tertentu
• Anda menjalankan konfigurasi multi-tenant atau multi-origin

Jika dibiarkan kosong, purge akan berlaku untuk semua origin yang terkait dengan URL tersebut.

Praktik Terbaik

• Lakukan purge pada path atau file tertentu daripada seluruh domain jika memungkinkan
• Gunakan purge berbasis API untuk deployment otomatis
• Hindari purge full-path yang terlalu sering pada site dengan trafik tinggi
• Kombinasikan purge dengan header cache-control yang tepat untuk performa optimal

Contoh Use Case Umum

Catatan

• Purge hanya memengaruhi konten yang di-cache, bukan storage origin
• Konten yang baru diambil akan mengikuti aturan caching situs Anda
• Permintaan purge diproses secara global di seluruh lokasi edge CDN

Jika Anda membutuhkan bantuan untuk skenario purge lanjutan atau penggunaan API, silakan lihat dokumentasi API atau hubungi tim support.