Memodifikasi parameter gateway - Microservices Engine

Untuk menyesuaikan dengan berbagai skenario, Anda dapat menyesuaikan parameter gateway cloud-native guna meningkatkan performa, keandalan, dan keamanan jaringan. Namun, modifikasi parameter ini mungkin berdampak negatif pada koneksi jaringan dan penggunaan aplikasi. Oleh karena itu, sebelum memodifikasi parameter gateway, pelajari rentang nilai yang dapat dimodifikasi serta arti dari setiap nilai. Topik ini menjelaskan cara memodifikasi parameter gateway dan memberikan detail terkait parameter tersebut.

Prasyarat

Sebuah gateway cloud-native telah dibuat. Untuk informasi lebih lanjut, lihat Membuat Gateway Cloud-Native.

Prosedur

Catatan

Untuk memastikan stabilitas gateway, Anda hanya dapat memodifikasi parameter yang ditampilkan di konsol Microservices Engine (MSE). Parameter yang tidak ditampilkan di konsol MSE tidak dapat dimodifikasi.
Anda harus mengubah nilai parameter sesuai dengan kolom Rentang di bagian Parameter Mesin Gateway pada halaman Pengaturan Parameter di konsol MSE.

Masuk ke konsol MSE. Di bilah navigasi atas, pilih wilayah.
Di panel navigasi sisi kiri, pilih Cloud-native Gateway > Gateways.
Di halaman Gateways, klik ID gateway.
Di panel navigasi sisi kiri, klik Parameter Settings. Di bagian Gateway Engine Parameters, temukan parameter yang ingin dimodifikasi, lalu klik Edit di kolom Actions. Di kotak dialog Modifikasi Parameter, ubah nilai sesuai deskripsi parameter, lalu klik OK.

Parameter mesin gateway

Parameter	Tipe data	Rentang nilai	Nilai default	Deskripsi
EnableHttp2	bool	[true, false]	false	Menentukan apakah akan menggunakan HTTP/2 untuk komunikasi antara server dan klien. Parameter ini berlaku untuk permintaan. true: HTTP/2 diaktifkan. false: HTTP/2 dinonaktifkan.
EnableGenerateRequestId	bool	[true, false]	true	Menentukan apakah akan menghasilkan ID permintaan di header permintaan untuk pelacakan permintaan. ID permintaan ditentukan oleh X-Request-Id. Parameter ini berlaku untuk permintaan. true: ID permintaan dihasilkan di header permintaan untuk pelacakan permintaan. false: ID permintaan tidak dihasilkan di header permintaan.
EnableGzip	bool	[true, false]	false	Parameter ini berlaku untuk permintaan dan respons. true: Respons dikompres menggunakan GZIP. Kompresi membantu mengurangi lalu lintas gateway tetapi meningkatkan beban CPU gateway. false: Respons langsung dikembalikan tanpa dikompres.
EnableSlashMerge	bool	[true, false]	false	Menentukan apakah akan menghapus garis miring tambahan (`/`) dari permintaan. Parameter ini berlaku untuk permintaan. true: Garis miring tambahan (/) dihapus dari permintaan. Contohnya, permintaan `www.example.com//b` tersedia. Jika Anda mengatur EnableSlashMerge ke true, garis miring tambahan (`/`) dihapus dari permintaan dan permintaan berubah menjadi `www.example.com/b`. false: Garis miring tambahan (`/`) tidak dihapus dari permintaan.
DownstreamIdleTime	integer	[0, 600]	15	Batas periode waktu di mana tidak ada permintaan yang dikirim. Jika tidak ada permintaan dari klien ke gateway dalam periode waktu tertentu, koneksi gateway diputus. Parameter ini berlaku untuk koneksi gateway. Satuan: detik.
PreserveHeaderFormat	bool	[true, false]	false	Menentukan apakah akan mengonversi semua huruf header menjadi huruf kecil. Untuk permintaan dan respons, header HTTP/1.1 tidak peka huruf besar-kecil. Nilai default adalah false, yang menunjukkan bahwa semua huruf header dikonversi menjadi huruf kecil. Konversi ini memastikan kompatibilitas antara header HTTP/1.1 dan HTTP/2. Parameter ini berlaku untuk permintaan dan respons. true: Huruf header tidak dikonversi menjadi huruf kecil. false: Semua huruf header dikonversi menjadi huruf kecil.
DownstreamConnectionBufferLimits	integer	[0, 2147483647]	32768	Ukuran buffer maksimum koneksi gateway. Jika Anda menentukan parameter ini, throughput dan penggunaan memori gateway terpengaruh secara negatif. Parameter ini berlaku untuk koneksi gateway. Satuan: byte.
EnableHardwareAccelerate	bool	[true, false]	true	Menentukan apakah akan mengaktifkan akselerasi perangkat keras. Parameter ini berlaku untuk enkripsi dan dekripsi Transport Layer Security (TLS). Jika akselerasi perangkat keras tidak didukung di wilayah tempat gateway cloud-native Anda berada atau jika akselerasi perangkat keras tidak dipilih saat Anda membeli gateway cloud-native Anda, parameter ini tidak dapat berlaku. true: Akselerasi perangkat keras diaktifkan. false: Akselerasi perangkat keras dinonaktifkan. Catatan Karena keterbatasan perangkat keras bawah, akselerasi perangkat keras didukung di wilayah berikut: Tiongkok (Beijing), Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Shenzhen), dan Singapura.
XffTrustedNum	integer	[0, 10]	0	Jumlah proxy tepercaya dari gateway. Parameter ini berlaku untuk permintaan dan menentukan apakah gateway menggunakan header permintaan yang dihasilkan oleh klien. Header permintaan termasuk x-forwarded-for dan x-request-id. Jika parameter ini diatur ke 0, alamat IP soket peer digunakan sebagai alamat IP asli dan ditentukan di header permintaan x-envoy-external-address untuk diteruskan ke backend. Jika parameter ini diatur ke nilai selain 0, jumlah hop yang ditentukan dilewati dari kanan ke kiri dari header x-forwarded-for ke mana alamat IP soket dilampirkan. Dalam hal ini, alamat IP asli diambil. Kemudian, alamat IP asli ditentukan di header permintaan x-envoy-external-address dan diteruskan ke backend. Header x-request-id dan x-forwarded-proto yang diteruskan oleh klien tetap ada di permintaan tanpa modifikasi apa pun.
DownstreamHttp2MaxConcurrentStream	integer	[0, 2147483647]	100	Jumlah maksimum aliran bersamaan pada koneksi ketika klien menggunakan HTTP/2. Parameter ini berlaku untuk permintaan. Satuan: byte.
InitialStreamWindowSize	integer	[0, 2147483647]	65535	Ukuran jendela awal aliran ketika gateway bernegosiasi dengan klien menggunakan HTTP/2. Parameter ini berlaku untuk permintaan. Satuan: byte.
InitialConnectionWindowSize	integer	[0, 2147483647]	1048576	Ukuran jendela awal koneksi ketika gateway bernegosiasi dengan klien menggunakan HTTP/2. Parameter ini berlaku untuk permintaan. Satuan: byte.
EnableHttp3	bool	[true, false]	false	Menentukan apakah akan mengaktifkan HTTP/3 ketika node downstream bernegosiasi dengan gateway. Parameter ini berlaku untuk permintaan. true: HTTP/3 diaktifkan. false: HTTP/3 dinonaktifkan.
UpstreamIdleTimeout	int	[0, 600]	30	Periode timeout. Jika gateway tidak mengirimkan permintaan apa pun ke server upstream dalam periode waktu tertentu, gateway memutuskan koneksi dari server upstream. Parameter ini berlaku untuk koneksi gateway. Satuan: detik.
PathWithEscapedSlashes	string	KEEP_UNCHANGED REJECT_REQUEST UNESCAPE_AND_REDIRECT UNESCAPE_AND_FORWARD	KEEP_UNCHANGED	Kebijakan penerusan permintaan yang Uniform Resource Identifier (URI)-nya berisi karakter escape, seperti %2F, %2f, %5C, atau %5c. KEEP_UNCHANGED: Permintaan diteruskan tanpa perubahan apa pun. REJECT_REQUEST: Gateway mengembalikan kode kesalahan 400 dan menolak permintaan. UNESCAPE_AND_REDIRECT: Karakter escape di-unescaped, dan permintaan dialihkan. UNESCAPE_AND_FORWARD: Karakter escape di-unescaped, dan permintaan diteruskan ke layanan backend.
ZipAlgorithm	List<string>	[brotli, gzip]	gzip	Algoritma kompresi. Nilai valid: brotli dan gzip. Jika Anda memilih brotli dan gzip untuk parameter ini, dan nilai q untuk gzip sama dengan nilai q untuk brotli di parameter Accept-Encoding, algoritma kompresi yang pertama kali muncul dalam daftar yang berlaku.
EnableProxyProtocol	bool	[true, false]	false	Menentukan apakah akan mengaktifkan protokol Proxy. Jika instance Network Load Balancer (NLB) ditempatkan sebagai ingress untuk lalu lintas, Anda harus mengaktifkan protokol Proxy untuk mendapatkan alamat IP asli klien. Setelah Anda mengaktifkan protokol Proxy, permintaan non-Proxy tidak terpengaruh secara negatif.
EnableCustomAuthConfigPush	bool	[true, false]	false	Digunakan dalam skenario di mana layanan otentikasi kustom tersedia. Setelah fitur ini diaktifkan, koneksi tidak diputus jika aturan otentikasi berubah. Fitur ini cocok untuk skenario di mana WebSocket dan bisnis online digunakan.
EnableXffTrustedCidrs	bool	[true, false]	false	Digunakan untuk mengonfigurasi blok CIDR tepercaya layanan proxy frontend, seperti WAF dan CDN, untuk gateway. Gateway dapat memperoleh alamat IP asli klien dari header XFF dan melewati alamat IP di blok CIDR tepercaya.