Menyesuaikan kunci cache

Halaman ini menjelaskan cara menyesuaikan kunci cache Cloud CDN.

Mengubah konfigurasi kunci cache dapat menyebabkan penurunan rasio hit cache secara tiba-tiba jika permintaan baru mulai menggunakan kunci cache yang berbeda dari entri kunci cache lama. Demikian pula, mengubah pembuat kunci cache tidak selalu membatalkan entri yang di-cache jika permintaan baru menggunakan kunci yang sama dengan kunci cache lama. Untuk membatalkan validasi entri yang di-cache, lihat Membatalkan validasi konten yang di-cache.

Sebelum memulai

Halaman ini mengasumsikan pemahaman tentang Cloud CDN, kunci cache Cloud CDN, dan layanan backend yang di-load balancing. Sebaiknya tinjau halaman ini sebelum melanjutkan.

Mengaktifkan Cloud CDN dan menyesuaikan kunci cache

Petunjuk ini mengaktifkan Cloud CDN untuk layanan backend load-balanced dan menyesuaikan kunci cache dengan mengecualikan satu atau beberapa komponen. Jika Anda belum memiliki load balancer untuk digunakan sebagai origin, lihat dokumentasi Load Balancer Aplikasi eksternal untuk mengetahui petunjuk cara membuatnya.

Bucket backend tidak menyertakan protokol atau host dalam kunci cache karena hal ini tidak memengaruhi cara objek direferensikan dalam bucket Cloud Storage. Namun, permintaan tersebut menyertakan kumpulan parameter string kueri yang khusus untuk Cloud Storage, yang dapat memengaruhi respons dan dapat diperluas oleh daftar nama parameter yang dapat disesuaikan.

Konsol

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

    Buka Cloud CDN

  2. Klik Tambahkan asal.
  3. Di menu pull-down Origin, klik Select origin.
  4. Pilih origin yang ingin Anda aktifkan CDN-nya.
  5. Di baris asal, klik Configure.

    Jika Cloud CDN sudah diaktifkan di origin ini, klik menu terlebih dahulu, pilih Edit, lalu klik Konfigurasikan.

  6. Hapus centang pada kotak untuk kolom yang ingin Anda hapus dari kunci cache untuk layanan backend ini.

  7. Klik Simpan.

  8. Klik Tambahkan.

gcloud

Tentukan satu atau beberapa tanda opsional untuk mengecualikan komponen dari kunci cache untuk layanan backend ini.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-cdn

Flag opsional:

  • --no-cache-key-include-protocol
  • --no-cache-key-include-host
  • --no-cache-key-include-query-string

Memperbarui kunci cache untuk menambahkan kembali string protokol, host, dan kueri

Secara default, layanan backend yang dikonfigurasi untuk menggunakan Cloud CDN menyertakan semua komponen URI permintaan dalam kunci cache. Jika sebelumnya Anda menunjukkan bahwa satu atau beberapa komponen harus dikecualikan, Anda dapat menggunakan langkah-langkah berikut untuk menyertakannya lagi.

Petunjuk ini menambahkan kembali protokol, host, dan string kueri ke kunci cache untuk layanan backend yang ada yang telah mengaktifkan Cloud CDN.

Konsol

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

    Buka Cloud CDN

  2. Di baris load balancer, klik Menu , lalu klik Edit.
  3. Di baris layanan backend atau bucket backend yang ingin Andaubah, klik Konfigurasi.
  4. Di bagian Cache key, pilih Custom.
  5. Centang kotak Protokol, Host, dan String kueri.
  6. Biarkan kolom Query string parameters kosong.
  7. Klik Simpan.
  8. Klik Perbarui.

gcloud

Untuk menambahkan kembali satu komponen saja, tentukan flag tersebut saja. Flag apa pun yang tidak ditentukan tidak akan diubah.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-protocol \
    --cache-key-include-host \
    --cache-key-include-query-string

Memperbarui kunci cache untuk menggunakan daftar parameter string kueri yang disertakan atau dikecualikan

Petunjuk ini menetapkan kunci cache Cloud CDN untuk menggunakan daftar yang disertakan atau daftar yang dikecualikan dengan parameter string kueri.

Konsol

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

    Buka Cloud CDN

  2. Di baris load balancer, klik Menu , lalu klik Edit.
  3. Di baris layanan backend yang ingin Anda ubah, klik Konfigurasi.
  4. Di bagian Cache key, pilih Custom.
  5. Pastikan kotak centang Query string dicentang.
  6. Jika Anda ingin menentukan parameter string kueri yang harus menjadi bagian dari kunci cache, pilih Sertakan hanya yang dipilih.

    Jika Anda ingin menentukan bahwa semua parameter string kueri kecuali yang Anda cantumkan disertakan dalam kunci cache, pilih Sertakan semua kecuali yang dipilih.

  7. Masukkan daftar string yang dipisahkan koma di kolom Parameter string kueri.

  8. Klik Simpan.

  9. Klik Perbarui.

gcloud

Gunakan perintah ini untuk menetapkan parameter string kueri user ke daftar yang disertakan dari layanan backend.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

Gunakan perintah ini untuk menetapkan parameter string kueri user ke daftar pengecualian layanan backend.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

Gunakan perintah ini untuk menetapkan parameter string kueri user ke daftar penyertaan bucket backend.

gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-query-string-whitelist user

Memperbarui kunci cache untuk menggunakan header HTTP

Petunjuk ini menetapkan kunci cache Cloud CDN untuk menggunakan header HTTP.

Konsol

Konsol Google Cloud tidak didukung untuk fitur ini.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]
gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]

Memperbarui kunci cache untuk menggunakan cookie bernama

Petunjuk ini menetapkan kunci cache Cloud CDN untuk menggunakan cookie HTTP.

Konsol

Konsol Google Cloud tidak didukung untuk fitur ini.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-named-cookie=[NAMED_COOKIE,...]

Langkah selanjutnya