CDN:FAQ purge dan prefetch

Purge vs. prefetch

Purge dan prefetch adalah dua operasi yang berbeda:

• Purge: Menginstruksikan node edge untuk menandai resource yang di-cache sebagai kedaluwarsa. Ketika pengguna meminta kembali resource tersebut, node edge melakukan origin fetch untuk mengambil versi terbaru, mengirimkannya ke pengguna, lalu menyimpannya kembali di cache. Operasi purge sementara menurunkan rasio hit cache.

• Prefetch: Memuat resource secara proaktif dari server origin ke node edge. Saat pengguna pertama kali meminta resource tersebut, node edge terdekat langsung melayaninya, sehingga tidak diperlukan origin fetch. Operasi prefetch meningkatkan rasio hit cache.

Urutan operasi purge dan prefetch

Purge dan prefetch adalah operasi independen yang tidak memiliki urutan ketat. Namun, saat memperbarui resource di server origin Anda, kami merekomendasikan mengikuti urutan logis berikut:

• Purge terlebih dahulu: Purge konten lama dari cache CDN untuk memastikan permintaan berikutnya mengambil versi terbaru dari server origin.

• Kemudian lakukan prefetch: Setelah tugas purge selesai, lakukan prefetch konten yang telah diperbarui ke node edge. Hal ini memastikan pengguna dapat mengakses konten baru dengan latensi minimum.

• Integrasi CDN pertama kali: Jika konten belum di-cache di node edge, Anda dapat langsung melakukan prefetch resource untuk memanaskan cache.

URL origin vs. URL domain terakselerasi

Selalu gunakan URL yang berisi domain terakselerasi, bukan URL server origin Anda. Sistem Alibaba Cloud CDN mengidentifikasi dan mengelola resource yang di-cache berdasarkan domain terakselerasinya. Mengirimkan permintaan purge atau prefetch untuk URL di bawah domain terakselerasi memastikan bahwa konten yang di-cache di node edge diperbarui atau dipra-ambil dengan benar.

Purge domain wildcard

Alibaba Cloud CDN tidak mendukung purge seluruh konten yang di-cache di bawah domain wildcard dalam satu operasi. Anda harus mengirimkan permintaan purge terpisah untuk subdomain, direktori, atau path URL tertentu. Anda tidak dapat menggunakan pola seperti https://*.example.com/file01.html atau https://*.example.com/file02/. Jika Anda perlu melakukan purge beberapa URL, masukkan satu URL per baris.

Waktu efektif purge dan prefetch

• Tugas purge: Tugas purge biasanya tersebar ke seluruh jaringan dalam waktu sekitar 5 hingga 6 menit. Jika TTL resource yang dikonfigurasi lebih pendek dari durasi ini, purge manual tidak diperlukan.

• Tugas prefetch: Waktu yang dibutuhkan bergantung pada ukuran dan jumlah file, tetapi biasanya memerlukan waktu 5 hingga 30 menit untuk menyelesaikannya.

Menerapkan perubahan konfigurasi CDN

Perubahan pada konfigurasi CDN, seperti Host origin, aturan caching, atau header respons, biasanya hanya berlaku untuk permintaan baru. Jika node edge telah menyimpan header respons atau konten lama di cache, node tersebut tidak akan menerapkan konfigurasi baru pada konten yang sudah di-cache tersebut. Untuk membuat perubahan Anda langsung berlaku, Anda harus melakukan purge cache secara manual untuk URL atau direktori yang sesuai. Hal ini memaksa node edge melakukan origin fetch dan mengambil resource dengan konfigurasi baru.

Sebagai contoh, setelah Anda mengubah header respons atau TTL, buka halaman Cache Refresh di Konsol CDN. Masukkan URL atau path direktori yang ingin Anda purge, lalu kirimkan permintaan tersebut. Jika perubahan konfigurasi menyebabkan ketidaksesuaian Content-Type, perbaiki terlebih dahulu metadata di server origin Anda, lalu purge URL yang terdampak.

Header kustom dalam permintaan prefetch

Secara default, permintaan prefetch menyertakan header Accept-Encoding: gzip. Untuk menyertakan header lain dalam permintaan prefetch atau melakukan prefetch multi-replika, Anda dapat menggunakan OpenAPI.

Pembaruan file dengan nama yang sama

Ikuti praktik terbaik berikut saat memperbarui file yang diakselerasi oleh CDN:

• Untuk pembaruan file umum, kami merekomendasikan menambahkan nomor versi ke URL resource, seperti ?v=1.0. Hal ini menghindari masalah caching terkait pembaruan dengan nama yang sama.

• Jika Anda harus melakukan pembaruan dengan nama yang sama, kirimkan permintaan purge melalui konsol atau menggunakan OpenAPI. Untuk operasi konsol, lihat Purge dan prefetch resource. Untuk operasi OpenAPI, lihat Purge dan prefetch.

Masalah pembaruan JS/CSS

Browser dan CDN menyimpan cache URL file JS dan CSS tertentu. Jika Anda memperbarui konten file tetapi tidak mengganti namanya, atau jika Anda mengubah nama file tetapi tidak memperbarui referensinya di HTML, hanya melakukan purge halaman utama mungkin tidak cukup. Browser pengguna atau CDN mungkin masih menyajikan versi lama sub-resource dari cache.

Rekomendasi:

• Purge URL spesifik file JS/CSS, bukan hanya halaman utama.

• Sebagai praktik terbaik, tambahkan parameter versi ke URL resource, seperti ?v=1.0, untuk menghindari masalah caching akibat pembaruan dengan nama yang sama.

• Jika terjadi pembaruan dengan nama yang sama di server origin, lakukan purge cache secara manual untuk URL yang sesuai di Konsol CDN. Tunggu beberapa menit setelah tugas purge selesai, lalu uji kembali di jendela penyamaran (incognito).

Troubleshooting pembaruan konten

Kemungkinan penyebab: Hal ini dapat terjadi karena beberapa alasan:

• Meskipun tugas purge telah membersihkan cache CDN, browser Anda masih menyajikan versi lama resource dari cache browser lokal.

• Resource di server origin belum diperbarui.

• Tugas purge atau prefetch belum selesai.

• Saat Anda melakukan purge direktori, CDN secara default menandai objek sebagai kedaluwarsa. Selama origin fetch berikutnya, CDN menyertakan header If-Modified-Since atau If-None-Match dalam permintaan. Jika Last-Modified atau ETag file dengan nama yang sama di server origin tidak berubah, server origin mengembalikan kode status 304 Not Modified, dan CDN terus menyajikan konten lama.

Solusi: Coba solusi berikut berdasarkan penyebabnya:

• Bersihkan cache browser Anda dan refresh halaman untuk melihat apakah resource telah diperbarui. Anda juga dapat menguji dengan menggunakan jendela penyamaran atau browser berbeda.

• Arahkan domain Anda langsung ke server origin dengan memodifikasi file hosts lokal Anda. Lalu, akses server origin secara langsung untuk memeriksa apakah resource telah diperbarui. Jika belum, perbarui resource di server origin sebelum mengakselerasinya dengan CDN.

• Periksa status tugas di halaman Purge dan prefetch resource.

• Lakukan purge URL (tipe File) untuk menghapus cache file tertentu. Atau, panggil API RefreshObjectCaches dan atur parameter Force ke true. Hal ini melakukan purge paksa, yang langsung menghapus konten dari node edge alih-alih hanya menandainya sebagai kedaluwarsa.

Di halaman Cache Refresh, klik tab Operation Records. Pastikan Status tugas adalah Succeeded dan Progress menunjukkan 100% untuk mengonfirmasi penyelesaian.

Masalah kecepatan unduh prefetch

Tugas prefetch memicu unduhan simultan dari server origin ke banyak node edge. Kecepatan unduh dari satu node mungkin awalnya cepat, tetapi saat semakin banyak node mulai mengunduh, kecepatan keseluruhan menjadi dibatasi oleh bandwidth server origin Anda. Untuk server origin dengan bandwidth rendah, tugas prefetch akan memakan waktu lebih lama. Evaluasi bandwidth origin Anda dan tingkatkan jika perlu, atau bagi pekerjaan prefetch besar menjadi batch yang lebih kecil.

Dampak redirect 30X terhadap prefetch

Jika server origin Anda mengembalikan kode status 307 atau kode status terkait redirect lainnya selama prefetch, tugas prefetch tidak akan mengikuti redirect tersebut dan tugas akan gagal. Jika server origin mengembalikan kode status 301 atau 302 dan Anda telah mengaktifkan pengikutan redirect 301/302 di CDN, CDN akan mengikuti redirect tersebut, sehingga tugas prefetch dapat diselesaikan dengan sukses.

Konten kedaluwarsa atau error 404

Node edge CDN mungkin menyimpan versi lama resource di cache. Bahkan jika file di server origin telah dihapus atau diperbarui, versi yang di-cache mungkin masih disajikan. Untuk mengatasi hal ini:

1. Lakukan operasi purge untuk URL spesifik di Konsol CDN atau menggunakan API.

2. Jika masalah disebabkan oleh kebijakan caching tingkat direktori, purge seluruh direktori tersebut. Untuk memastikan konten benar-benar dihapus, panggil API RefreshObjectCaches dan atur parameter Force ke true untuk melakukan purge paksa.

3. Pastikan file tersebut benar-benar telah diperbarui atau dihapus di server origin.

Troubleshooting kegagalan prefetch

Jika tugas prefetch gagal, periksa hal-hal berikut:

1. Periksa aksesibilitas URL: Pastikan URL yang ingin Anda prefetch dapat diakses di browser dan mengembalikan kode status 200. Jika mengembalikan kode status 308 atau kode status redirect lainnya, lakukan prefetch pada URL yang benar yang diakhiri dengan garis miring (/).

2. Pastikan Anda tidak melakukan prefetch direktori: Prefetch hanya didukung untuk URL file spesifik, bukan untuk path direktori yang diakhiri dengan /.

3. Periksa konflik dengan akselerasi dinamis OSS: Jika origin Anda adalah Bucket OSS dan Anda telah mengaktifkan akselerasi dinamis, file statis mungkin melewati jalur cache. Nonaktifkan akselerasi dinamis atau tentukan jenis file statis yang akan di-cache.

4. Periksa format URL: URL harus diawali dengan header protokol lengkap (http:// atau https://) dan tidak boleh mengandung karakter ilegal, seperti karakter full-width atau spasi berlebih. Pisahkan beberapa URL dengan jeda baris, bukan koma.

5. Periksa apakah resource dapat di-cache: Pastikan resource yang ingin Anda prefetch tidak memiliki header seperti Cache-Control: no-cache/no-store/private, yang mencegah caching.

Penanganan tugas HTTP dan HTTPS

Tidak. Alibaba Cloud CDN memperlakukan versi HTTP dan HTTPS dari suatu URL sebagai resource yang sama untuk caching. Permintaan purge atau prefetch untuk salah satu protokol berlaku untuk keduanya. Sebagai contoh, jika Anda perlu melakukan prefetch file aaa.mp4, Anda hanya perlu melakukan prefetch https://example.com/aaa.mp4. Anda tidak perlu juga melakukan prefetch http://example.com/aaa.mp4.