Menentukan header kustom

Media CDN memungkinkan Anda menentukan header respons dan permintaan kustom.

Header kustom memungkinkan Anda melakukan hal berikut:

• Menampilkan data geografis tentang klien, seperti negara, wilayah, atau kota, yang dapat Anda gunakan untuk menampilkan konten yang dilokalkan.
• Menentukan apakah respons disajikan dari cache (secara keseluruhan atau sebagian) dan dari lokasi cache mana respons tersebut disajikan.
• Menghapus, mengganti, atau menambahkan ke header permintaan dan respons.

Menetapkan header kustom

Header ditetapkan di setiap rute, yang memungkinkan Anda menambahkan dan menghapus header untuk konten yang berbeda, seperti manifes atau segmen video.

Tetapkan header permintaan kustom per rute di awal jalur pemrosesan CDN, sebelum keputusan caching. Misalnya, jika Anda menetapkan header cache-control sebagai header kustom per rute, header tersebut akan memengaruhi perilaku penyimpanan ke cache di CDN.

Secara default, nilai header yang ditambahkan dipisahkan dengan koma dan ditambahkan ke header respons atau permintaan dengan nama kolom yang sama.

Untuk menimpa nilai yang ada, tetapkan replace ke true.

gcloud edge-cache services describe prod-media-service

routeRules:
- priority: 1
   description: "video routes"
   matchRules:
      - prefixMatch: "/video/"
   headerAction:
      responseHeadersToAdd:
      # Return the country (or region) associated with the client's IP address.
      - headerName: "client-geo"
         headerValue: "{client_region}"
         replace: true
      requestHeadersToAdd:
      # Inform the upstream origin server the request is from Media CDN
      - headerName: "x-downstream-cdn"
         headerValue: "Media CDN"
      responseHeadersToRemove:
      - headerName: "X-User-ID"
      - headerName: "X-Other-Internal-Header"

route_rule {
  description = "video routes"
  priority    = 1
  match_rule {
    prefix_match = "/video/"
  }
  origin = google_network_services_edge_cache_origin.default.name
  header_action {
    response_header_to_add {
      # Return the country (or region) associated with the client's IP address.
      header_name  = "client-geo"
      header_value = "{client_region}"
      replace      = true
    }
    request_header_to_add {
      # Inform the upstream origin server that the request is from Media CDN.
      header_name  = "x-downstream-cdn"
      header_value = "Media CDN"
    }
    response_header_to_remove {
      header_name = "X-User-ID"
    }
    response_header_to_remove {
      header_name = "X-Other-Internal-Header"
    }
  }
}

Contoh ini melakukan hal berikut:

• Menambahkan header client-geo kustom ke respons menggunakan variabel {client_region}, yang menampilkan negara (atau wilayah) yang terkait dengan alamat IP klien.
• Menambahkan header x-downstream-cdn kustom ke permintaan menggunakan string statis.
• Menghapus dua header internal.

Untuk mengonfigurasi header kustom khusus origin, lihat Mengonfigurasi penulisan ulang host atau modifikasi header khusus origin.

Variabel header dinamis

Header kustom dapat berisi satu atau beberapa variabel dinamis.

Header permintaan yang merupakan bagian dari kebijakan kunci cache (cacheKeyPolicy.includedHeaderNames) dapat berisi satu atau beberapa variabel kustom. Header permintaan yang berisi variabel dinamis lainnya tidak dapat menjadi bagian dari kunci cache.

Pertimbangan berikut berlaku untuk variabel kustom:

• Header permintaan dan respons yang ada akan dipertahankan, kecuali yang berikut, yang akan dihapus:

  • X-User-IP
  • Header apa pun dengan X-Google atau X-GFE

• Kunci dan nilai header harus sesuai dengan RFC 7230, dengan bentuk yang sudah tidak berlaku tidak diizinkan.

• Semua kunci header menggunakan huruf kecil (per HTTP/2).

• Beberapa header digabungkan. Jika ada beberapa instance dari kunci header yang sama (misalnya, Via), load balancer akan menggabungkan nilainya menjadi satu daftar yang dipisahkan koma untuk satu kunci header. Hanya header yang nilainya dapat direpresentasikan sebagai daftar yang dipisahkan koma yang digabungkan. Header lain, seperti Set-Cookie, tidak pernah digabungkan.

• Beberapa header ditambahkan, atau nilai ditambahkan ke header tersebut. CDN Media selalu menambahkan atau mengubah header tertentu, seperti X-Forwarded-For.

• Media CDN memperluas header respons apa pun dengan variabel yang didukung, meskipun ditetapkan oleh klien atau origin. Hal ini memungkinkan Anda menetapkan header dinamis dari klien (seperti pemutar video) atau infrastruktur asal, selain mengonfigurasi header kustom. Media CDN tidak memperluas variabel di jalur permintaan.

• Sebagai contoh, sesuai dengan aturan yang dijelaskan sebelumnya, header X-Goog- dan X-Amz- dipertahankan dan diubah menjadi huruf kecil.

Nilai status cache

Variabel header {cdn_cache_status} dapat menampilkan beberapa nilai yang sesuai dengan tingkat cache yang menayangkan respons. Pertimbangkan panduan berikut untuk menafsirkan variabel header {cdn_cache_status}:

• Jika header berisi hit, konten yang diminta diambil dari cache.
• Jika header berisi miss, konten yang diminta tidak ditemukan di node cache dan harus diambil dari node upstream.
• Jika header berisi fetch, konten yang diminta diambil dari origin.

• Jika header berisi uncacheable, konten yang diminta dianggap tidak dapat di-cache oleh beberapa atau semua komponen infrastruktur caching.

  • Jika header juga berisi hit atau miss, konten yang diminta dianggap tidak dapat di-cache oleh beberapa komponen caching dan dapat di-cache oleh komponen lainnya.
  • Jika header juga tidak berisi hit atau miss, konten yang diminta dianggap tidak dapat di-cache oleh semua komponen caching, dan semua permintaan untuk konten ini diambil dari origin. Untuk memastikan konten Anda di-cache dengan benar, tinjau persyaratan asal Media CDN.

Header default

Media CDN menambahkan header permintaan dan respons berikut ke permintaan origin dan respons klien.

Kunci header menggunakan huruf kecil untuk header permintaan dan respons karena kunci header tidak peka huruf besar/kecil.

Header lainnya, termasuk lokasi edge point of presence (PoP) dan status cache (seperti hit dan miss), dapat ditambahkan menggunakan variabel header dinamis.