CDN:Purge dan prefetch resource

Purge resource

Operasi purge mengirimkan perintah invalidasi cache ke node edge, bukan menghapus file secara langsung. Saat menerima perintah tersebut, node edge menandai resource yang di-cache sebagai "tidak valid" atau "kedaluwarsa." Ketika pengguna selanjutnya meminta resource tersebut, node edge mendeteksi bahwa cache tidak valid, melakukan origin fetch untuk mengambil versi terbaru, lalu melayani permintaan tersebut sambil menyimpan cache versi baru.

Metode purge default di Konsol: Saat Anda melakukan purge direktori atau purge berbasis regex di Konsol CDN, sistem menggunakan soft purge secara default. Soft purge hanya menandai cache sebagai kedaluwarsa. Saat node edge melakukan origin fetch, permintaan tersebut menyertakan header If-Modified-Since atau If-None-Match. Jika server origin mengembalikan respons 304 Not Modified, node edge tetap menyimpan salinan cache lama. Metode ini menghemat trafik origin fetch, tetapi dapat menyebabkan pengguna mengakses konten usang dalam skenario seperti pembaruan file dengan nama sama, penghapusan konten tidak sesuai, atau setelah perubahan konfigurasi. Untuk melakukan purge cache secara lengkap, kami menyarankan Anda memanggil operasi API purgeObjectCaches dan mengatur parameter Force ke true untuk melakukan force purge.

Kasus penggunaan

• Pembaruan dan rilis resource: Setelah Anda memperbarui atau meningkatkan resource di server origin, kirimkan URL atau direktori yang sesuai untuk purge agar pengguna dapat mengakses konten terbaru, yang kemudian di-cache pada node edge.

• Penghapusan resource tidak sesuai: Jika website Anda memiliki konten tidak sesuai, hanya menghapusnya dari server origin tidak cukup karena konten tersebut mungkin masih ada di cache node edge. Anda harus melakukan purge URL untuk membersihkan resource yang di-cache dan memastikan konten tidak sesuai segera dihapus.

Prefetch resource

Operasi prefetch adalah mekanisme berbasis pull yang menyebabkan node edge secara proaktif mengambil resource dari server origin Anda dan menyimpannya di cache. Ini bukan push dari server origin. Prefetch meningkatkan kecepatan akses awal untuk resource baru atau halaman event serta mengurangi tekanan origin fetch selama peluncuran produk atau event, sehingga melindungi server origin Anda.

Mekanisme prefetch: Secara default, operasi prefetch menyimpan cache resource pada node Tier-2 origin-pull (lapisan cache L2), bukan mendistribusikannya ke semua node edge L1. Saat pengguna pertama kali mengakses resource, node L1 edge mengambil konten dari node Tier-2 origin-pull atau server origin dan menyimpannya di cache. Oleh karena itu, prefetch terutama mengurangi beban pada server origin Anda. Cakupan cache komprehensif pada node L1 edge bergantung pada pola akses pengguna yang sebenarnya. Hanya setelah permintaan pengguna memicu node L1 untuk menyimpan konten secara lokal, pengguna berikutnya di wilayah yang sama dapat memperoleh hit cache langsung dari node L1 tersebut.

Kasus penggunaan

• Pengaturan awal CDN: Setelah menambahkan domain Anda ke CDN, prefetch resource statis populer ke node edge. Saat pengguna meminta resource tersebut, node edge dapat merespons langsung, sehingga menghilangkan waktu muat awal yang lambat dan meningkatkan pengalaman pengguna.

• Peluncuran event promosi: Sebelum event besar, prefetch semua resource statis untuk halaman event. Saat event dimulai, semua resource statis sudah di-cache pada node edge dan dapat dilayani langsung, memastikan waktu muat halaman yang cepat.

• Rilis paket instalasi atau file besar: Sebelum merilis versi baru atau paket pembaruan, prefetch resource ke node edge. Setelah produk live, node edge melayani permintaan unduhan secara langsung, yang meningkatkan kecepatan unduh dan mengurangi beban pada server origin Anda.

Hierarki cache prefetch dan hasil yang diharapkan

Operasi prefetch terutama menyimpan cache resource pada node agregasi L2, bukan pada semua node edge L1 (POP). Saat pengguna pertama kali meminta resource yang telah diprefetch, POP L1 mengambilnya dari node L2 atau server origin. Oleh karena itu, tujuan utama prefetch adalah mengurangi tekanan pada server origin, bukan menjamin hit cache langsung di semua POP L1.

• Evaluasi biaya: Prefetch membantu meningkatkan tingkat hit cache. Namun, untuk file kecil atau resource yang tidak populer, evaluasi biaya prefetch secara hati-hati. Prefetch menghasilkan trafik origin fetch, yang kira-kira sama dengan ukuran file dikalikan jumlah node L2.

Pembersihan sumber daya

1. Login ke Konsol CDN.

2. Di panel navigasi kiri, klik Purge and Prefetch.

3. Di tab Purge/Prefetch, pilih Purge sebagai jenis operasi.

4. Pilih jenis purge dan kirimkan tugas.

Cara purge seluruh situs (full-site purge atau purge direktori root)

CDN tidak menyediakan opsi full-site purge satu klik, tetapi Anda dapat mencapainya melalui metode berikut:

1. Directory purge: Pilih Directory sebagai metode purge dan masukkan URL direktori root nama domain Anda (misalnya, https://www.example.com/). URL harus diakhiri dengan garis miring (/).

2. Forced purge (API): Jika beberapa POP masih melayani konten usang setelah directory purge, panggil API Cache Purge (RefreshObjectCaches) dan atur parameter Force ke true. Forced purge menghapus resource yang di-cache dari semua POP tanpa syarat, memaksa origin fetch pada permintaan berikutnya.

   Catatan

   Parameter Force tidak tersedia di formulir purge Konsol. Untuk melakukan forced purge, gunakan API atau SDK.

3. Klik Submit untuk memulai tugas purge.

   • Setelah dikirim, tugas purge tidak dapat dibatalkan.

   • Tugas purge biasanya membutuhkan waktu 5 hingga 6 menit untuk tersebar di seluruh jaringan. Jika resource yang di-cache memiliki waktu kedaluwarsa lebih pendek dari ini, Anda tidak perlu melakukan purge secara manual.

   • Jika Anda mengaktifkan automatic CDN cache purge di Konsol OSS, Anda tidak dapat melihat tugas purge otomatis yang dipicu dari OSS di Konsol CDN.

Prefetch resource

1. Masuk ke Konsol CDN.

2. Di panel navigasi kiri, klik Purge and Prefetch.

3. Di tab Purge/Prefetch, pilih Prefetch sebagai jenis operasi.

4. Di kotak input URL, masukkan URL lengkap file yang akan diprefetch, satu per baris. Prefetch direktori tidak didukung. Contoh: https://www.example.com/install/package.zip.

5. Klik Submit untuk memulai tugas prefetch.

   • Setelah dikirim, tugas prefetch tidak dapat dibatalkan.

   • Waktu penyelesaian tugas prefetch bergantung pada ukuran file, jumlah file, dan kinerja server origin. Biasanya membutuhkan waktu 5 hingga 30 menit.

Catatan tentang prefetch file OSS

Saat server origin Anda adalah OSS, perhatikan persyaratan URL berikut:

• Format URL: Anda harus memasukkan URL lengkap nama domain akselerasi CDN (misalnya, https://cdn.example.com/path/file.zip). Jangan masukkan URL endpoint internal atau publik bucket OSS (misalnya, https://examplebucket.oss-cn-hangzhou.aliyuncs.com/...).

• Parameter signature: URL prefetch tidak boleh berisi parameter signature sementara OSS seperti Expires, OSSAccessKeyId, atau Signature. Ini adalah parameter otorisasi sementara yang menyebabkan tugas prefetch gagal.

• Kode status respons server origin: Tugas prefetch memerlukan kode status 200 dari server origin. Jika server origin mengembalikan redirect 308 atau kode status non-200 apa pun, tugas prefetch gagal. Misalnya, jika tidak adanya garis miring di akhir URL menyebabkan redirect, tambahkan garis miring tersebut dan kirim ulang tugas.

Otomatisasi tugas purge atau prefetch

Kami menyarankan Anda menggunakan skrip otomatis untuk purge dan prefetch resource dalam situasi berikut:

• Anda tidak memiliki developer untuk mengotomatiskan tugas, dan pengiriman manual mengakibatkan biaya operasional tinggi.

• Anda memiliki terlalu banyak URL untuk dipurge atau diprefetch, dan pengiriman batch tidak efisien.

• Anda perlu memeriksa secara manual atau terprogram apakah tugas purge dan prefetch berjalan sesuai harapan.

Soft purge (kebijakan default CDN)

• Kasus penggunaan: Pembaruan konten rutin, seperti penerbitan versi baru file statis.

• Mekanisme: Ini adalah perilaku default untuk purge direktori dan berbasis regex yang dikirimkan melalui Konsol. Saat node edge CDN melakukan origin fetch, permintaan tersebut menyertakan header If-Modified-Since atau If-None-Match. Server origin menggunakan header ini untuk menentukan apakah resource telah diperbarui.

• Efek: Jika resource di server origin belum berubah, server origin mengembalikan kode status 304 Not Modified. Node edge CDN kemudian terus melayani salinan cache lama, yang tidak mengonsumsi trafik origin fetch. Ini adalah metode optimal yang menghemat biaya dan mengurangi beban pada server origin. Catatan: Jika Anda perlu membersihkan cache sepenuhnya (misalnya, untuk menghapus konten tidak sesuai, menerapkan perubahan konfigurasi, atau memperbarui file dengan nama sama), soft purge mungkin tidak memenuhi kebutuhan Anda. Dalam kasus tersebut, gunakan force purge.

Force purge

• Kasus penggunaan: Penghapusan mendesak konten tidak sesuai atau resource salah, memaksa pembaruan jaringan luas setelah memperbaiki konfigurasi header respons Cache-Control yang salah, atau memperbarui file di server origin yang memiliki nama sama.

• Mekanisme: Untuk memicu force purge, atur parameter Force ke true saat Anda memanggil operasi API RefreshObjectCaches. Dalam mode ini, node edge CDN tanpa syarat menandai resource yang di-cache sebagai tidak valid dan tidak melakukan pemeriksaan validasi 304.

• Efek: Pada permintaan berikutnya untuk resource tersebut, node edge CDN harus melakukan origin fetch untuk mendapatkan versi baru, bahkan jika file di server origin belum berubah.

Contoh parameter force purge API:

{
  "ObjectType": "Directory",
  "ObjectPath": "https://www.example.com/static/",
  "Force": true
}

Deskripsi parameter utama:

• ObjectType: Tentukan Directory atau File.

• ObjectPath: Tentukan path direktori lengkap yang diakhiri dengan /, atau URL file tertentu.

• Force: Atur ke true untuk mengaktifkan force purge. Ini membersihkan cache langsung, melewati validasi If-Modified-Since/If-None-Match server origin.

Kasus Penggunaan Khas untuk Purge Paksa

Kami menyarankan Anda menggunakan force purge (dengan memanggil API Cache Purge dan mengatur Force=true) dalam skenario berikut:

• Penghapusan konten tidak sesuai atau malware: Setelah Anda menghapus file berbahaya dari server origin, Anda harus menggunakan force purge atau memastikan server origin mengembalikan kode status HTTP yang benar (seperti 404) untuk URL yang dihapus. Jika tidak, POP mungkin terus melayani konten tidak sesuai dari cache setelah revalidasi standar.

• Pembaruan file dengan nama sama (perubahan konfigurasi): Jika Anda mengganti file di server origin dengan versi baru menggunakan nama file yang sama, revalidasi mungkin mengembalikan kode status 304 Not Modified dan terus melayani konten cache lama. Gunakan force purge untuk memastikan konten terbaru dilayani di semua POP.

• Masalah tampilan halaman atau loop homepage: Jika halaman lain di website Anda terus menampilkan homepage atau gambar ditampilkan salah, dan purge URL tidak menyelesaikan masalah, gunakan directory purge dengan Force=true melalui API.