Mengonfigurasi rute layanan

Media CDN menyediakan kemampuan pemilihan rute HTTP tingkat lanjut yang memungkinkan Anda memetakan traffic ke konfigurasi dan origin edge tertentu pada level yang sangat mendetail.

Permintaan pencocokan

Konfigurasi Media CDN berisi kumpulan rute yang ditentukan di bagian Pemilihan Rute untuk resource EdgeCacheService. Rute ini cocok dengan permintaan berdasarkan (setidaknya) host. Untuk detail selengkapnya tentang cara traffic diarahkan ke asal, lihat HostRule dan PathMatcher. Setiap rute dapat menentukan konfigurasi CDN, penulisan ulang, pengalihan, kebijakan CORS, header HTTP kustom, dan pemetaan asalnya sendiri. Rute dapat berbagi origin.

Misalnya, Anda dapat merutekan permintaan manifes ke origin tertentu dan menentukan TTL cache berumur pendek dan kebijakan caching negatif. Permintaan segmen dapat dibagi ke origin lain menggunakan header dan parameter kueri untuk memerinci jenis atau pengguna manifes tertentu.

Contoh berikut menunjukkan cara mengarahkan permintaan yang cocok dengan header, parameter kueri, dan awalan jalur tertentu untuk media.example.com host:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 10
      origin: staging-live-origin
      matchRules:
      - prefixMatch: /vod/
        headerMatches:
        - headerName: "x-staging-client"
          presentMatch: true
        queryParameterMatches:
        - name: "live"
          exactMatch: "yes"
      routeAction:
        cdnPolicy:
          defaultTtl: 5s

Pencocokan jalur

Media CDN mendukung pencocokan jalur penuh (persis), awalan, dan karakter pengganti. Pencocokan jalur dapat digabungkan dengan pencocokan berbasis host, header, dan parameter kueri untuk membuat aturan pemilihan rute permintaan yang mendetail.

Berikut adalah tiga cara untuk mencocokkan jalur URL.

Kolom Deskripsi Contoh
matchRules[].fullPathMatch Kondisi fullPathMatch cocok dengan jalur URL lengkap, yang tidak menyertakan string kueri. Anda harus menentukan garis miring di akhir, jika relevan.

Rute dengan aturan kecocokan fullPathMatch: "/stream/" cocok dengan /stream/, tetapi tidak dengan /stream atau /stream/us/hls/1234.ts.

fullPathMatch adalah pencocokan eksplisit (persis).
matchRules[].prefixMatch Kondisi prefixMatch cocok dengan awalan jalur URL; URL yang diawali dengan string yang sama akan cocok.

Rute dengan aturan pencocokan prefixMatch: "/videos/" cocok dengan /videos/hls/58481314/manifest.m3u8 dan /videos/dash karena keduanya berisi awalan /videos/.
matchRules[].pathTemplateMatch Kondisi pathTemplateMatch mendukung operator karakter pengganti, sehingga Anda dapat mencocokkan pola URL dan segmen jalur yang kompleks, serta menangkap variabel bernama untuk menulis ulang URL.

Rute dengan aturan pencocokan pathTemplateMatch: "/**.m3u8" cocok dengan jalur URL apa pun yang diakhiri dengan .m3u8.

/content/en-GB/13/51491/manifest_193193.m3u8 dan /p/abc/1234/manifest_1080p5000.m3u8 cocok dengan pola ini.

Untuk contoh lainnya, lihat bagian pencocokan pola.

Untuk detail selengkapnya, lihat spesifikasi API untuk MatchRule.

Misalnya, untuk mencocokkan semua permintaan yang dimulai dengan /stream/, buat aturan rute yang mirip dengan berikut ini:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    - *.vod.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      matchRules:
      - prefixMatch: /stream/

Contoh ini secara eksplisit menyertakan garis miring di akhir aturan pencocokan:

  • Permintaan ke media.example.com/stream/id/1234/hls/manifest.m3u8 cocok dengan rute ini.
  • Permintaan ke media.example.com/stream-eu/id/4567/hls/manifest.m3u8 tidak cocok dengan rute ini.

Dalam kasus kedua, Media CDN menampilkan error 404 HTTP, kecuali jika ada rute lain atau rute generik yang dikonfigurasi.

Untuk panduan tentang cara kerja predekes untuk rute dengan awalan yang serupa, lihat bagian prioritas dan pengurutan rute.

Pencocokan pola (karakter pengganti)

Pencocokan pola memungkinkan Anda mencocokkan beberapa bagian URL, termasuk URL parsial dan akhiran (ekstensi file), menggunakan sintaksis karakter pengganti.

Anda juga dapat mengaitkan satu atau beberapa komponen jalur dengan variabel bernama di kolom pathTemplateMatch, lalu merujuk ke variabel tersebut saat menulis ulang URL di kolom pathTemplateRewrite. Hal ini memungkinkan Anda menyusun ulang dan menghapus komponen URL sebelum permintaan dikirim ke origin Anda.

Contoh berikut menunjukkan cara mencocokkan dua akhiran URL yang berbeda:

# EdgeCacheService.routing.pathMatchers[]
    routeRules:
    - priority: 1
      description: "Match video segments"
      matchRules:
      - pathTemplateMatch: "/**.ts"
      - pathTemplateMatch: "/**.m4s"
      origin: prod-video-storage

Sintaksis yang didukung mencakup hal berikut.

Operator Mencocokkan dengan Contoh
* Mencocokkan komponen jalur tunggal, hingga pemisah jalur berikutnya: / /videos/*/*/*.m4s cocok dengan /videos/123414/hls/1080p5000_00001.m4s.
** Cocok dengan nol segmen jalur atau lebih. Jika ada, harus menjadi operator terakhir. /**.mpd cocok dengan /content/123/india/dash/55/manifest.mpd.
{name} or {name=*}

Variabel bernama yang cocok dengan satu segmen jalur.

Mencocokkan komponen jalur tunggal, hingga pemisah jalur berikutnya: /.

/content/{format}/{lang}/{id}/{file}.vtt cocok dengan /content/hls/en-us/12345/en_193913.vtt dan mengambil format="hls", lang="en-us", id="12345", dan file="en_193913" sebagai variabel.
{name=videos/*} Variabel bernama yang cocok dengan lebih dari satu segmen jalur. Komponen jalur yang cocok dengan videos/* diambil sebagai variabel bernama. /videos/{language=lang/*}/* cocok dengan /videos/lang/en/video.m4s dan mengisi variabel jalur language dengan nilai lang/en.
{name=**}

Variabel bernama yang cocok dengan nol segmen jalur atau lebih.

Jika ada, harus menjadi operator terakhir.

/**.m3u8 atau /{path=**}.m3u8 cocok dengan semua segmen jalur hingga ekstensi.

/videos/{file=**} cocok dengan /videos/en-GB/def566/manifest.m3u8, termasuk ekstensi, dan mengambil variabel jalur file="en-GB/def566/manifest.m3u8.

Catatan:

  • Jika Anda tidak menulis ulang URL, gunakan operator * dan ** yang lebih sederhana.
  • Saat menggunakan variabel untuk mengambil komponen jalur, setiap bagian URL yang tidak ditangkap oleh variabel tidak dapat direferensikan dalam pathTemplateRewrite berikutnya. Sebagai contoh, lihat bagian mengambil variabel jalur.
  • Anda tidak dapat merujuk ke variabel dalam pathTemplateRewrite berikutnya yang tidak ada dalam pathTemplateMatch pada rute yang sama.
  • Variabel peka huruf besar/kecil, dengan {FORMAT}, {forMAT}, dan {format} mewakili variabel dan nilai yang berbeda.
  • Anda dapat menentukan hingga 10 operator (karakter pengganti atau variabel) dalam satu pencocokan. Kolom pathTemplateMatch dan pathTemplateRewrite tidak boleh melebihi 255 karakter.

Contoh: Mencocokkan ekstensi file

Contoh berikut menunjukkan kasus penggunaan umum untuk operator karakter pengganti: mencocokkan semua komponen jalur hingga akhiran.

Dalam kasus ini, lakukan tindakan berikut:

  • Ambil manifes video (playlist) yang diakhiri dengan .m3u8 dan .mpd dari asal manifes, dengan menerapkan TTL singkat (5 detik) ke respons ini karena sering berubah.
  • Ambil segmen video yang diakhiri dengan .ts dan .m4s dari asal segmen, dan terapkan TTL yang lebih lama (1 hari) untuk respons tersebut.

Pendekatan ini sering diterapkan saat menggunakan layanan SSAI (Injeksi Iklan Sisi Server) atau DAI (Penyisipan Iklan Dinamis), dan untuk video live yang manifesnya diupdate setiap beberapa detik.

Konfigurasi berikut menunjukkan cara mengonfigurasi perutean Media CDN untuk mendukung ini:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    # the first route only matches video manifests
    - priority: 1
      matchRules:
      - pathTemplateMatch: "/**.m3u8" # "**" matches all path segments
      - pathTemplateMatch: "/**.mpd"
      origin: manifest-origin
      routeAction:
        cdnPolicy:
          cacheMode: FORCE_CACHE_ALL
          defaultTtl: 5s
    # the second route matches video segments, fetches them
    # from a separate origin server, caching them for a longer
    # duration (1 day).
    - priority: 2
      matchRules:
      - pathTemplateMatch: "/**.ts"
      - pathTemplateMatch: "/**.m4s"
      origin: segment-origin
      routeAction:
        cdnPolicy:
          cacheMode: FORCE_CACHE_ALL
          defaultTtl: 86400s

Contoh: Mengambil variabel jalur

Contoh berikut menunjukkan cara menggunakan variabel bernama untuk mendeskripsikan satu atau beberapa komponen jalur.

Variabel ini dapat digunakan dalam pathTemplateRewrite untuk menulis ulang jalur sebelum permintaan dikirim ke asal, atau untuk membuat deskripsi mandiri pathTemplateMatch yang kompleks.

routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      matchRules:
      # Matches a request of "/us/en/hls/123139139/segments/00001.ts"
      - pathTemplateMatch: "/{country}/{lang}/{format}/{id}/{file=**}"
      origin: my-origin
      routeAction:
        urlRewrite:
          # Rewrites to "/123139139/hls/segments/00001.ts"
          pathTemplateRewrite: "/{id}/{format}/{file}"

Secara khusus:

  • Setiap variabel {name} menangkap satu segmen jalur. Segmen jalur adalah semua karakter di antara pasangan / ("garis miring") di jalur URL.
  • Variabel {name=**} menangkap semua segmen jalur yang tersisa; dalam hal ini, variabel ini cocok dengan segments/00001.ts dan master.m3u8.
  • Di pathTemplateRewrite di rute yang sama, Anda merujuk kembali ke beberapa variabel yang Anda ambil dalam pathTemplateMatch. Anda secara eksplisit menghapus variabel {country} dan {lang} karena tidak cocok dengan struktur direktori di asal.

Dengan contoh ini, hal berikut akan terjadi:

  • URL permintaan masuk /us/en/hls/123139139/segment_00001.ts cocok dengan pathTemplateMatch dan ditulis ulang menjadi /123139139/hls/segment_00001.ts sebelum dikirim ke asal.
  • URL permintaan masuk /us/123139139/master.m3u8 tidak cocok dengan pathTemplateMatch, dan menerima respons 404 (Not Found) HTTP.
  • URL permintaan masuk /br/es/dash/c966cbbe6ae3/subtitle_00001.vtt juga cocok dengan pathTemplateMatch dan ditulis ulang menjadi /c966cbbe6ae3/dash/subtitle_00001.vtt sebelum dikirim ke asal.

Untuk mempelajari lebih lanjut cara pencocokan karakter pengganti memiliki interoperabilitas dengan penulisan ulang URL, lihat bagian penulisan ulang.

Pencocokan host

Setiap layanan dapat cocok di beberapa nama host, dengan setiap kumpulan nama host yang berisi grup rutenya sendiri (dikenal sebagai pencocok jalur). Dalam kasus yang paling umum, semua nama host untuk layanan dipetakan ke satu kumpulan rute bersama dengan satu daftar host dan satu pencocok jalur.

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    - *.vod.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    # list of routes for the configured hosts
    - priority: 999
      matchRules:
      - prefixMatch: /
      origin: DEFAULT_ORIGIN

Host yang tidak cocok akan melihat halaman 404 HTTP default. Untuk menerima host apa pun, Anda dapat menyertakan karakter pengganti * sebagai entri hostRules[].hosts[].

Anda juga dapat menentukan grup rute (misalnya, mengelompokkan berdasarkan negara atau live versus on demand). Karena setiap layanan memiliki kebijakan keamanan tunggal, umumnya kami merekomendasikan untuk memiliki satu layanan untuk tiap pasar (geografi) atau workload yang Anda miliki.

Catatan:

  • Header host (atau HTTP/2 :authority) yang berisi port secara implisit dicocokkan dengan host yang dikonfigurasi. Anda tidak perlu menentukan port secara eksplisit.
  • Jika permintaannya melalui HTTP, entri hostRules[].hosts[] *.vod.example.com akan cocok dengan us.vod.example.com dan us.vod.example.com:80.
  • Jika permintaan melalui HTTPS (TLS), entri hostRules[].hosts[] dari *.vod.example.com akan cocok dengan us.vod.example.com:443.

Untuk detail selengkapnya, lihat spesifikasi API untuk HostRule.

Mencocokkan header dan parameter kueri

Anda dapat mengonfigurasi rute agar cocok dengan nama parameter kueri dan header tertentu, serta keberadaan nilai header (awalan, akhiran, atau pencocokan persis).

Pencocokan header dan parameter kueri adalah "AND" logis—permintaan harus cocok dengan semua parameter kueri dan kunci header (serta nilai, jika ditentukan) agar cocok dengan rute yang diberikan.

Misalnya, jika Anda ingin mengarahkan permintaan dengan nama kolom header dan nilai header tertentu ke asal bernama alternate-origin, konfigurasikan kondisi pencocokan Anda dalam routeRules[].matchRules[].headerMatches[]:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      origin: alternate-origin
      matchRules:
      - prefixMatch: "/videos/"
        headerMatches:
        - headerName: "x-device-name"
          exactMatch: "roku"

Dalam contoh ini, permintaan dengan /videos/ di awal URL dan header x-device-name: roku cocok dengan rute ini. Permintaan yang tidak memiliki nama header ini atau dengan nilai yang berbeda tidak cocok dengan rute ini.

Untuk detail selengkapnya, lihat spesifikasi API untuk HeaderMatch.

Demikian pula, untuk mencocokkan dengan parameter kueri, tentukan satu atau beberapa queryParameterMatches sebagai berikut:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      origin: eu-live-origin-prod
      matchRules:
      - prefixMatch: "/videos/"
        queryParameterMatches:
        - name: "playback_type"
          exactMatch: "live"
        - name: "geo"
          exactMatch: "eu"

Dalam contoh ini, permintaan klien https://cdn.example.com/videos/1234/abcd/xyz.m3u8?playback_type=live&geo=eu cocok dengan rute ini.

Untuk detail selengkapnya, lihat spesifikasi API untuk QueryParameterMatcher.

Menentukan rute generik (default)

Secara default, Media CDN menampilkan error 404 (Not Found) HTTP jika permintaan tidak cocok dengan rute yang dikonfigurasi.

Untuk mengonfigurasi rute catch-all, untuk pathMatcher (kumpulan rute), lakukan hal berikut:

  • Buat routeRule dengan prioritas terendah (angka tertinggi)—misalnya, 999, yang merupakan prioritas rute terendah.
  • Mengonfigurasi matchRule dengan pencocokan awalan / (cocok dengan semua jalur permintaan).
  • Mengonfigurasi (salah satu dari) origin atau urlRedirect pada rute.

Misalnya, untuk mengonfigurasi rute generik yang mengarahkan semua permintaan yang tidak cocok ke asal default bernama my-origin, buat rute baru dengan priority: 999 dan matchRules[].prefixMatch dari / sebagai berikut:

name: prod-service
routing:
  hostRules:
  - hosts:
    - cdn.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 999
      origin: my-origin
      matchRules:
      - prefixMatch: /

Anda dapat memilih untuk menulis ulang URL sebelum pengambilan origin, atau mengalihkan ke halaman default (seperti halaman landing), bukan mengirim permintaan "sebagaimana adanya" ke asal.

Prioritas dan pengurutan rute

Setiap rute dalam array routeRules[] harus memiliki priority yang terkait dengannya.

Rute yang lebih spesifik harus ditetapkan ke prioritas yang lebih tinggi (angka yang lebih kecil). Rute yang cocok dengan awalan /stream/ dengan prioritas 1 akan mencegah rute yang lebih spesifik dari /stream/live/eu/ dengan prioritas 5 agar tidak cocok dengan permintaan apa pun.

  • Rute prioritas tertinggi adalah "1", dan terendah adalah "999".
  • Anda tidak dapat mengonfigurasi dua atau beberapa routeRules dengan prioritas yang sama. Prioritas untuk setiap aturan harus ditetapkan ke angka antara 1 dan 999 inklusif.
  • Dengan menentukan rute generik, Anda dapat mengirim semua permintaan yang tidak cocok ke origin default atau mengalihkan permintaan tersebut ke halaman landing atau endpoint.

Pada contoh berikut, Anda dapat melihat bahwa rute /live/us/ tidak akan pernah cocok karena rute /live/ memiliki prioritas yang lebih tinggi:

routeRules:
- priority: 1
  description: "Live routes"
  matchRules:
  - prefixMatch: /live/
  routeAction:
    cdnPolicy:
      defaultTtl: 5s
- priority: 2
  description: "U.S based live streams"
  matchRules:
  # This would never be matched, as the /live/ prefixMatch at priority 1
  # would always take precedence.
  - prefixMatch: /live/us/
  routeAction:
    cdnPolicy:
      defaultTtl: 5s
- priority: 999
  description: "Catch-all route"
  matchRules:
  - prefixMatch: /

Untuk mengatasinya, Anda menempatkan rute yang lebih spesifik (lebih panjang) pada prioritas yang lebih tinggi:

routeRules:
- priority: 1
  description: "U.S based live streams"
  matchRules:
  # The more specific (longer) match is at a higher priority, and now
  # matches requests as expected.
  - prefixMatch: /live/us/
  routeAction:
    cdnPolicy:
      defaultTtl: 5s
- priority: 2
  description: "Live routes"
  matchRules:
  - prefixMatch: /live/
  routeAction:
    cdnPolicy:
      defaultTtl: 5s
- priority: 999
  description: "Catch-all route"
  matchRules:
  - prefixMatch: /

Hal ini memungkinkan rute yang lebih spesifik untuk mencocokkan permintaan dengan benar. Permintaan yang diawali dengan /live/eu/ akan tetap jatuh ke rute /live/ dengan prioritas 2.

Pemfilteran metode

Secara default, Media CDN hanya melakukan proxy GET, HEAD, dan OPTIONS metode ke origin Anda dan memfilter metode yang dapat mengubah origin Anda.

Dalam Pratinjau, Anda dapat mengganti perilaku default ini untuk aturan rute tertentu dengan menentukan metode yang ingin di-proxy-kan ke asal Anda. Selain GET, HEAD, dan OPTIONS, Media CDN mendukung PUT, POST, DELETE, dan PATCH.

Guna mengonfigurasi dukungan untuk sekumpulan metode bagi aturan rute, tentukan bagian routeMethods yang memiliki nilai allowed_methods untuk setiap metode.

routeRules:
- priority: 5
  description: "Video uploads"
  routeMethods:
    allowedMethods: ["PUT", "POST", "OPTIONS"]
  matchRules:
  - pathTemplateMatch: "/uploads/**.ts"
  origin: prod-video-storage
- priority: 10
  description: "Video serving"
  routeMethods:
    allowedMethods: ["GET", "HEAD"]
  matchRules:
  - pathTemplateMatch: "/videos/**.ts"
  origin: prod-video-storage

Dalam Pratinjau, Media CDN memungkinkan update dan tampilan konfigurasi ini menggunakan v1alpha1 Network Services API. Atau, Anda dapat menggunakan perintah gcloud alpha edge-cache services export dan perintah gcloud alpha edge-cache services import untuk memperbarui file YAML konfigurasi layanan.

Normalisasi jalur

Normalisasi jalur menjelaskan cara Media CDN menggabungkan beberapa representasi URL menjadi satu representasi kanonis dalam skenario tertentu.

Normalisasi jalur dapat secara langsung meningkatkan rasio ditemukan cache dengan mengurangi jumlah URL permintaan yang mewakili konten yang sama, dan dengan mengurangi error origin untuk origin yang memperkirakan jalur yang dinormalisasi.

Permintaan masuk dinormalkan sesuai dengan hal berikut:

  • Beberapa garis miring berturut-turut digabungkan menjadi satu garis miring. Misalnya, jalur URL /videos///12345/manifest.mpd dinormalisasi ke /videos/12345/manifest.mpd.
  • Segmen jalur dinormalkan sesuai dengan RFC 3986 Bagian 6.2.2.3. Misalnya, jalur /a/b/c/./../../g dinormalisasi ke /a/g berdasarkan algoritma "remove dot segments" yang ditentukan dalam RFC 3986. Normalisasi ini terjadi sebelum memeriksa cache atau meneruskan permintaan ke asal.
  • Permintaan tidak encoding persen dinormalisasi. Misalnya, URL dengan karakter garis miring berenkode persen (%2F) tidak didekode ke dalam bentuk yang tidak dienkode.

URL tetap peka huruf besar/kecil dan tidak dinormalisasi huruf besar/kecil. Banyak URL berisi encoding base64 yang peka huruf besar/kecil, termasuk URL dengan token permintaan yang ditandatangani.

Penulisan ulang dan pengalihan

Bagian berikut memberikan contoh tentang cara menulis ulang permintaan dan mengonfigurasi pengalihan.

Menulis ulang URL permintaan

Media CDN mendukung penulisan ulang host dan jalur. Penulisan ulang akan mengubah URL yang dikirim ke asal dan memungkinkan Anda mengubah host dan jalur sesuai kebutuhan. Penulisan ulang host dan jalur berada di tingkat rute, sehingga Anda dapat menentukan permintaan spesifik yang ditulis ulang berdasarkan matcher mana pun, termasuk jalur, parameter kueri, dan header permintaan.

Untuk detail selengkapnya, lihat spesifikasi API untuk RouteAction.UrlRewrite.

Berikut adalah tiga cara untuk menulis ulang permintaan:

Kolom Deskripsi
urlRewrite.pathPrefixRewrite

Menulis ulang jalur, menghapus awalan yang ditentukan dalam prefixMatch yang cocok dengan permintaan.

Hanya salah satu dari pathPrefixRewrite atau pathTemplateRewrite yang dapat ditentukan dalam satu aturan rute.

urlRewrite.pathTemplateRewrite

pathTemplateRewrite hanya dapat digunakan dengan aturan pencocokan pathTemplateMatch yang sesuai pada rute yang sama.

Hanya salah satu dari pathPrefixRewrite atau pathTemplateRewrite yang dapat ditentukan dalam satu aturan rute.

urlRewrite.hostRewrite Menulis ulang host sebelum permintaan dikirim ke server asal.

Catatan:

  • URL yang ditulis ulang tidak mengubah kunci cache. Kunci cache didasarkan pada URL permintaan yang dikirim oleh klien.
  • Penulisan ulang terjadi setelah pencocokan rute dan validasi permintaan yang ditandatangani. Rute tidak dicocokkan ulang dengan aturan pencocokan lain.

Contoh: Menghapus awalan jalur

Misalnya, untuk menulis ulang URL permintaan klien dari /vod/videos/hls/1234/abc.ts menjadi /videos/hls/1234/abc.ts (menghapus /vod dari jalur), Anda dapat menggunakan fitur pathPrefixRewrite:

name: prod-service
routing:
  hostRules:
  - hosts:
    - cdn.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      origin: my-origin
      matchRules:
      - prefixMatch: "/vod/videos/"
      routeAction:
        urlRewrite:
          pathPrefixRewrite: "/videos/"

pathPrefixRewrite berfungsi dengan mengganti seluruh komponen jalur yang cocok di matchRules[].prefixMatch dengan nilai pathPrefixRewrite.

Untuk menulis ulang nama host (misalnya, menulis ulang cdn.example.com menjadi my-bucket.s3.us-west-2.amazonaws.com), Anda dapat mengonfigurasi hal berikut:

name: prod-service
routing:
  hostRules:
  - hosts:
    - cdn.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      origin: my-origin
      matchRules:
      - prefixMatch: "/videos/"
      routeAction:
        urlRewrite:
          hostRewrite: "my-bucket.s3.us-west-2.amazonaws.com"

Dalam hal ini, URL permintaan origin akan berubah dari cdn.example.com/videos/* menjadi my-bucket.s3.us-west-2.amazonaws.com/videos/*. Anda juga dapat menggabungkan penulisan ulang host dan jalur dalam satu rute.

Contoh: Menggunakan variabel untuk menulis ulang URL

Untuk menggunakan pathTemplateMatch dan pathTemplateRewrite guna menulis ulang bagian dari URL permintaan masuk, lihat bagian mengambil variabel.

Permintaan pengalihan

Media CDN mendukung tiga jenis pengalihan:

  • Pengalihan host, yang hanya mengalihkan host (domain), tanpa mengubah parameter jalur dan kueri.
  • Pengalihan jalur, yang menggantikan jalur sepenuhnya.
  • Pengalihan awalan jalur, yang hanya menggantikan awalan yang cocok.

Mengalihkan secara default ke HTTP 301 (Moved Permanently), tetapi dapat dikonfigurasi untuk menampilkan kode status pengalihan yang berbeda per rute.

Konfigurasi berikut adalah contoh pengalihan berbasis awalan, tempat Anda mengalihkan pengguna yang mengunjungi https://cdn.example.com/on-demand/* ke https://cdn.example.com/streaming/*.

name: prod-service
routing:
  hostRules:
  - hosts:
    - cdn.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 10
      matchRules:
      - prefixMatch: "/on-demand/"
      urlRedirect:
        # The prefix matched in matchRules.prefixMatch is replaced
        # by this value
        prefixRedirect: "/streaming/"
        redirectResponseCode: TEMPORARY_REDIRECT # corresponds to a HTTP 307

Contoh ini juga mengubah pengalihan ke pengalihan sementara, yang mencegah klien (seperti browser) menyimpan dalam cache. Ini berguna jika Anda berharap untuk mengubahnya dalam waktu dekat.

Nilai redirectResponseCode yang didukung ditampilkan dalam tabel berikut.

Kode respons pengalihan Kode status HTTP
MOVED_PERMANENTLY_DEFAULT HTTP 301 (Dipindahkan Secara Permanen)
FOUND HTTP 302 (Ditemukan)
SEE_OTHER HTTP 303 (Lihat Lainnya)
TEMPORARY_REDIRECT HTTP 307 (Pengalihan Sementara)
PERMANENT_REDIRECT HTTP 308 (Pengalihan Permanen)

Catatan:

  • Rute dapat mengarahkan traffic ke tempat asal atau menampilkan pengalihan ke klien. Anda tidak dapat menetapkan kolom origin dan urlRedirect secara bersamaan.
  • Rute yang mengalihkan ke HTTPS mengharuskan minimal satu sertifikat SSL dilampirkan ke layanan.

Untuk detail selengkapnya, lihat spesifikasi API untuk RouteRule.UrlRedirect.

Mengalihkan semua permintaan ke HTTPS

Untuk mengalihkan semua permintaan ke HTTPS (bukan HTTP), Anda dapat mengonfigurasi setiap layanan untuk mengalihkan semua permintaan klien ke HTTPS secara otomatis. Klien yang terhubung melalui HTTP akan dikirimi respons 301 (Permanent Redirect) HTTP dengan header Location yang disetel ke URL yang sama menggunakan "https://", bukan "http://".

gcloud 

gcloud edge-cache services update MY_SERVICE \
    --require-tls

Request issued for: [MY_SERVICE]
Updated service [MY_SERVICE].

Perintah tersebut menampilkan deskripsi layanan Anda, dengan requireTls yang sekarang ditetapkan ke true.

  name: MY_SERVICE
  requireTls: true

Anda juga dapat memilih untuk menetapkan header Strict-Transport-Security sebagai header respons untuk mengarahkan klien agar selalu terhubung langsung melalui HTTPS.

Menggunakan backend penyimpanan pihak ketiga

Media CDN mendukung koneksi ke endpoint HTTP yang dapat dijangkau secara publik di luar Google Cloud, termasuk bucket penyimpanan AWS S3, Azure Blob Storage, dan penyedia penyimpanan lainnya. Hal ini dapat berguna jika Anda memiliki arsitektur multicloud, atau belum memigrasikan data ke Cloud Storage menggunakan Storage Transfer Service.

Konfigurasi origin minimal yang mengonfigurasi bucket yang dihosting secara virtual di AWS S3:

name: MY_S3_ORIGIN
originAddress: BUCKET-NAME.s3.REGION.amazonaws.com

Jika tidak menggunakan nama bucket yang cocok dengan nama host yang dikonfigurasi untuk resource EdgeCacheService, Anda juga harus mengonfigurasi penulisan ulang host untuk rute yang terkait dengan origin ini (atau origin). Jika tidak, header Host yang ditetapkan oleh permintaan klien akan digunakan saat mengambil data dari origin.

Misalnya, untuk memetakan semua permintaan dengan awalan jalur /legacy/ ke bucket eksternal, Anda dapat mengonfigurasi hostRewrite dan pathPrefixRewrite untuk menghapus awalan ini dari permintaan asal:

routeRules:
  - description: legacy backend
    matchRules:
    - prefixMatch: "/legacy/"
    routeAction:
      urlRewrite:
        hostRewrite: BUCKET-NAME.s3.REGION.amazonaws.com
        pathPrefixRewrite: /
      cdnPolicy:
        cacheMode: CACHE_ALL_STATIC
        defaultTtl: 3600s

Untuk mengetahui informasi selengkapnya tentang cara header host ditetapkan pada permintaan origin, lihat dokumentasi header permintaan origin.

Cross-Origin Resource Sharing (CORS)

Cross-Origin Resource Sharing (CORS) adalah pendekatan yang berfokus pada browser untuk membuat permintaan lintas origin dengan aman. Kebijakan CORS memungkinkan Anda menetapkan header CORS secara otomatis, seperti Access-Control-Allow-Origins, berdasarkan kebijakan per rute.

Konfigurasi CORS

Media CDN memungkinkan Anda menentukan kebijakan CORS pada rute untuk EdgeCacheService.

Kebijakan CORS menentukan aturan ini dengan kumpulan header HTTP yang umum. Anda dapat menetapkan header CORS umum dalam respons, seperti Access-Control-Allow-Origin, Access-Control-Max-Age, dan Access-Control-Allow-Headers. Header ini memungkinkan Anda melakukan panggilan lintas origin ke layanan Media CDN yang mungkin dihosting di domain (asal) yang berbeda dari frontend situs Anda dan dapat mencegah permintaan lintas asal yang tidak Anda izinkan secara eksplisit.

Misalnya, player.example.com dan api.example.com adalah origin yang berbeda (dalam hal browser), dan Anda mungkin perlu meminta aplikasi frontend membuat permintaan ke api.example.com untuk mengambil playlist berikutnya atau memuat ulang listingan konten terkait. Demikian pula, player.example.com mungkin perlu menghubungi cdn.example.com untuk mengambil playlist video dan segmen video: cdn.example.com harus menunjukkan bahwa tindakan tersebut tidak masalah, dan bahwa player.example.com adalah allowed origin, serta aturan lainnya (header yang diizinkan, apakah cookie dapat disertakan).

Untuk mengambil contoh lain, jika ingin mengizinkan stream.example.com sebagai origin dan header X-Client-ID dalam permintaan CORS, Anda dapat mengonfigurasi corsPolicy pada rute, sebagai berikut:

corsPolicy: maxAge: 600 allowOrigins: ["stream.example.com"] allowHeaders:
["X-Client-ID"]

corsPolicy dikonfigurasi di routing.pathMatchers[].routeRules[].routeAction.corsPolicy dalam EdgeCacheService. Setiap routeRule dapat menentukan corsPolicy yang berbeda sesuai kebutuhan, atau tidak sama sekali.

Jika Anda menentukan nilai corsPolicy dan juga menetapkan header respons kustom dengan menggunakan kolom responseHeadersToAdd pada rute dengan nama yang sama, header respons kustom akan lebih diutamakan, dan digunakan sebagai pengganti nilai corsPolicy.

Jika respons asal menetapkan header HTTP, dan Anda telah menetapkan nilai corsPolicy, nilai corsPolicy akan digunakan. Nilai tersebut tidak diciutkan atau digabungkan untuk menghindari pengiriman nilai header yang tidak valid ke klien, atau secara tidak sengaja menetapkan kebijakan yang lebih permisif dari yang dimaksudkan.

{origin_request_header} khusus diisi dengan header HTTP Origin dalam permintaan klien. Atribut ini dapat ditetapkan sebagai nilai header respons kustom pada rute, untuk header Access-Control-Allow-Origin.

Untuk detail selengkapnya, lihat spesifikasi API untuk RouteAction.CORSPolicy.

Kolom kebijakan CORS

Tabel berikut menjelaskan kolom yang terdapat dalam kebijakan CORS.

Kolom Deskripsi Contoh
allowOrigins

Menetapkan header respons Access-Control-Allow-Origins, yang menentukan origin mana yang dapat membuat permintaan lintas origin di lingkungan browser.

Misalnya, jika konten video Anda ditayangkan dari https://video.example.com, tetapi portal yang ditampilkan kepada pengguna ditayangkan dari https://stream.example.com, Anda harus menambahkan https://stream.example.com sebagai origin yang diizinkan.

Access-Control-Allow-Origins: https://stream.example.com
maxAge

Menetapkan header respons Access-Control-Max-Age, yang menentukan berapa lama, dalam detik, klien browser harus meng-cache respons terhadap permintaan pra-penerbangan CORS.

Beberapa browser membatasi waktu ini hingga 2 jam atau kurang, meskipun nilai maksimum (86400) telah ditentukan.

 Access-Control-Max-Age: 7200
allowMethods

Menetapkan header respons Access-Control-Allow-Methods, yang menentukan metode HTTP mana yang diizinkan untuk mengakses resource.

Secara default, Media CDN hanya mendukung metode GET, HEAD, dan OPTIONS. Di Pratinjau, untuk mengonfigurasi dukungan metode lainnya, lihat Metode rute.

 Access-Control-Allow-Methods: GET, OPTIONS, HEAD
allowHeaders

Menetapkan header Access-Control-Allow-Headers, yang menentukan header mana yang dapat dikirim dalam permintaan CORS.

Hal ini sering kali diperlukan oleh pemutar video, yang perlu mengakses beberapa header respons untuk konten video saat memintanya lintas origin.

 Access-Control-Allow-Headers: Content-Type, If-Modified-Since, Range, User-Agent
exposeHeaders

Menetapkan header respons Access-Control-Expose-Headers, yang menentukan header mana yang dapat diakses oleh JavaScript sisi klien.

Hal ini sering kali diperlukan oleh pemutar video, yang mungkin perlu mengakses header respons tertentu untuk konten video saat meminta konten lintas origin.

 Access-Control-Expose-Headers: Date, Cache-Status, Content-Type, Content-Length
allowCredentials

Menetapkan header respons Access-Control-Allow-Credentials, yang memungkinkan JavaScript sisi klien memeriksa respons untuk permintaan dengan menyertakan kredensial.

Header ini dihilangkan jika ditetapkan ke false.

 Access-Control-Allow-Credentials: true
disabled Menonaktifkan corsPolicy tanpa menghapusnya. Permintaan OPTIONS pra-penerbangan akan di-proxy-kan ke asal. T/A

Contoh corsPolicy

Contoh konfigurasi berikut menunjukkan konfigurasi corsPolicy dasar:

routeRules:
- priority: 1
  matchRules:
  - prefixMatch: /stream/
  routeAction:
    cdnPolicy:
      defaultTtl: 3600s
    corsPolicy:
      allowOrigins:
      - "https://stream.example.com"
      - "https://stream-staging.example.com"
      maxAge: 86400s # some browsers might only honor up to 7200s or less
      allowMethods:
      - "GET"
      - "HEAD"
      - "OPTIONS"
      allowHeaders:
      - "Content-Type"
      - "If-Modified-Since"
      - "Range"
      - "User-Agent"
      exposeHeaders:
      - "Content-Type"
      - "Content-Length"
      - "Date"

Memecahkan masalah pemilihan rute

Jika beberapa permintaan tidak mengambil hasil yang cocok atau menampilkan error, periksa hal berikut:

  • Rute harus memiliki matchRule dengan tepat satu dari prefixMatch, fullPathMatch, atau pathTemplateMatch yang ditentukan. API akan menampilkan error jika Anda tidak menyertakan salah satu kolom tersebut.
  • Pastikan priority untuk setiap rute ditetapkan dengan benar: rute yang lebih spesifik (lebih panjang) harus diberi prioritas yang lebih tinggi daripada kecocokan rute yang lebih pendek dan lebih luas.
  • Secara default, hanya permintaan GET, HEAD, dan OPTIONS yang didukung. Di Pratinjau, guna mengonfigurasi dukungan untuk metode lain, lihat Metode rute. Metode yang tidak diaktifkan untuk rute tertentu akan ditolak dengan error 405 (Method Not Allowed) HTTP.
  • Permintaan GET HTTP dengan isi, atau permintaan apa pun dengan cuplikan, ditolak dengan error 400 HTTP, karena isi permintaan tidak diizinkan dalam permintaan GET.
  • Pencocokan header dan parameter kueri adalah "AND" logis—permintaan harus cocok dengan semua parameter kueri atau kunci header (dan nilai, jika ditentukan) agar cocok dengan rute yang diberikan.

Langkah selanjutnya