Menggunakan peta URL

Panduan ini menunjukkan cara mengonfigurasi peta URL. Trusted CloudPeta URL adalah sekumpulan aturan untuk merutekan permintaan HTTP(S) yang masuk ke layanan backendtertentu. Peta URL minimal mencocokkan semua jalur permintaan masuk (/*).

Sebelum mengikuti panduan ini, pahami konsep peta URL.

Peta URL digunakan dengan produk Trusted Cloud berikut:

Peta URL yang digunakan dengan Load Balancer Aplikasi eksternal regional dan Load Balancer Aplikasi internal regional juga mendukung beberapa fitur pengelolaan traffic lanjutan. Untuk mengetahui informasi selengkapnya, lihat Konsep peta URL: Pengelolaan traffic lanjutan.

Default peta URL

Peta URL memiliki dua default, seperti yang dijelaskan dalam tabel berikut.

Jenis default Setelan Arti
Default peta URL gcloud compute url-maps create

--default-service

 Layanan backend default yang ditentukan digunakan jika tidak ada pencocok jalur atau aturan host yang cocok dengan URL masuk.
Default pencocok jalur gcloud compute url-maps add-path-matcher

--default-service

 Layanan backend default yang ditentukan digunakan jika jalur URL cocok dengan pencocok jalur, tetapi tidak ada --path-rules yang cocok.

Aturan host

Aturan host menentukan sekumpulan host yang akan dicocokkan dengan permintaan.

Dalam aturan host, nama host harus berupa nama domain yang sepenuhnya memenuhi syarat (FQDN). Nama host tidak boleh berupa alamat IPv4 atau IPv6. Contoh:

  • Karya: example.com
  • Karya: web.example.com
  • Karya: *.example.com
  • Tidak berfungsi: 35.244.221.250

Mengonfigurasi peta URL

Peta URL dapat mengirim traffic ke layanan backend.

Konsol

Untuk menambahkan peta URL menggunakan konsol Trusted Cloud , lakukan langkah-langkah berikut:

  1. Buka halaman Load balancing.

    Buka Load balancing

  2. Klik Name load balancer.
  3. Di halaman Load Balancer Details, klik Edit untuk load balancer yang dipilih.
  4. Pilih Host and path rules.
  5. Klik Tambahkan aturan host dan jalur.

  6. Isi kolom Host, kolom Paths, atau keduanya, lalu pilih backend service.

    1. Masukkan Nama host yang sepenuhnya memenuhi syarat, misalnya web.example.com.
    2. Masukkan jalur—misalnya, /video.
    3. Di halaman Host and path rules, pada menu Backends, pilih layanan backendyang tersedia.

  7. Cari tanda centang biru di sebelah kiri Host and Path Rules, lalu klik tombol Update.

gcloud

Untuk menambahkan peta URL menggunakan Google Cloud CLI, gunakan perintah url-maps create:

gcloud compute url-maps create URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   [--description DESCRIPTION] \
   [--region=REGION]

Untuk Load Balancer Aplikasi eksternal regional dan Load Balancer Aplikasi internal, pastikan untuk menyertakan flag --region saat Anda membuat peta URL.

Untuk membuat pencocok jalur, gunakan perintah gcloud compute url-maps add-path-matcher:

gcloud compute url-maps add-path-matcher URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   --path-matcher-name PATH_MATCHER \
   [--path-rules="PATH=SERVICE"]

Perintah ini memerlukan layanan backend default yang dapat mengirim permintaan yang tidak cocok. Tanda --path-rules menentukan pemetaan antara jalur permintaan dan layanan backend. Contoh berikut merutekan jalur permintaan /video/ dan /video/* ke layanan backend video-service:

--path-rules="/video=video-service,/video/*=video-service"

Untuk membuat aturan host, gunakan perintah gcloud compute url-maps add-host-rule:

gcloud compute url-maps add-host-rule URL_MAP_NAME \
    --hosts=[HOSTS] --path-matcher-name=PATH_MATCHER

Misalnya, nilai --hosts berikut cocok dengan permintaan terhadap www.example.com dan subdomain altostrat.com:

--hosts=[*.altostrat.com,www.example.com]

Untuk mengubah layanan default peta URL, gunakan perintah url-maps set-default-service:

gcloud compute url-maps set-default-service URL_MAP_NAME
  (--default-service=DEFAULT_SERVICE)[GCLOUD_WIDE_FLAG ...]

Terraform

Untuk membuat peta URL regional, gunakan resource google_compute_region_url_map. 

resource "google_compute_region_url_map" "default" {
  name            = "regional-l7-xlb-map"
  region          = "us-west1"
  default_service = google_compute_region_backend_service.default.id
}

Membuat daftar peta URL

Konsol

Anda tidak dapat mencantumkan semua peta URL di konsol Trusted Cloud .

gcloud

Untuk menampilkan daftar peta URL menggunakan Google Cloud CLI, gunakan perintah url-maps list.

gcloud compute url-maps list

Mendapatkan informasi tentang peta URL

Konsol

Untuk mendapatkan informasi tentang peta URL, lakukan langkah-langkah berikut:

  1. Buka halaman Load balancing.

    Buka Load balancing

  2. Klik Name load balancer.
  3. Di halaman Load Balancer Details, klik Edit untuk load balancer yang dipilih.
  4. Lihat Host and path rules.

gcloud

Untuk mendapatkan informasi tentang satu peta URL menggunakan Google Cloud CLI, gunakan perintah url-maps describe.

gcloud compute url-maps describe URL_MAP_NAME

Menghapus peta URL

Anda dapat menghapus peta URL hanya setelah menghapus semua proxy target yang mereferensikannya. Untuk mengetahui informasi selengkapnya, lihat Menghapus proxy target.

Konsol

Untuk menghapus peta URL, lakukan langkah-langkah berikut:

  1. Buka halaman Load balancing.

    Buka Load balancing

  2. Klik Name load balancer.
  3. Di halaman Load Balancer Details, klik Edit untuk load balancer yang dipilih.
  4. Di halaman Load Balancer Details, lihat Host and path rules.
  5. Klik "X" di sebelah kanan peta URL untuk menghapusnya. Peta URL akan hilang.
  6. Cari tanda centang biru di sebelah kiri Host and Path Rules, lalu klik tombol Update.

gcloud

Untuk menghapus peta URL menggunakan Google Cloud CLI, gunakan perintah url-maps delete. Sebelum Anda dapat menghapus peta URL, semua proxy HTTP target yang mereferensikan peta URL harus dihapus terlebih dahulu.

gcloud compute url-maps delete URL_MAP_NAME [--quiet]

Menghapus pencocok jalur

Konsol

Untuk menghapus pencocok jalur, lakukan langkah-langkah berikut:

  1. Buka halaman Load balancing.

    Buka Load balancing

  2. Klik Name load balancer.
  3. Di halaman Load Balancer Details, klik Edit untuk load balancer yang dipilih.
  4. Pilih Host and path rules.
  5. Di kolom Paths untuk peta URL yang ada, klik "x" pada nama pencocok jalur.
  6. Cari tanda centang biru di sebelah kiri Host and Path Rules, lalu klik tombol Update.

gcloud

Untuk menghapus pencocok jalur, gunakan perintah gcloud compute url-maps remove-path-matcher:

gcloud compute url-maps remove-path-matcher URL_MAP_NAME \
   [--path-matcher-name PATH_MATCHER]

Menghapus aturan host

Konsol

Untuk menghapus aturan host, lakukan langkah-langkah berikut:

  1. Jika Anda belum berada di halaman Host and path rules, buka halaman Load balancing.

    Buka Load balancing

  2. Klik Name load balancer.
  3. Di halaman Load Balancer Details, klik Edit untuk load balancer yang dipilih.
  4. Pilih Host and path rules.
  5. Di kolom Host untuk peta URL yang ada, klik "x" pada nama host.
  6. Cari tanda centang biru di sebelah kiri Host and Path Rules, lalu klik tombol Update.

gcloud

Untuk menghapus aturan host dari peta URL, gunakan perintah gcloud compute url-maps remove-host-rule:

gcloud compute url-maps remove-host-rule URL_MAP_NAME --host=HOST

Misalnya, untuk menghapus aturan host yang berisi host altostrat.com dari peta URL bernama my-map, Anda akan menjalankan perintah berikut:

gcloud compute url-maps remove-host-rule my-map --host altostrat.com

Panduan pengelolaan traffic

Tidak semua fitur peta URL tersedia untuk semua produk. Peta URL digunakan dengan load balancer untuk mendukung beberapa fitur pengelolaan traffic lanjutan.

Gunakan tabel berikut untuk mempelajari fitur peta URL untuk karya pengelolaan.

Produk Fitur peta URL dan panduan pengelolaan traffic
Load Balancer Aplikasi eksternal regional Fitur load balancer: Perutean dan pengelolaan traffic

Ringkasan pengelolaan traffic

Menyiapkan pengelolaan traffic

Menyiapkan pengalihan URL

Menyiapkan pengalihan HTTP-ke-HTTPS

Nama host dan jalur

Meminta pemilihan rute

Cookie
Load Balancer Aplikasi Internal Fitur load balancer: Perutean dan pengelolaan traffic

Ringkasan pengelolaan traffic

Menyiapkan pengelolaan traffic

Menyiapkan pengalihan URL

Menyiapkan pengalihan HTTP-ke-HTTPS

Cookie

Nama host dan jalur

Referensi API dan gcloud CLI

Selain konsol Trusted Cloud , Anda dapat menggunakan API dan gcloud CLI untuk membuat peta URL.

API

Untuk mengetahui deskripsi properti dan metode yang tersedia bagi Anda saat bekerja dengan peta URL melalui REST API, lihat bagian berikut:

Produk Dokumentasi API
Load Balancer Aplikasi Eksternal urlMaps
Load Balancer Aplikasi Internal regionUrlMaps

gcloud CLI

Untuk Google Cloud CLI di Google Cloud CLI, lihat berikut ini:

  • Regional: --region=[REGION]

Untuk pengelolaan traffic lanjutan, gunakan file YAML dan impor dengan perintah gcloud compute url-maps import.

Langkah berikutnya