Membatalkan validasi konten yang di-cache

Halaman ini berisi penjelasan mengenai cara membatalkan validasi konten yang di-cache Cloud CDN.

Misalnya, jika file yang berada di /images/file.jpg telah di-cache dan perlu dibatalkan validasinya, Anda dapat menggunakan beberapa metode untuk melakukannya, bergantung pada apakah Anda hanya ingin memengaruhi file tersebut atau cakupan yang lebih luas. Dalam tiap kasus, Anda dapat membatalkan validasi untuk semua nama host atau hanya satu nama host.

Untuk mempelajari lebih lanjut pembatalan validasi cache, baca artikel Ringkasan pembatalan validasi cache.

Sebelum memulai

Anda dapat menggunakan Google Cloud CLI atau konsol Google Cloud untuk membatalkan 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 pernah menggunakan Google Cloud CLI sebelumnya, jalankan gcloud init terlebih dahulu untuk melakukan autentikasi.

  • Gunakan Cloud Shell, yang sudah mencakup gcloud yang telah diinstal.

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

Untuk menambahkan peran bawaan, gunakan panduan memulai IAM.

Membatalkan validasi hanya satu file

Konsol

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

    Buka Cloud CDN

  2. Klik server asal.

  3. Klik tab Cache invalidation.

  4. Untuk Associated load balancer, pilih load balancer.

  5. Di bagian Specify objects to invalidate, lakukan hal berikut:

    • Untuk Host, tentukan nama host, kecuali jika Anda ingin membatalkan validasi jalur untuk semua nama host.
    • Untuk Path, tentukan jalur dan nama file, misalnya, /images/file.jpg.

  6. Klik Invalidate.

gcloud

Gunakan perintah gcloud compute url-maps invalidate-cdn-cache.

Untuk menentukan hanya satu file yang akan dibatalkan, gunakan flag --path dengan nama file.

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

Ganti URL_MAP_NAME dengan nama peta URL Anda. Untuk mencantumkan peta URL, gunakan perintah gcloud compute url-maps list.

Guna membatalkan validasi hanya untuk satu host, tambahkan flag --host, misalnya, --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/file.jpg"

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

API

Gunakan metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

  • PROJECT_ID: project ID konsol Google Cloud Anda
  • URL_MAP_NAME: nama peta URL

Untuk menentukan file yang akan dibatalkan validasinya, gunakan isi permintaan JSON contoh berikut:

{
  "path": "/images/file.jpg"
}

Untuk membatalkan validitas file hanya untuk satu host, gunakan isi permintaan JSON contoh berikut:

{
  "host": "host1.com",
  "path": "/images/file.jpg"
}

Membatalkan seluruh direktori

Konsol

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

    Buka Cloud CDN

  2. Klik server asal.

  3. Klik tab Cache invalidation.

  4. Untuk Associated load balancer, pilih load balancer.

  5. Di bagian Specify objects to invalidate, lakukan hal berikut:

    • Untuk Host, tentukan nama host, kecuali jika Anda ingin membatalkan validasi jalur untuk semua nama host.
    • Untuk Path, tentukan jalur dan tanda bintang sebagai karakter pengganti, misalnya, /images/*.

  6. Klik Invalidate.

gcloud

Gunakan perintah gcloud compute url-maps invalidate-cdn-cache.

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

Ganti URL_MAP_NAME dengan nama peta URL Anda.

Guna membatalkan validasi hanya untuk satu host, tambahkan flag --host, misalnya, --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/*"

API

Gunakan metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

  • PROJECT_ID: project ID konsol Google Cloud Anda
  • URL_MAP_NAME: nama peta URL

Untuk menentukan direktori pembatalan validasi, gunakan isi permintaan JSON contoh berikut:

{
  "path": "/images/*"
}

Untuk membatalkan validasi direktori hanya untuk satu host, gunakan isi permintaan JSON contoh berikut:

{
  "host": "host1.com",
  "path": "/images/*"
}

Membatalkan validasi berdasarkan tag cache

Konsol

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

    Buka Cloud CDN

  2. Klik server asal.

  3. Klik tab Cache invalidation.

  4. Untuk Associated load balancer, pilih load balancer.

  5. Di bagian Specify objects to invalidate, untuk Cache tag, tentukan satu atau beberapa tag yang akan dibatalkan validasinya. Gunakan spasi atau koma untuk memisahkan tag.

  6. Klik Invalidate.

gcloud

Gunakan perintah gcloud beta compute url-maps invalidate-cdn-cache.

gcloud beta compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --tags=TAGS

Ganti kode berikut:

  • URL_MAP_NAME: nama peta URL
  • TAGS: tag atau comma separated list tag; atau Anda dapat menentukan flag ini hingga 10 kali

Misalnya, jika respons backend menyertakan header Cache-Tag dengan ID pengguna buram, seperti UUID4 atau bentuk GUID lainnya, Anda dapat membatalkan validasi semua konten untuk pengguna tertentu dengan flag tag. Selain itu, guna membatalkan validasi konten hanya untuk satu host, seperti untuk lingkungan staging, tambahkan flag --host.

gcloud beta compute url-maps invalidate-cdn-cache url_map_1 \
    --tags="1115b8f4-f804-4861-9629-8cb9aecdeeb3" \
    --host="host1.com"

API

Gunakan metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

  • PROJECT_ID: project ID konsol Google Cloud Anda
  • URL_MAP_NAME: nama peta URL

Guna menentukan tag cache untuk pembatalan validasi, gunakan isi permintaan JSON contoh berikut:

{
  "cacheTags": [
    "tag1",
    "tag2"
  ]
}

Anda dapat menentukan satu tag atau comma separated list tag.

Guna membatalkan validasi menurut tag cache hanya untuk satu host, gunakan isi permintaan JSON contoh berikut:

{
  "host": "host1.com",
  "path": "tag1,tag2"
}

Membatalkan validasi semuanya

Meskipun Anda dapat membatalkan validasi semuanya, tindakan ini berpotensi menimbulkan risiko. Evaluasi persyaratan Anda dengan cermat sebelum melanjutkan.

Konsol

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

    Buka Cloud CDN

  2. Klik server asal.

  3. Klik tab Cache invalidation.

  4. Untuk Associated load balancer, pilih load balancer.

  5. Di bagian Specify objects to invalidate, lakukan hal berikut:

    • Untuk Host, tentukan nama host, kecuali jika Anda ingin membatalkan validasi jalur untuk semua nama host.
    • Untuk Path, gunakan tanda bintang, misalnya, /*.

  6. Klik Invalidate, lalu klik Confirm untuk menunjukkan bahwa Anda ingin Cloud CDN membatalkan semua validasi.

gcloud

Gunakan perintah gcloud compute url-maps invalidate-cdn-cache.

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

Ganti kode berikut:

  • URL_MAP_NAME: nama peta URL
  • /*: jalur URL yang ingin Anda batalkan validasinya; tidak mencakup nama host; jalur dapat menggunakan nama file eksplisit atau tanda bintang sebagai karakter pengganti

Guna membatalkan validasi hanya untuk satu host, tambahkan flag --host, misalnya, --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/*"

API

Gunakan metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

  • PROJECT_ID: project ID konsol Google Cloud Anda
  • URL_MAP_NAME: nama peta URL

Guna menentukan jalur URL untuk pembatalan validasi, gunakan isi permintaan JSON contoh berikut:

{
  "path": "/*"
}

Guna membatalkan validasi jalur URL hanya untuk satu host, gunakan isi permintaan JSON contoh berikut:

{
  "host": "host1.com",
  "path": "/*"
}

Melihat status permintaan pembatalan validasi Anda

Cloud CDN menghasilkan dua baris log per pembatalan validasi, satu saat pembatalan validasi diterima dan satunya lagi saat pembatalan validasi selesai. Log pertama memiliki informasi host dan jalur.

Untuk melihat status permintaan pembatalan validasi atau menemukan daftar pasti permintaan yang baru dikirim, Anda dapat menggunakan Cloud Logging atau Cloud Monitoring.

Konsol

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

    Buka Cloud CDN

  2. Klik server asal.

  3. Klik tab Cache invalidation.

  4. Untuk melihat status dan hasil permintaan pembatalan validasi, klik Go to Cloud Logging.

gcloud

Berikut contoh perintah yang menggunakan Logging:

gcloud logging read 'protoPayload.methodName="v1.compute.urlMaps.invalidateCache"' \
    --limit=10

Berikut contoh kueri yang menggunakan Monitoring:

protoPayload.serviceName="compute.googleapis.com"
protoPayload.methodName="v1.compute.urlMaps.invalidateCache"

Langkah berikutnya

  • Untuk memeriksa apakah Cloud CDN menyajikan respons dari cache, baca bagian Melihat log.
  • Untuk mempelajari konten yang dapat di-cache atau tidak dapat di-cache, baca bagian Ringkasan caching.