Server Load Balancer:Konfigurasikan aturan AScript

Ikhtisar AScript

AScript adalah fitur skrip yang dapat diprogram di ALB. Fitur ini mencakup variabel bawaan, pernyataan kondisional, dan pustaka fungsi untuk menulis logika pengalihan kustom. Kasus penggunaan umum meliputi:

• Otentikasi kustom: Terapkan Perlindungan hotlink berdasarkan parameter permintaan, cookie, atau algoritma kustom, atau konfigurasikan daftar blokir User-Agent, daftar izin Referer, dan lainnya.

• Buat daftar blokir dan daftar izin berbasis IP untuk mengontrol akses.

• Ubah variabel seperti parameter permintaan dan header permintaan.

• Penulisan ulang URL dan pengalihan: Menulis ulang URI dan ekstensi file, atau mengalihkan permintaan secara kondisional ke alamat berbeda dengan kode status 302.

Untuk informasi lebih lanjut tentang sintaksis AScript dan variabel bawaan, lihat Referensi Sintaksis dan Variabel AScript. Lihat Kasus Penggunaan AScript untuk contohnya.

Cara kerja

Aturan AScript, seperti aturan pengalihan standar, digunakan untuk memproses permintaan ALB. Saat permintaan klien mencapai listener ALB, ALB memprosesnya sesuai dengan aturan pengalihan yang dikonfigurasi. Anda dapat menjalankan aturan AScript sebelum atau setelah aturan pengalihan standar diproses.

AScript dirancang untuk beroperasi berdasarkan masing-masing listener, sehingga memungkinkan Anda mengisolasi logika bisnis yang berbeda ke dalam aturan terpisah. Anda dapat menjalankan setiap aturan pada salah satu titik eksekusi berikut:

• Sebelum/setelah eksekusi aturan pengalihan inbound: Umumnya digunakan untuk skenario seperti penggantian nama file otomatis, mengubah ekstensi file menjadi huruf kecil, menambahkan awalan URI, dan menulis ulang ekstensi file.

• Sebelum eksekusi aturan pengalihan outbound: Umumnya digunakan untuk skenario seperti penggantian nama file otomatis.

Tambahkan aturan AScript

Uji aturan AScript Anda pada listener non-produksi terlebih dahulu. Setelah memastikan lalu lintas dialihkan dengan benar, terapkan aturan tersebut ke listener produksi Anda.

1. Masuk ke halaman Instances di Konsol ALB, lalu klik ID instans target.

2. Pada tab Listener, klik ID listener target. Klik tab Forwarding Rules. Klik Inbound Forwarding Rules atau Outbound Forwarding Rules, lalu klik Add Script Before Forwarding Rule Is Applied atau Add Script After Forwarding Rule Is Applied.

   Saat Anda memilih Outbound Forwarding Rules, Anda hanya dapat memilih Add Script Before Forwarding Rule Is Applied.

3. Pada halaman Add Script, konfigurasikan parameter berikut lalu klik OK.

   • Rule Name: Masukkan nama aturan kustom.

   • Script Code: Masukkan kode skrip, atau klik Code Template untuk memilih templat skenario. Lihat Kasus Penggunaan AScript untuk contohnya.

   • Run Script At: Titik eksekusi skrip. Nilai ini ditentukan oleh lokasi tempat Anda menambahkan skrip dan tidak dapat diubah.

   • Status: Menentukan apakah aturan diaktifkan.

   • Advanced Settings (Opsional): Jika permintaan mencakup parameter _es_dbg dan nilainya cocok dengan kunci yang ditentukan di sini, ALB akan mengaktifkan header respons debug untuk mengeluarkan catatan eksekusi aturan. Header respons debug mencakup bidang-bidang berikut:

     • Rule ID: Pengidentifikasi unik untuk aturan, dalam format as-****.

     • Kode status eksekusi dan deskripsi:

       Execution status code	Description
       Empty	Not executed.
       0	Executed and matched. Terjadi ketika aturan berisi blok if condition {} dan condition bernilai true.
       1	Executed but not matched. Terjadi ketika aturan berisi blok if condition {} dan condition bernilai false, atau ketika aturan tidak berisi blok if condition {}.
       2	Execution exception.

     • Execution duration: Waktu eksekusi dalam mikrodetik (µs). Nilai default-nya adalah -1.

     • Interrupted execution: Menunjukkan apakah eksekusi skrip terganggu. Nilai default-nya adalah -1.

Kelola aturan AScript

Pada tab Forwarding Rule, Anda dapat melakukan operasi berikut pada aturan AScript:

• Klik sakelar di samping ID aturan untuk mengaktifkan atau menonaktifkan aturan.

• Klik Modify di pojok kanan atas kartu AScript untuk mengubah konfigurasi aturan.

• Klik Delete di pojok kanan atas kartu AScript, lalu klik OK pada kotak dialog.

Penagihan

Aturan AScript berkontribusi terhadap jumlah evaluasi aturan, yaitu metrik yang digunakan untuk penagihan Loadbalancer Capacity Unit (LCU). Untuk informasi lebih lanjut, lihat Penagihan ALB.