Membatalkan validasi konten yang di-cache

Halaman ini menjelaskan cara membatalkan validasi konten yang di-cache Cloud CDN.

Misalnya, jika file yang terletak di /images/file.jpg telah di-cache dan perlu dibuat tidak valid, Anda dapat menggunakan beberapa metode untuk membuatnya tidak valid, bergantung pada apakah Anda ingin memengaruhi hanya file tersebut atau cakupan yang lebih luas. Dalam setiap kasus, Anda dapat membatalkan validasi untuk semua nama host atau hanya untuk satu nama host.

Untuk mempelajari pembatalan cache lebih lanjut, lihat Ringkasan pembatalan cache.

Sebelum memulai

Anda dapat menggunakan Google Cloud CLI atau Konsol Google Cloud untuk melakukan pembatalan validasi.

Anda dapat mengakses Google Cloud CLI dengan dua cara:

• Instal Google Cloud CLI dengan mengikuti petunjuk di bagian Menginstal dengan apt-get. Jika Anda belum menggunakan Google Cloud CLI sebelumnya, jalankan gcloud init terlebih dahulu untuk melakukan autentikasi.

• Gunakan Cloud Shell, yang sudah dilengkapi dengan gcloud.

Izin yang diperlukan untuk langkah ini

Untuk menjalankan tugas ini, Anda harus diberi izin berikut atau peran IAM berikut.

Izin

• compute.urlMaps.get
• compute.urlMaps.invalidateCache

Peran

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

Untuk membuat peran khusus dengan izin yang diperlukan, lihat Membuat dan mengelola peran khusus.

Untuk menambahkan peran bawaan, gunakan panduan awal IAM.

Catatan: Jika Anda menggunakan Load Balancer Aplikasi eksternal global dengan referensi layanan lintas project VPC Bersama, secara default, administrator project layanan tidak akan memiliki izin yang diperlukan untuk meminta pembatalan validasi cache. Hal ini karena pembatalan validasi cache dikonfigurasi di project frontend (yaitu, project yang memiliki aturan penerusan, proxy target, dan peta URL load balancer). Administrator layanan yang mengontrol penyediaan layanan backend dalam project terpisah dapat bekerja sama dengan administrator load balancer project frontend untuk mengeluarkan pembatalan validasi cache untuk layanan lintas project mereka. Untuk penulisan ulang URL, pastikan pembatalan validasi cocok dengan host dan jalur pra-penulisan ulang yang dikirim klien.

Membatalkan validasi hanya satu file

Konsol

1. Di konsol Google Cloud, buka halaman Cloud CDN.

   Buka halaman Cloud CDN

2. Di bagian Load balancer terkait, klik nama load balancer.
3. Klik tab Pembatalan validasi cache.
4. Masukkan jalur ke file.
   • Jika Anda ingin membatalkan validasi jalur untuk semua nama host, hanya masukkan jalur (misalnya: /images/file.jpg).
   • Jika Anda ingin membatalkan validasi jalur hanya untuk satu nama host, tentukan nama host sebagai bagian dari jalur (misalnya: example.com/images/file.jpg).
5. Klik Batalkan validasi.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/file.jpg"

Nama Load Balancer Aplikasi eksternal dan nama peta URL sama.

Ganti LOAD_BALANCER_NAME dengan nama load balancer Anda. Untuk menampilkan daftar load balancer, gunakan perintah gcloud compute url-maps list.

Opsional: Untuk membatalkan validasi hanya untuk satu host, tambahkan tanda --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/file.jpg"

Secara default, Google Cloud CLI menunggu hingga pembatalan validasi selesai. Untuk melakukan pembatalan validasi di latar belakang, tambahkan --async ke command line.

Membatalkan seluruh direktori

Konsol

1. Di konsol Google Cloud, buka halaman Cloud CDN.

   Buka halaman Cloud CDN

2. Di bagian Load balancer terkait, klik nama load balancer.
3. Klik tab Pembatalan validasi cache.
4. Masukkan jalur direktori dan karakter pengganti (/path/to/file/*).
   • Jika Anda ingin membatalkan validasi seluruh direktori untuk semua nama host, masukkan hanya jalur dan karakter pengganti (misalnya: /images/*).
   • Jika Anda ingin membatalkan validasi seluruh direktori hanya untuk satu nama host, tentukan nama host sebagai bagian dari jalur (misalnya: example.com/images/*).
5. Klik Batalkan validasi.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/*"

Ganti LOAD_BALANCER_NAME dengan nama load balancer Anda. Untuk menampilkan daftar load balancer, gunakan perintah gcloud compute url-maps list.

Opsional: Untuk membatalkan validasi hanya untuk satu host, tambahkan tanda --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/*"

Secara default, Google Cloud CLI menunggu hingga pembatalan validasi selesai. Untuk melakukan pembatalan validasi di latar belakang, tambahkan --async ke command line.

Membatalkan validasi semua

Konsol

1. Di konsol Google Cloud, buka halaman Cloud CDN.

   Buka halaman Cloud CDN

2. Di bagian Load balancer terkait, klik nama load balancer.
3. Klik tab Pembatalan validasi cache.
4. Hanya masukkan root dan karakter pengganti (/*).
   • Jika Anda ingin membatalkan validasi semuanya untuk semua nama host, hanya masukkan /* ke dalam kolom.
   • Jika Anda ingin membatalkan semuanya hanya untuk satu nama host, tentukan nama host sebagai bagian dari jalur (misalnya: example.com/*).
5. Klik Batalkan validasi.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/*"

Ganti kode berikut:

• LOAD_BALANCER_NAME: nama load balancer Anda
• /*: jalur URL yang ingin Anda batalkan validasinya; tidak menyertakan nama host; jalur dapat menggunakan nama file eksplisit atau karakter pengganti

Opsional: Untuk membatalkan validasi hanya untuk satu host, tambahkan tanda --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/*"

Secara default, Google Cloud CLI menunggu hingga pembatalan validasi selesai. Untuk melakukan pembatalan validasi di latar belakang, tambahkan --async ke command line.

Langkah selanjutnya

• Untuk memeriksa apakah Cloud CDN menayangkan respons dari cache, lihat Melihat log.
• Untuk mempelajari konten yang dapat di-cache atau tidak dapat di-cache, lihat Ringkasan penyimpanan dalam cache.