Mengonfigurasi aturan pengalihan berbasis nama domain dan path untuk ALB - Server Load Balancer

Topik ini menjelaskan cara mengonfigurasi aturan pengalihan berbasis nama domain dan path untuk Pendengar Application Load Balancer (ALB), serta cara mengonfigurasi aturan lanjutan berbasis path untuk aksi menulis ulang dan Pengalihan.

Aturan pengalihan berdasarkan nama domain

Aturan berbasis nama domain mendukung pencocokan eksak, wildcard, dan ekspresi reguler. Untuk informasi selengkapnya tentang cara menambahkan aturan pengalihan, lihat Tambahkan aturan pengalihan.

Aturan nama domain	Deskripsi
Pencocokan eksak dan wildcard	Deskripsi Kecocokan tepat: Nama domain yang diminta harus sama dengan nama domain yang ditentukan. Kecocokan wildcard: Nama domain yang diminta harus cocok dengan pola wildcard dari nama domain yang ditentukan. Persyaratan Nama domain harus terdiri dari 3 hingga 128 karakter. Nama domain hanya boleh berisi huruf kapital, huruf kecil, angka, dan karakter khusus berikut: `.-?=~_+\^!$&\|()[]`. Anda dapat menggunakan tanda bintang (``) dan tanda tanya (`?`) sebagai karakter wildcard. Contoh Nama domain yang diminta: www.example.com Pencocokan eksak: Permintaan cocok jika Anda memasukkan `www.example.com`. Pencocokan wildcard: Permintaan cocok jika Anda memasukkan `.example.com` atau `www.example.`.
Kecocokan ekspresi reguler	Kondisi Kecocokan Nama domain yang diminta harus cocok dengan ekspresi reguler yang ditentukan. Persyaratan Nama domain harus terdiri dari 3 hingga 128 karakter. Nama domain hanya boleh berisi huruf, angka, dan karakter khusus berikut: `. - ? = ~ _ - + ^ * ! $ & \| ( ) [ ]`. Contoh Nama domain yang diminta: www.example.com Pencocokan tidak peka huruf besar/kecil: Ekspresi reguler `^www.example.com$` cocok dengan nama domain yang diminta.

Aturan pengalihan berbasis path

Aturan berbasis path mendukung pencocokan eksak, wildcard, dan ekspresi reguler. Untuk informasi selengkapnya tentang cara menambahkan aturan pengalihan, lihat Tambahkan aturan pengalihan.

Aturan Jalur	Deskripsi
Pencocokan eksak dan karakter wildcard	Aturan pencocokan Pencocokan eksak: Path permintaan harus identik dengan path yang dikonfigurasi. Pencocokan wildcard: Path permintaan harus sesuai dengan pola path yang dikonfigurasi. Persyaratan Path harus diawali dengan garis miring (`/`) dan hanya boleh berisi huruf, angka, serta karakter khusus berikut: `$-_.+/&~@:`. Tanda bintang (``) dan tanda tanya (`?`) dapat digunakan sebagai karakter wildcard. Contoh* Path permintaan: /example/text Pencocokan eksak: Permintaan cocok jika path dalam aturan pengalihan adalah `/example/text`. Pencocokan wildcard: Permintaan cocok jika path dalam aturan pengalihan adalah `/example/`. Catatan* Aturan pencocokan path untuk ALB berbeda dengan NGINX. ALB tidak mendukung aturan Pencocokan awalan terpanjang. Sebagai contoh, konfigurasi umum Nginx adalah `location /abc`, yang menggunakan metode pencocokan awalan terpanjang. ALB melakukan pencocokan awalan terpanjang menggunakan karakter wildcard. Pada ALB, Anda dapat mengonfigurasi `/abc/*` (kombinasi pencocokan eksak dan wildcard) untuk mencapai efek yang sama.
Kecocokan ekspresi reguler	Deskripsi Path yang diminta dicocokkan dengan ekspresi reguler yang ditentukan. Persyaratan Path hanya boleh berisi huruf kapital, huruf kecil, angka, dan karakter khusus berikut: `.-_/=?~^$:()[]+\|`. Contoh* Path yang diminta: `/sys/aaa/HOST` Peka huruf besar/kecil: Path cocok jika Anda memasukkan ekspresi reguler `^/sys/(.)/HOST$`. Tidak peka huruf besar/kecil: Path cocok jika Anda memasukkan ekspresi reguler `^/sys/(.)/host$`.

Aturan konfigurasi lanjutan untuk path dalam penulisan ulang dan pengalihan

Setelah Anda mengonfigurasi ekspresi reguler untuk path dalam kondisi pengalihan, Anda dapat menggunakan penggantian berbasis ekspresi reguler pada path dalam aksi menulis ulang dan Pengalihan. Untuk informasi selengkapnya tentang cara menambahkan aturan pengalihan, lihat Tambahkan aturan pengalihan.

Catatan

Untuk informasi tentang aturan konfigurasi ekspresi reguler path untuk kondisi pengalihan, lihat Aturan pengalihan berbasis path.

Catatan
- Jumlah pasangan tanda kurung ( ) dalam ekspresi reguler pada kondisi pengalihan harus sesuai dengan jumlah variabel `${n}` dalam path penulisan ulang atau pengalihan pada aksi pengalihan.
- Path penulisan ulang atau pengalihan dalam aksi pengalihan harus berisi satu atau beberapa variabel ${1}, ${2}, dan ${3}. Variabel-variabel ini tidak dapat diganti dengan karakter lain.

Prinsip penggantian

Pencocokan path: Klien mengirim permintaan yang cocok dengan ekspresi reguler dari aturan pengalihan berbasis path.
Ekstraksi dan penggantian: Berdasarkan spesifikasi ekspresi reguler, konten yang ditangkap oleh tiga pasangan tanda kurung pertama ( ) disimpan ke ${1}, ${2}, dan ${3} secara berurutan. Konten ini kemudian digunakan untuk menggantikan bagian dalam path penulisan ulang atau pengalihan pada aksi pengalihan.
Penggabungan: Berdasarkan konfigurasi path penulisan ulang atau pengalihan dalam aksi pengalihan, nilai-nilai ${1}, ${2}, dan ${3} digantikan untuk membentuk path akhir hasil penulisan ulang atau pengalihan.

No.	Langkah	Contoh
1	Konfigurasikan kondisi pengalihan dan aksi pengalihan dalam aturan pengalihan.	Path dalam kondisi pengalihan: `/sys/(.)/(.)/aaa` Path tujuan penulisan ulang atau pengalihan permintaan: `/${1}/${2}`
2	Permintaan klien cocok dengan jalur dalam aturan pengalihan.	Path permintaan: `/sys/ccc/bbb/aaa` Path yang cocok: `/sys/(.)/(.)/aaa`
3	Ambil dan ganti	Ekspresi reguler mengambil `ccc` dan `bbb` dari dua grup tangkapan `(.*)` dalam path. Nilai-nilai ini kemudian menggantikan variabel ${1} dan ${2} dalam path penulisan ulang atau pengalihan. `${1}` diganti dengan `ccc`. `${2}` diganti dengan `bbb`.
4	Penggabungan path	Path yang diterima oleh server backend: `/ccc/bbb`

Contoh konfigurasi

Anda dapat menambahkan aturan pengalihan di Konsol berdasarkan catatan dan prinsip penggantian di atas.

Contoh 1: Aksi pengalihan adalah Rewrite dan Forward

Contoh ini menunjukkan cara mengonfigurasi aturan pengalihan untuk menulis ulang permintaan dengan path sys/ccc/bbb/aaa menjadi /ccc/bbb lalu meneruskannya. Berikut adalah contoh konfigurasinya. Example 1

Kategori		Deskripsi
If All Of The Following Conditions Are Met	Pencocokan ekspresi reguler path	Kondisi Kecocokan Jalur yang diminta cocok dengan ekspresi reguler yang ditentukan. Persyaratan Ekspresi reguler hanya boleh berisi huruf, angka, dan karakter khusus berikut: `.-_/=?~^$:()[]+\|`. Contoh* Path yang diminta: `/sys/ccc/bbb/aaa` Peka huruf besar/kecil: Path cocok dengan ekspresi reguler `/sys/(.)/(.)/aaa`. Tidak peka huruf besar/kecil: Path cocok dengan ekspresi reguler `/sys/(.)/(.)/aaa`.
Forwarding Action	Tulis Ulang	Domain Name: `${host}` Path: `/${1}/${2}` Query: `${query}` Catatan Query adalah bagian URL yang mengikuti tanda tanya (?). Sebagai contoh, jika URL-nya adalah `www.example.com/test/test1?x=1`, maka Query-nya adalah `x=1`.
Forwarding Action	Forward to	Pilih kelompok server tujuan dari daftar kelompok server.

Contoh 2: Aksi pengalihan adalah Redirect

Contoh ini menunjukkan cara mengonfigurasi aturan pengalihan untuk mengalihkan permintaan dengan path sys/ccc/bbb/aaa ke /ccc/bbb. Berikut adalah contoh konfigurasinya:

Example 2

Kategori		Deskripsi
If All Of The Following Conditions Are Met	Pencocokan ekspresi reguler path	Kondisi Kecocokan Jalur yang diminta cocok dengan ekspresi reguler yang ditentukan. Persyaratan input Ekspresi reguler hanya boleh berisi huruf, angka, dan karakter khusus berikut: `.-_/=?~^$:()[]+\|`. Contoh* Path yang diminta: `/sys/ccc/bbb/aaa` Peka huruf besar/kecil: Path cocok jika ekspresi regulernya adalah `/sys/(.)/(.)/aaa`. Tidak peka huruf besar/kecil: Path cocok jika ekspresi regulernya adalah `/sys/(.)/(.)/aaa`.
Forwarding Action	Redirection	Protocol: `$protocol` Domain Name: `${host}` Port: `${port}` Path: `/${1}/${2}` Query: `${query}` Status Code: `301`

FAQ

Bagaimana cara mengonfigurasi aturan pengalihan di ALB untuk menghapus awalan path tertentu dan mendukung pencocokan path multilapis?

Untuk mengonfigurasi aturan pengalihan yang menghapus awalan tertentu dari path permintaan dan mencocokkan path multilapis berikutnya, gunakan contoh konfigurasi berikut:

Contoh: Saat ALB meneruskan permintaan akses untuk www.example.com/api/aaa/bbb/..., awalan /api harus dihapus dari path, dan path multilapis setelah /api harus dicocokkan.

Anda dapat menggunakan aksi menulis ulang atau pengalihan. Saat mengonfigurasi path, gunakan ekspresi reguler ^/api/(.*) untuk mencocokkan semua path yang diawali dengan /api. Kemudian, atur path dalam aksi pengalihan menjadi /${1}. Hal ini akan menggantikan path yang cocok dengan segala sesuatu yang mengikuti /api. Konfigurasi spesifiknya adalah sebagai berikut:

Rewrite
Redirect

Referensi

Untuk mengonfigurasi aturan pengalihan lainnya untuk Pendengar ALB, lihat Mengonfigurasi aturan pengalihan pendengar.