全部产品
Search
文档中心

Microservices Engine:Buat rute

更新时间:Jul 06, 2025

Ketika gateway cloud-native menerima permintaan akses, gateway mencocokkan permintaan dengan rute satu per satu berdasarkan prioritas aturan routing dalam urutan menurun. Jika permintaan cocok dengan rute, permintaan tersebut diarahkan ke layanan tujuan. Jika tidak ada kecocokan, kode kesalahan 404 dikembalikan.

Prioritas pencocokan rute

Jika terdapat beberapa aturan routing, prioritas diurutkan sebagai berikut dari tertinggi hingga terendah: associated domain name > path > request header > request parameters > creation time.

  1. Tentukan prioritas rute berdasarkan domain name. Semakin panjang string nama domain suatu rute, semakin tinggi prioritasnya.

  2. Tentukan prioritas rute berdasarkan path dalam skenario berikut:

    • Jika path matching rules dari beberapa rute berbeda, prioritas diurutkan berdasarkan kondisi berikut dari tertinggi hingga terendah: Equal To > Prefix > Regular Expression Match.

    • Jika path matching rules dari beberapa rute sama, semakin panjang string path, semakin tinggi prioritasnya.

  3. Tentukan prioritas rute berdasarkan jumlah total pasangan kunci-nilai dalam request header. Semakin besar jumlah total pasangan kunci-nilai dalam header permintaan, semakin tinggi prioritasnya.

  4. Tentukan prioritas rute berdasarkan jumlah total pasangan kunci-nilai dalam request parameters. Semakin besar jumlah total pasangan kunci-nilai dalam parameter permintaan, semakin tinggi prioritasnya.

  5. Tentukan prioritas rute berdasarkan waktu pembuatan. Semakin awal waktu pembuatan suatu rute, semakin tinggi prioritasnya.

Prosedur

Catatan

Konfigurasi rute mendukung HTTPs, termasuk HTTP 1.0, HTTP 1.1, HTTP 2.0, gPRC, dan WebSocket.

  1. Masuk ke Konsol MSE. Di bilah navigasi atas, pilih wilayah.

  2. Di panel navigasi sisi kiri, pilih Cloud-native Gateway > Gateways. Pada halaman Gateways, klik ID gateway.

  3. Di panel navigasi sisi kiri, klik tab Routes. Pada tab Routes, klik Add Route.

  4. Pada halaman Add Route, konfigurasikan parameter dan klik Save.

    Catatan
    • Rute cocok ketika semua kondisi dalam aturan routing terpenuhi. Jika Anda menentukan lebih banyak kondisi, lebih sedikit permintaan yang dapat cocok.

    • Permintaan cocok dengan rute berdasarkan urutan yang ditampilkan pada halaman Routes.

    Parameter

    Deskripsi

    Route Name

    Nama rute yang ingin Anda buat. Anda bisa mengklik Add Description dan memasukkan deskripsi untuk rute di bidang Route Description.

    Domain name

    Pilih satu atau lebih nama domain yang ingin Anda cocokkan untuk rute tersebut.

    Jika Anda ingin membuat nama domain, klik Add Domain Name di bawah daftar drop-down Nama Domain, dan konfigurasikan parameter untuk membuat nama domain di panel Tambah Nama Domain.

    Match Rule

    Path

    Parameter Path dalam permintaan HTTP yang ingin Anda teruskan dalam rute.

    • Jika aturan pencocokan path dari beberapa rute sama, semakin panjang nilai Path suatu rute, semakin tinggi prioritas rute tersebut.

    • Jika aturan pencocokan path dari beberapa rute berbeda, prioritas rute diurutkan berdasarkan kondisi berikut dari yang tertinggi hingga terendah: Equal To > Prefix > Regular Expression Match.

      • Equal To: Path lengkap digunakan untuk mencocokkan permintaan dengan rute. Sebagai contoh, Anda dapat mengatur parameter Path menjadi /user.

      • Prefix: Awalan path digunakan untuk mencocokkan permintaan dengan rute. Sebagai contoh, Anda dapat menentukan awalan sebagai /user.

      • Pencocokan Ekspresi Reguler: Ekspresi reguler digunakan untuk mencocokkan permintaan dengan rute.

    Method

    Parameter Metode yang digunakan untuk mencocokkan permintaan HTTP dengan rute. Anda dapat menentukan beberapa nilai untuk parameter Metode untuk mencocokkan lebih banyak permintaan dengan rute. Secara default, ANY dipilih.

    Header

    Parameter Header yang digunakan untuk mencocokkan permintaan HTTP dengan rute. Jika beberapa rute memiliki kondisi pencocokan yang sama kecuali jumlah parameter Header yang ditentukan, rute yang memiliki jumlah parameter Header lebih besar dalam aturan memiliki prioritas lebih tinggi.

    Query Parameters

    Parameter Query yang digunakan untuk mencocokkan permintaan HTTP dengan rute. Jika beberapa rute memiliki kondisi pencocokan yang sama kecuali jumlah parameter Query yang ditentukan, rute yang memiliki jumlah parameter Query lebih besar dalam aturan memiliki prioritas lebih tinggi.

    Scenario

    Pilih jenis layanan tujuan untuk rute tersebut.

    • Skenario Dasar: Single Service

    • Skenario Peluncuran Canary: Multiple Services dan Tag-based Routing

    • Skenario Lainnya: Mock dan Redirect.

    Untuk informasi lebih lanjut tentang jenis layanan tujuan, lihat Mode Routing.

    Catatan

    Jumlah persentase lalu lintas dari layanan tujuan yang Anda konfigurasikan bobotnya harus 100%.

    Backend Service

    Pilih layanan backend terkait dan port.

    Catatan
    • Anda dapat memilih Associate Service dari daftar drop-down Nama Layanan dan memilih sumber dan layanan di panel Asosiasi Layanan.

    • Jumlah sumber yang dapat ditambahkan bervariasi berdasarkan jenis sumber.

      • Jika Jenis Sumber diatur ke Container Service, maksimal lima sumber dapat ditambahkan.

      • Jika Jenis Sumber diatur ke MSE Nacos atau MSE Zookeeper, hanya satu sumber yang dapat ditambahkan.

      • Jika Jenis Sumber diatur ke EDAS Built-in Registry atau SAE Built-in Registry, jumlah sumber yang tidak terbatas dapat ditambahkan.

    Fallback

    Tentukan layanan fallback berdasarkan kebutuhan bisnis Anda. Jika tidak ada node yang tersedia untuk layanan backend ke mana rute menunjuk, permintaan asli mengakses layanan fallback yang Anda tentukan.

    Catatan

    Hanya kemampuan fallback antara layanan HTTP yang didukung.

    Timeout Period (s)

    Masukkan periode timeout. Nilai default adalah 60. Jika Anda mengatur nilainya menjadi 0, tidak akan ada timeout.

    Number of Retries (times)

    Masukkan jumlah percobaan ulang. Nilai default adalah 2. Jika Anda mengatur nilai ini menjadi 0, percobaan ulang tidak diizinkan.

    Retry Condition

    Pilih kondisi percobaan ulang.

    Retry Status Code

    Tambahkan satu atau lebih kode status percobaan ulang.

Referensi

Anda dapat memodifikasi aturan routing kapan saja sesuai kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Modifikasi aturan routing.