Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan peta URL

Load Balancer Aplikasi Google Clouddan Traffic Director menggunakan resource konfigurasi Google Cloud yang disebut peta URL untuk merutekan permintaan HTTP(S) ke layanan backendatau bucket backend.

Misalnya, dengan Load Balancer Aplikasi eksternal, Anda dapat menggunakan satu peta URL untuk mengarahkan permintaan ke berbagai tujuan berdasarkan aturan yang dikonfigurasi di peta URL:

Permintaan untuk https://example.com/video mengarah ke satu layanan backend.
Permintaan untuk https://example.com/audio mengarah ke layanan backend lain.

Permintaan untuk https://example.com/images masuk ke bucket backend Cloud Storage.

Permintaan untuk kombinasi host dan jalur lainnya mengarah ke layanan backend default.

Peta URL digunakan dengan produk Google Cloud berikut:

Load Balancer Aplikasi Eksternal (mode global, regional, dan klasik)
Load Balancer Aplikasi Internal (mode lintas region dan regional)
Traffic Director, saat Traffic Director di-deploy dengan API load balancing

Ada dua jenis resource peta URL yang tersedia: global dan regional. Jenis resource yang Anda gunakan bergantung pada skema load balancing produk.

Produk	Skema load balancing	Jenis resource peta URL	Tujuan yang didukung
Load Balancer Aplikasi eksternal global	`EXTERNAL_MANAGED`	Global, eksternal	Layanan backend, bucket backend
Load Balancer Aplikasi Klasik	`EXTERNAL`	Global, eksternal	Layanan backend, bucket backend
Load Balancer Aplikasi eksternal regional	`EXTERNAL_MANAGED`	Regional, eksternal	Layanan backend
Load Balancer Aplikasi internal lintas region	`INTERNAL_MANAGED`	Global, internal	Layanan backend
Load Balancer Aplikasi internal regional	`INTERNAL_MANAGED`	Regional, internal	Layanan backend
Traffic Director	`INTERNAL_SELF_MANAGED`	Global, internal	Layanan backend

Tidak semua fitur peta URL tersedia untuk semua produk. Peta URL yang digunakan dengan Load Balancer Aplikasi eksternal global, Load Balancer Aplikasi eksternal regional, Load Balancer Aplikasi internal, dan Traffic Director juga mendukung beberapa fitur pengelolaan traffic lanjutan. Untuk informasi lebih lanjut tentang perbedaan ini, lihat Perbandingan fitur load balancer: Pemilihan rute dan pengelolaan traffic. Selain itu, peta URL regional dapat menjadi resource yang ditetapkan sebagai layanan di App Hub, yang berada dalam pratinjau.

Cara kerja peta URL

Saat permintaan tiba di load balancer, load balancer akan merutekan permintaan tersebut ke layanan backend tertentuatau bucket backend berdasarkan aturan yang ditentukan dalam peta URL.

Layanan backend mewakili kumpulan backend, yang merupakan instance dari aplikasi atau microservice. Bucket backend adalah bucket Cloud Storage, yang biasanya digunakan untuk menghosting konten statis, seperti gambar.

Untuk Load Balancer Aplikasi eksternal regional, Load Balancer Aplikasi internal, dan Traffic Director, tujuan yang memungkinkan adalah sebagai berikut:

Layanan backend default
Layanan backend non-default

Selain itu, Load Balancer Aplikasi eksternal global mendukung fitur berikut:

Bucket backend default
Bucket backend non-default

Misalnya, asumsikan Anda memiliki penyiapan berikut:

Satu alamat IP:
- Semua permintaan ke organisasi Anda diarahkan ke alamat IP dan load balancer yang sama.
- Traffic diarahkan ke layanan backend yang berbeda berdasarkan URL permintaan.
Dua domain:
- example.net mengadakan video pelatihan.
- example.org menghosting situs organisasi Anda.
Empat set server:
- Salah satunya akan menghosting situs organisasi Anda (layanan backend: org-site).
- Satu akan menghosting situs video pelatihan keseluruhan (layanan backend: video-site).
- Satu video menghosting video pelatihan definisi tinggi (HD) (layanan backend: video-hd).
- Satu video pelatihan definisi standar (SD) dihosting (layanan backend: video-sd).

Anda ingin hal berikut terjadi:

Permintaan ke example.org (atau domain apa pun selain example.net) untuk membuka layanan backend org-site.
Permintaan ke example.net yang tidak cocok dengan jalur yang lebih spesifik untuk mengarah ke layanan backend video-site.
Permintaan ke example.net/video/hd/* untuk membuka layanan backend video-hd.
Permintaan ke example.net/video/sd/* untuk membuka layanan backend video-sd.

--path-rule untuk /video/* cocok dengan URI seperti /video/test1 dan /video/test2. Namun, aturan jalur ini tidak cocok dengan jalur /video.

Jika load balancer menerima permintaan dengan /../ di URL, load balancer akan mengubah URL dengan menghapus segmen jalur sebelum .., dan merespons dengan URL yang telah ditransformasi. Misalnya, saat permintaan dikirim untuk http://example.net/video/../abc, load balancer akan merespons dengan pengalihan 302 ke http://example.net/abc. Sebagian besar klien kemudian bereaksi dengan mengeluarkan permintaan ke URL yang ditampilkan oleh load balancer (dalam hal ini, http://example.net/abc). Pengalihan 302 ini tidak dicatat dalam log di Cloud Logging.

Peta URL memungkinkan Anda menyiapkan jenis host dan perutean berbasis jalur ini.

Contoh penyiapan layanan backend. — Contoh penyiapan layanan backend (klik untuk memperbesar).

Penamaan

Setiap peta URL memiliki nama. Saat Anda membuat load balancer berbasis HTTP(S) dengan menggunakan Konsol Google Cloud, peta URL akan diberi nama. Nama ini sama dengan nama load balancer di Konsol Google Cloud. Jika menggunakan Google Cloud CLI atau API, Anda dapat menentukan nama kustom untuk peta URL.

Komponen peta URL

Peta URL adalah kumpulan resource konfigurasi Google Cloud yang mengarahkan permintaan untuk URL ke layanan backendatau bucket backend. Peta URL melakukannya dengan menggunakan bagian nama host dan jalur untuk setiap URL yang diproses:

Nama host adalah bagian nama domain dari URL; misalnya, bagian nama host dari URL http://example.net/video/hd adalah example.net.
Jalur adalah bagian URL setelah nama host dan nomor port opsional; misalnya, bagian jalur URL http://example.net/video/hd adalah /video/hd.

Konfigurasi load balancer dengan peta URL dasar. — Konfigurasi load balancer dengan peta URL dasar (klik untuk memperbesar).

Diagram ini menunjukkan struktur objek konfigurasi load balancing dalam kaitannya satu sama lain.

Anda mengontrol layanan backend atau bucket backend yang menerima permintaan masuk menggunakan parameter konfigurasi peta URL berikut:

Layanan backend default atau bucket backend default. Saat membuat peta URL, Anda harus menentukan layanan backend default atau bucket backend default, tetapi tidak keduanya. Default ini mewakili layanan backend atau bucket backend tempat Google Cloud mengarahkan permintaan URL dengan nama host apa pun, kecuali jika ada aturan host yang berlaku.

Aturan host (hostRules). Aturan host mengarahkan permintaan yang dikirim ke satu atau beberapa nama host terkait ke satu pencocok jalur (pathMatchers). Bagian nama host URL sama persis dengan kumpulan nama host yang dikonfigurasi pada aturan host. Di aturan jalur dan host peta URL, jika Anda menghapus host, aturan akan cocok dengan host apa pun yang diminta. Guna mengarahkan permintaan untuk http://example.net/video/hd ke pencocok jalur, Anda memerlukan satu aturan host yang setidaknya menyertakan nama host example.net. Aturan host yang sama tersebut juga dapat menangani permintaan untuk nama host lain, tetapi akan mengarahkannya ke pencocok jalur yang sama.

Jika perlu mengarahkan permintaan ke pencocok jalur yang berbeda, Anda harus menggunakan aturan host yang berbeda. Dua aturan host dalam peta URL tidak boleh menyertakan nama host yang sama.

Anda dapat mencocokkan semua nama host dengan menentukan karakter pengganti * dalam aturan host. Misalnya, untuk URL http://example.org, http://example.net/video/hd, dan http://example.com/audio, ketiga nama host example.org, example.net, dan example.com dapat dicocokkan dengan menentukan * dalam aturan host. Anda juga dapat mencocokkan nama host sebagian dengan menentukan karakter pengganti *. Misalnya, aturan host *.example.net dicocokkan dengan nama host news.example.net dan finance.example.net.
- Nomor port. Load Balancer Aplikasi yang berbeda menangani nomor port dengan berbeda. Dalam kasus Load Balancer Aplikasi internal, Anda dapat menggunakan parameter Host rule untuk menentukan nomor port. Misalnya, untuk mengarahkan permintaan example.net pada port 8080, tetapkan aturan host ke example.net:8080. Dalam kasus Load Balancer Aplikasi klasik, hanya nama host di URL yang dipertimbangkan saat mencocokkan aturan host. Misalnya, permintaan example.net untuk port 8080 dan port 80 cocok dengan aturan host example.net.
Pencocok jalur (pathMatchers). Pencocok jalur adalah parameter konfigurasi yang direferensikan oleh aturan host. Class ini menentukan hubungan antara bagian jalur URL dan layanan backend atau bucket backend yang harus melayani permintaan. Pencocok jalur terdiri dari dua elemen:
- Layanan backend default pencocok jalur atau bucket backend default pencocok jalur. Untuk setiap pencocok jalur, Anda setidaknya harus menentukan satu layanan backend default atau bucket backend default, tetapi tidak keduanya. Setelan default ini mewakili layanan backend atau bucket backend tempat Google Cloud mengarahkan permintaan untuk URL yang nama host-nya cocok dengan aturan host yang terkait dengan pencocok jalur, dan yang jalur URL-nya tidak cocok dengan aturan jalur apa pun di pencocok jalur.
- Aturan jalur. Untuk setiap pencocok jalur, Anda dapat menentukan satu atau beberapa aturan jalur, yang merupakan key-value pair yang memetakan jalur URL ke satu layanan backend atau bucket backend. Bagian berikutnya berisi informasi selengkapnya tentang cara kerja aturan jalur.

Urutan operasi

Untuk nama host dan jalur tertentu di URL yang diminta, Google Cloud menggunakan prosedur berikut untuk mengarahkan permintaan ke layanan backendatau bucket backendyang benar, seperti yang dikonfigurasi di peta URL Anda:

Jika peta URL tidak berisi aturan host untuk nama host URL, Google Cloud akan mengarahkan permintaan ke layanan backend default atau bucket backend defaultdari peta URL, bergantung pada layanan yang Anda tentukan.
Jika peta URL berisi aturan host yang menyertakan nama host URL, pencocok jalur yang dirujuk oleh aturan host tersebut akan dipertimbangkan:
- Jika pencocok jalur berisi aturan jalur yang sama persis dengan jalur URL, Google Cloud akan mengarahkan permintaan ke layanan backend atau bucket backend untuk aturan jalur tersebut.
- Jika pencocok jalur tidak berisi aturan jalur yang sama persis dengan jalur URL, tetapi berisi aturan jalur yang diakhiri dengan /* yang awalannya cocok dengan bagian terpanjang jalur URL, Google Cloud akan mengarahkan permintaan ke layanan backend atau bucket backend untuk aturan jalur tersebut. Misalnya, untuk peta URL yang berisi dua aturan pencocok jalur /video/hd/movie1 dan /video/hd/*, jika URL berisi jalur yang tepat /video/hd/movie1, URL tersebut akan dicocokkan dengan aturan jalur tersebut.
- Jika tidak satu pun kondisi sebelumnya benar, Google Cloud akan mengarahkan permintaan ke layanan backend default pencocok jalur atau bucket backend default, bergantung pada layanan yang Anda tetapkan.

Batasan pencocok jalur

Nama host, pencocok jalur, dan aturan jalur memiliki batasan.

Karakter pengganti, ekspresi reguler, dan URL dinamis dalam aturan jalur

Aturan jalur hanya dapat menyertakan karakter pengganti (*) setelah karakter garis miring (/). Misalnya, /videos/* dan /videos/hd/* valid untuk aturan jalur, sedangkan /videos* dan /videos/hd* tidak valid.
Aturan jalur tidak menggunakan ekspresi reguler atau pencocokan substring. PathTemplateMatch dapat menggunakan operator pencocokan jalur yang disederhanakan. Misalnya, aturan jalur untuk /videos/hd atau /videos/hd/* tidak berlaku untuk URL dengan jalur /video/hd-abcd. Namun, aturan jalur untuk /video/* berlaku untuk jalur tersebut.
Pencocok jalur (dan peta URL secara umum) tidak menawarkan fitur yang berfungsi seperti perintah LocationMatch Apache. Jika Anda memiliki aplikasi yang menghasilkan jalur URL dinamis yang memiliki awalan umum, seperti /videos/hd-abcd dan /videos/hd-pqrs, dan Anda perlu mengirim permintaan yang dibuat ke jalur tersebut ke layanan backend yang berbeda, Anda mungkin tidak dapat melakukannya dengan peta URL. Untuk kasus yang berisi hanya beberapa kemungkinan URL dinamis, Anda mungkin dapat membuat pencocok jalur dengan kumpulan aturan jalur yang terbatas. Untuk kasus yang lebih kompleks, Anda perlu melakukan pencocokan ekspresi reguler berbasis jalur di backend.

Karakter pengganti dan operator pencocokan pola di template jalur untuk aturan rute

Operator pencocokan pola yang fleksibel memungkinkan Anda mencocokkan beberapa bagian jalur URL, termasuk URL parsial dan akhiran (ekstensi file), menggunakan sintaksis karakter pengganti. Operator ini dapat berguna saat Anda perlu mengarahkan traffic dan menjalankan penulisan ulang berdasarkan jalur URL yang kompleks. Anda juga dapat mengaitkan satu atau beberapa komponen jalur dengan variabel bernama, lalu merujuk ke variabel tersebut saat menulis ulang URL. Dengan variabel bernama, Anda dapat menyusun ulang dan menghapus komponen URL sebelum permintaan dikirim ke asal Anda.

Pencocokan pola dengan karakter pengganti hanya didukung untuk produk berikut:

Load Balancer Aplikasi eksternal global

Load Balancer Aplikasi eksternal regional
Load Balancer Aplikasi internal regional

Load Balancer Aplikasi internal lintas region
Traffic Director

Contoh berikut mengarahkan traffic untuk aplikasi e-commerce yang memiliki layanan terpisah untuk informasi keranjang dan informasi pengguna. Anda dapat mengonfigurasi routeRules dengan operator pencocokan pola fleksibel dan variabel bernama untuk mengirim ID unik pengguna ke halaman detail akun pengguna dan informasi keranjang pengguna ke layanan pemrosesan keranjang setelah menulis ulang URL.

  pathMatchers:
    - name: cart-matcher
      routeRules:
        - description: CartService
          matchRules:
            - pathTemplateMatch: '/xyzwebservices/v2/xyz/users/{username=*}/carts/{cartid=**}'
          service: cart-backend
          priority: 1
          routeAction:
            urlRewrite:
              pathTemplateRewrite: '/{username}-{cartid}/'
    - name: user-matcher
      routeRules:
        - description: UserService
          matchRules:
            - pathTemplateMatch: '/xyzwebservices/v2/xyz/users/*/accountinfo/*'
          service: user-backend
          priority: 1

Berikut adalah hal yang terjadi saat klien meminta /xyzwebservices/v2/xyz/users/abc@xyz.com/carts/FL0001090004/entries/SJFI38u3401nms?fields=FULL&client_type=WEB, yang memiliki informasi pengguna dan informasi keranjang:

Jalur permintaan cocok dengan pathTemplateMatch dalam cart-matcher pathMatcher. Variabel {username=*} cocok dengan abc@xyz.com dan variabel {cartid=**} cocok dengan FL0001090004/entries/SJFI38u3401nms.
Parameter kueri dipisahkan dari jalurnya, jalurnya ditulis ulang berdasarkan pathTemplateRewrite, dan parameter kueri ditambahkan ke jalur yang ditulis ulang. Kita hanya boleh menggunakan variabel yang sama dengan yang digunakan untuk menentukan pathTemplateMatch di pathTemplateRewrite.
Permintaan yang ditulis ulang dikirim ke cart-backend dengan jalur URL yang ditulis ulang: /abc@xyz.com-FL0001090004/entries/SJFI38u3401nms?fields=FULL&client_type=WEB.

Hal berikut terjadi saat klien meminta /xyzwebservices/v2/xyz/users/abc%40xyz.com/accountinfo/abc-1234, yang hanya memiliki informasi pengguna dan akun:

Jalur permintaan cocok dengan pathTemplateMatch dalam user-matcher pathMatcher. * pertama cocok dengan abc%40xyz.com dan * kedua cocok dengan abc-1234.
Permintaan dikirim ke user-backend.

Tabel berikut menguraikan sintaksis untuk pola template jalur.

Operator	Mencocokkan dengan
*``**	Segmen jalur tunggal, tidak termasuk karakter `/` pemisah jalur di sekitarnya.
``**	Mencocokkan nol karakter atau lebih, termasuk karakter `/` pemisah jalur di antara beberapa segmen jalur. Jika operator lain disertakan, operator `**` harus menjadi operator terakhir.
*`{name}` atau `{name=}`**	Variabel bernama yang cocok dengan satu segmen jalur. Mencocokkan segmen jalur tunggal, tidak termasuk karakter `/` pemisah jalur di sekitarnya.
*`{name=news/}`**	Variabel bernama yang secara eksplisit cocok dengan dua segmen jalur: segmen karakter pengganti `news` dan `*`.
*`{name=/news/}`*	Variabel bernama yang cocok dengan tiga segmen jalur.
`{name=}`**	Variabel bernama cocok dengan nol karakter atau lebih. Jika ada, harus menjadi operator terakhir.

Saat Anda menggunakan operator ini untuk pencocokan pola yang fleksibel, perhatikan hal-hal berikut:

Beberapa operator dapat digabungkan dalam satu pola.
Parameter kueri dipisahkan dari jalurnya, jalur ditulis ulang berdasarkan pathTemplateRewrite, dan parameter kueri ditambahkan ke jalur yang ditulis ulang.
Permintaan tidak dinormalisasi dengan encoding persen. Misalnya, URL dengan karakter garis miring yang dienkode dengan persen (%2F) tidak didekode ke dalam bentuk yang tidak dienkode.
Setiap nama variabel, seperti {segment} atau {region}, hanya dapat muncul sekali dalam pola yang sama. Beberapa variabel dengan nama yang sama tidak valid dan akan ditolak.
Nama variabel peka huruf besar/kecil dan harus berupa ID yang valid. Untuk memeriksa apakah nama variabel valid, pastikan nama tersebut cocok dengan ekspresi reguler ^[a-zA-Z][a-zA-Z0-9_]*$.
- {API}, {api}, dan {api_v1} adalah ID yang valid. Mereka mengidentifikasi tiga variabel yang berbeda.
- {1}, {_api}, dan {10alpha} bukan ID yang valid.
Ada batas lima operator per pola template.

Untuk menjalankan penulisan ulang URL opsional sebelum permintaan dikirim ke asal, Anda dapat menggunakan variabel yang sama yang ditetapkan untuk mengambil sebuah jalur. Misalnya, Anda dapat mereferensikan, mengurutkan ulang, atau menghilangkan variabel di kolom pathTemplateRewrite saat menentukan urlRewrite.

Saat Anda menggunakan variabel dan operator untuk pencocokan pola yang fleksibel untuk penulisan ulang URL, perhatikan pertimbangan berikut:

Saat menulis ulang URL, Anda dapat menghilangkan variabel jika tidak diperlukan sebagai bagian dari URL yang ditulis ulang.
Sebelum penulisan ulang, Anda dapat mengidentifikasi URL yang dikirim oleh klien di origin Anda dengan memeriksa header respons. URL klien asli diisi dengan header x-client-request-url dan header x-envoy-original-path.

Nama host dan hubungan aturan host

Nama host hanya dapat mereferensikan satu aturan host.
Satu aturan host dapat memproses beberapa nama host.

Hubungan antara nama host dan aturan host. — Hubungan antara nama host dan aturan host (klik untuk memperbesar).

Aturan host dan hubungan pencocok jalur

Beberapa aturan host dapat merujuk pada satu pencocok jalur.
Aturan host hanya dapat mereferensikan satu pencocok jalur.

Diagram berikut mengilustrasikan poin-poin ini.

Hubungan antara aturan host dan pencocok jalur. — Hubungan antara aturan host dan pencocok jalur (klik untuk memperbesar).

Hubungan URL dan backend

Setiap URL unik hanya diarahkan ke satu layanan backend atau bucket backend. Oleh karena itu:

Google Cloud menggunakan bagian nama host URL untuk memilih satu aturan host dan pencocok jalur yang direferensikannya.
Jika menggunakan aturan jalur di pencocok jalur, Anda tidak dapat membuat lebih dari satu aturan jalur untuk jalur yang sama. Misalnya, permintaan untuk /videos/hd tidak dapat diarahkan ke lebih dari satu layanan backend atau bucket backend. Layanan backend dapat memiliki grup instance backend atau grup endpoint jaringan backend (NEG) di zona dan region berbeda, dan Anda dapat membuat bucket backend yang menggunakan class Multi-Regional Storage.

Guna mengarahkan traffic untuk URL unik ke beberapa layanan, Anda dapat menggunakan aturan rute, bukan aturan jalur. Jika Anda mengonfigurasi pencocok jalur dengan aturan rute untuk kecocokan header atau parameter, URL unik dapat diarahkan ke lebih dari satu layanan backend atau bucket, berdasarkan konten header atau parameter kueri di URL tersebut.

Demikian pula untuk Load Balancer Aplikasi eksternal regional dan Traffic Director, layanan backend berbobot pada tindakan rute dapat mengarahkan URL yang sama ke beberapa layanan backend atau bucket, bergantung pada bobot yang ditetapkan pada layanan backend berbobot.

Peta dan protokol URL

Anda dapat menggunakan peta URL, aturan host, dan pencocok jalur yang sama untuk memproses permintaan HTTP dan HTTPS yang dikirimkan oleh klien, selama proxy HTTP target dan proxy HTTPS target mereferensikan peta URL.

Peta URL paling sederhana

Peta URL yang paling sederhana hanya memiliki layanan backend default atau bucket backend default. File ini tidak berisi aturan host dan tidak ada pencocok jalur. Layanan backend default atau bucket backend default (mana pun yang Anda tentukan) yang menangani semua URL yang diminta.

Jika Anda menetapkan layanan backend default, Google Cloud akan mengarahkan permintaan ke grup instance backend atau NEG backend-nya sesuai dengan konfigurasi layanan backend.

Peta URL tanpa aturan kecuali default. — Peta URL tanpa aturan kecuali default (klik untuk memperbesar).

Contoh alur kerja peta URL dengan Load Balancer Aplikasi eksternal

Contoh berikut mengilustrasikan urutan operasi untuk peta URL. Contoh ini hanya mengonfigurasi peta URL untuk Load Balancer Aplikasi klasik yang sudah ada. Untuk kesederhanaan konseptual, alat ini hanya menggunakan layanan backend; namun, Anda dapat mengganti bucket backend sebagai gantinya. Untuk mempelajari cara membuat komponen lain dari load balancer, lihat Membuat Load Balancer Aplikasi klasik.

Untuk informasi selengkapnya tentang cara membuat dan mengonfigurasi peta URL dengan pencocok jalur dan aturan host, lihat dokumentasi gcloud compute url-maps create.

Buat peta URL untuk load balancer dan tentukan layanan backend default. Contoh ini akan membuat peta URL bernama video-org-url-map yang mereferensikan layanan backend yang ada bernama org-site.
```
gcloud compute url-maps create video-org-url-map \
    --default-service=org-site
```
Buat pencocok jalur bernama video-matcher dengan karakteristik berikut:
- Layanan backend default adalah video-site, layanan backend yang sudah ada.
- Tambahkan aturan jalur yang mengarahkan permintaan untuk jalur URL yang sama persis dengan /video/hd atau awalan jalur URL /video/hd/* ke layanan backend yang ada yang bernama video-hd.
- Tambahkan aturan jalur yang mengarahkan permintaan untuk jalur URL yang sama persis dengan /video/sd atau awalan jalur URL /video/sd/* ke layanan backend yang ada yang bernama video-sd.
```
gcloud compute url-maps add-path-matcher video-org-url-map \
    --path-matcher-name=video-matcher \
    --default-service=video-site \
    --path-rules=/video/hd=video-hd,/video/hd/*=video-hd,/video/sd=video-sd,/video/sd/*=video-sd
```

Buat aturan host untuk nama host example.net yang merujuk pada pencocok jalur video-matcher.

gcloud compute url-maps add-host-rule video-org-url-map \
    --hosts=example.net \
    --path-matcher-name=video-matcher

Peta URL video-org-url-map akan terlihat seperti ini:

gcloud compute url-maps describe video-org-url-map

creationTimestamp: '2021-03-05T13:34:15.833-08:00'
defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/org-site
fingerprint: mfyJIT7Zurs=
hostRules:
- hosts:
  - '*'
  pathMatcher: video-matcher
- hosts:
  - example.net
  pathMatcher: video-matcher
id: '8886405179645041976'
kind: compute#urlMap
name: video-org-url-map
pathMatchers:
- defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/video-site
  name: video-matcher
  pathRules:
  - paths:
    - /video/hd
    - /video/hd/*
    service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/video-hd
  - paths:
    - /video/sd
    - /video/sd/*
    service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/video-sd
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/video-org-url-map

Peta URL video-org-url-map mengarahkan URL yang diminta ke backend dengan cara berikut.

Peta URL dengan aturan jalur, pencocok jalur, dan aturan host. — Peta URL dengan aturan jalur, pencocok jalur, dan aturan host (klik untuk memperbesar).

Tabel berikut menjelaskan pemrosesan permintaan yang ditampilkan dalam diagram sebelumnya.

Nama host	Jalur URL	Layanan backend yang dipilih	Alasan pemilihan
Nama host: `example.org` dan semua nama host lainnya berbeda dengan `example.net`	semua jalur	`org-site`	Nama host tidak ada dalam aturan host mana pun untuk peta URL, sehingga permintaan diarahkan ke layanan backend default peta URL.
Nama host: `example.net`	`/video` `/video/examples`	`video-site`	Permintaan ditujukan ke layanan backend default karena tidak ada aturan jalur untuk `/video/` atau `/video/*`. Aturan host untuk `example.net` merujuk pada pencocok jalur, tetapi pencocok jalur tersebut tidak memiliki aturan jalur yang akan diterapkan pada jalur tersebut.
Nama host: `example.net`	`/video/hd` `/video/hd/movie1` `/video/hd/movies/movie2` URL lain yang diawali dengan `/video/hd/*`	`video-hd`	Aturan host untuk `example.net` mereferensikan pencocok jalur yang aturan jalurnya mengarahkan permintaan untuk jalur URL yang sama persis dengan `/video/hd` atau yang dimulai dengan `/video/hd/*` ke layanan backend `video-hd`.
Nama host: `example.net`	`/video/sd` `/video/sd/show1` `/video/sd/shows/show2` URL lain yang diawali dengan `/video/sd/*`	`video-sd`	Aturan host untuk `example.net` mereferensikan pencocok jalur yang aturan jalurnya mengarahkan permintaan untuk jalur URL yang sama persis dengan `/video/sd` atau yang dimulai dengan `/video/sd/*` ke layanan backend `video-sd`.

Pengalihan URL

Pengalihan URL mengalihkan pengunjung domain Anda dari satu URL ke URL lainnya.

Pengalihan URL default tidak disyaratkan untuk mencocokkan pola tertentu dalam permintaan masuk. Misalnya, Anda dapat menggunakan pengalihan URL default untuk mengalihkan nama host apa pun ke nama host pilihan Anda.

Ada beberapa cara untuk membuat pengalihan URL, seperti yang diuraikan dalam tabel berikut.

Metode	Konfigurasi
Pengalihan URL default peta URL	`defaultUrlRedirect` tingkat teratas
Pengalihan URL default pencocok jalur	`pathMatchers[].defaultUrlRedirect[]`
Pengalihan URL aturan jalur pencocok jalur	`pathMatchers[].pathRules[].urlRedirect`
Pengalihan URL aturan pencocok jalur	`pathMatchers[].routeRules[].urlRedirect`

Di dalam defaultUrlRedirect atau urlRedirect, pathRedirect selalu berfungsi sebagai berikut:

Seluruh jalur permintaan diganti dengan jalur yang Anda tentukan.

Di dalam defaultUrlRedirect atau urlRedirect, cara kerja prefixRedirect bergantung pada cara Anda menggunakannya:

Jika Anda menggunakan defaultUrlRedirect, prefixRedirect pada dasarnya adalah awalan yang ditambahkan karena jalur yang cocok selalu /.
Jika Anda menggunakan urlRedirect dalam aturan rute atau aturan jalur pencocok jalur, prefixRedirect adalah penggantian awalan berdasarkan cara pencocokan jalur yang diminta seperti yang ditentukan dalam aturan jalur atau aturan rute.

Contoh pengalihan

Tabel berikut memberikan beberapa contoh konfigurasi pengalihan. Kolom sebelah kanan menunjukkan konfigurasi API untuk pengalihan URL default.

Anda ingin	Dicapai menggunakan pengalihan URL default
Pengalihan HTTP-ke-HTTPS Pengalihan http://host.name/path ke https://host.name/path	kind: compute#urlMap name: web-map-http defaultUrlRedirect: httpsRedirect: True
HTTP-ke-HTTPS + Pengalihan Host Pengalihan http://nama-host-apa saja/path ke https://www.example.com/path	kind: compute#urlMap name: web-map-http defaultUrlRedirect: httpsRedirect: True hostRedirect: "www.example.com"
HTTP-ke-HTTPS + Pengalihan Host + Pengalihan jalur lengkap Pengalihan http://nama-host-apa saja/path ke https://www.example.com/newPath	kind: compute#urlMap name: web-map-http defaultUrlRedirect: httpsRedirect: True hostRedirect: "www.example.com" pathRedirect: "/newPath"
HTTP-to-HTTPS + Pengalihan Host + Pengalihan awalan Pengalihan http://any-host-name/originalPath ke https://www.example.com/newPrefix/originalPath	kind: compute#urlMap name: web-map-http defaultUrlRedirect: httpsRedirect: True hostRedirect: "www.example.com" prefixRedirect: "/newPrefix"

Cuplikan parsial berikut menganotasi setiap resource API:

defaultUrlRedirect:
   redirectResponseCode: MOVED_PERMANENTLY_DEFAULT
   httpsRedirect: True # True if you want https://, false if you want http://
   hostRedirect: "new-host-name.com" # Omit to keep the requested host
   pathRedirect: "/new-path" # Omit to keep the requested path; mutually exclusive to prefixRedirect
   prefixRedirect: "/newPrefix" # Omit to keep the requested path; mutually exclusive to pathRedirect
   stripQuery: False # True to omit everything in the URL after ?
   ...

Langkah selanjutnya

Untuk menambahkan, memvalidasi, menguji, mencantumkan, atau menghapus peta URL, lihat Menggunakan peta URL.
Untuk informasi tentang pemilihan rute peta aturan dengan Traffic Director, lihat Ringkasan peta aturan pemilihan rute Traffic Director.