ゲートウェイパラメーターの変更 - Microservices Engine - Alibaba Cloud ドキュメントセンター

さまざまなシナリオに適応するために、クラウドネイティブゲートウェイのパラメーターを調整して、ネットワークのパフォーマンス、信頼性、およびセキュリティを向上させることができます。ただし、パラメーターの変更は、ネットワーク接続とアプリケーションの使用に悪影響を与える可能性があります。したがって、ゲートウェイパラメーターを変更する前に、変更可能なパラメーターの値の範囲と各値の意味を理解する必要があります。このトピックでは、ゲートウェイパラメーターを変更する方法と、パラメーターの詳細について説明します。

前提条件

クラウドネイティブゲートウェイが作成されていること。詳細については、「クラウドネイティブゲートウェイを作成する」をご参照ください。

手順

説明

ゲートウェイが安定して動作することを保証するために、マイクロサービスエンジン（MSE）コンソールに表示されているパラメーターを変更できます。 MSE コンソールに表示されていないパラメーターは変更できません。
MSE コンソールの [パラメーター設定] ページの [ゲートウェイエンジンパラメーター] セクションの [範囲] 列に基づいて、パラメーター値を変更する必要があります。

[MSE コンソール] にログインします。上部のナビゲーションバーで、リージョンを選択します。
左側のナビゲーションウィンドウで、Cloud-Native Gateway > ゲートウェイリスト を選択します。
ゲートウェイリスト ページで、ゲートウェイの名前をクリックします。
左側のナビゲーションウィンドウで、パラメーターの設定 をクリックします。 Gateway Engine Parameters セクションで、変更するパラメーターを見つけ、Actions 列の Edit をクリックします。 [パラメーターの変更] ダイアログボックスで、パラメーターの説明に基づいてパラメーターを変更し、OK をクリックします。

ゲートウェイエンジンパラメーター

パラメーター	データ型	値の範囲	デフォルト値	説明
EnableHttp2	bool	[true, false]	false	サーバーとクライアント間の通信に HTTP/2 を使用するかどうかを指定します。このパラメーターはリクエストに適用されます。 true: HTTP/2 が有効になります。 false: HTTP/2 が無効になります。
EnableGenerateRequestId	bool	[true, false]	true	リクエストトレースのためにリクエストヘッダーにリクエスト ID を生成するかどうかを指定します。リクエスト ID は X-Request-Id で指定されます。このパラメーターはリクエストに適用されます。 true: リクエストトレースのためにリクエストヘッダーにリクエスト ID が生成されます。 false: リクエストヘッダーにリクエスト ID は生成されません。
EnableGzip	bool	[true, false]	false	このパラメーターはリクエストとレスポンスに適用されます。 true: レスポンスは GZIP を使用して圧縮されます。圧縮はゲートウェイトラフィックの削減に役立ちますが、ゲートウェイの CPU 負荷を増加させます。 false: レスポンスは圧縮されずに直接返されます。
EnableSlashMerge	bool	[true, false]	false	リクエストから余分なスラッシュ（`/`）を削除するかどうかを指定します。このパラメーターはリクエストに適用されます。 true: リクエストから余分なスラッシュ（/）が削除されます。たとえば、`www.example.com//b` リクエストは使用可能です。 EnableSlashMerge を true に設定すると、リクエストから余分なスラッシュ（`/`）が削除され、リクエストは `www.example.com/b` に変更されます。 false: リクエストから余分なスラッシュ（`/`）は削除されません。
DownstreamIdleTime	integer	[0, 600]	15	リクエストが送信されない期間の制限です。指定された期間内にクライアントからゲートウェイへのリクエストがない場合、ゲートウェイ接続は切断されます。このパラメーターはゲートウェイ接続に適用されます。単位：秒。
PreserveHeaderFormat	bool	[true, false]	false	ヘッダーのすべての文字を小文字に変換するかどうかを指定します。リクエストとレスポンスの場合、HTTP/1.1 ヘッダーは大文字と小文字を区別しません。デフォルト値は false で、ヘッダーのすべての文字が小文字に変換されることを示します。この変換により、HTTP/1.1 ヘッダーと HTTP/2 ヘッダー間の互換性が保証されます。このパラメーターはリクエストとレスポンスに適用されます。 true: ヘッダーの文字は小文字に変換されません。 false: ヘッダーのすべての文字が小文字に変換されます。
DownstreamConnectionBufferLimits	integer	[0, 2147483647]	32768	ゲートウェイ接続の最大バッファーサイズ。このパラメーターを指定すると、スループットとゲートウェイメモリの使用に悪影響を及ぼします。このパラメーターはゲートウェイ接続に適用されます。単位：バイト。
EnableHardwareAccelerate	bool	[true, false]	true	ハードウェアアクセラレーションを有効にするかどうかを指定します。このパラメーターは、Transport Layer Security（TLS）の暗号化と復号に適用されます。クラウドネイティブゲートウェイが存在するリージョンでハードウェアアクセラレーションがサポートされていない場合、またはクラウドネイティブゲートウェイの購入時にハードウェアアクセラレーションが選択されていない場合、このパラメーターは有効になりません。 true: ハードウェアアクセラレーションが有効になります。 false: ハードウェアアクセラレーションが無効になります。説明基盤となるハードウェアの制限により、ハードウェアアクセラレーションは次のリージョンでサポートされています：中国（北京）、中国（杭州）、中国（上海）、中国（深圳）、シンガポール。
XffTrustedNum	integer	[0, 10]	0	ゲートウェイの信頼できるプロキシの数。このパラメーターはリクエストに適用され、ゲートウェイがクライアントによって生成されたリクエストヘッダーを使用するかどうかを決定します。リクエストヘッダーには、x-forwarded-for と x-request-id が含まれます。このパラメーターが 0 に設定されている場合、ピアソケット IP アドレスが実際の IP アドレスとして使用され、x-envoy-external-address リクエストヘッダーで指定されてバックエンドに渡されます。このパラメーターが 0 以外の値に設定されている場合、指定された数のホップが、ソケット IP アドレスがアタッチされている x-forwarded-for ヘッダーから右から左にスキップされます。この場合、実際の IP アドレスが取得されます。次に、実際の IP アドレスが x-envoy-external-address リクエストヘッダーで指定され、バックエンドに渡されます。クライアントによって渡される x-request-id および x-forwarded-proto ヘッダーは、変更なしでリクエストに残ります。
DownstreamHttp2MaxConcurrentStream	integer	[0, 2147483647]	100	クライアントが HTTP/2 を使用する場合の接続上の同時ストリームの最大数。このパラメーターはリクエストに適用されます。単位：バイト。
InitialStreamWindowSize	integer	[0, 2147483647]	65535	ゲートウェイが HTTP/2 を使用してクライアントとネゴシエートする場合のストリームの初期ウィンドウサイズ。このパラメーターはリクエストに適用されます。単位：バイト。
InitialConnectionWindowSize	integer	[0, 2147483647]	1048576	ゲートウェイが HTTP/2 を使用してクライアントとネゴシエートする場合の接続の初期ウィンドウサイズ。このパラメーターはリクエストに適用されます。単位：バイト。
EnableHttp3	bool	[true, false]	false	ダウンストリームノードがゲートウェイとネゴシエートするときに HTTP/3 を有効にするかどうかを指定します。このパラメーターはリクエストに適用されます。 true: HTTP/3 が有効になります。 false: HTTP/3 が無効になります。
UpstreamIdleTimeout	int	[0, 600]	30	タイムアウト期間。ゲートウェイが指定された期間内にアップストリームサーバーにリクエストを送信しない場合、ゲートウェイはアップストリームサーバーから切断されます。このパラメーターはゲートウェイ接続に適用されます。単位：秒。
PathWithEscapedSlashes	string	KEEP_UNCHANGED REJECT_REQUEST UNESCAPE_AND_REDIRECT UNESCAPE_AND_FORWARD	KEEP_UNCHANGED	URI（Uniform Resource Identifier）に %2F、%2f、%5C、%5c などのエスケープ文字が含まれるリクエストの転送ポリシー。 KEEP_UNCHANGED: リクエストは変更なしで転送されます。 REJECT_REQUEST: ゲートウェイはエラーコード 400 を返し、リクエストを拒否します。 UNESCAPE_AND_REDIRECT: エスケープ文字はエスケープ解除され、リクエストはリダイレクトされます。 UNESCAPE_AND_FORWARD: エスケープ文字はエスケープ解除され、リクエストはバックエンドサービスに転送されます。
ZipAlgorithm	List<string>	[brotli, gzip]	gzip	圧縮アルゴリズム。有効な値：brotli および gzip。このパラメーターに brotli と gzip の両方を選択し、Accept-Encoding パラメーターで gzip の q 値が brotli の q 値と同じである場合、リストの最初に来る圧縮アルゴリズムが有効になります。
EnableProxyProtocol	bool	[true, false]	false	Proxy プロトコルを有効にするかどうかを指定します。ネットワークロードバランサー（NLB）インスタンスがトラフィックのイングレスとしてデプロイされている場合、クライアントの実際の IP アドレスを取得するには、Proxy プロトコルを有効にする必要があります。 Proxy プロトコルを有効にした後、非 Proxy リクエストは悪影響を受けません。
EnableCustomAuthConfigPush	bool	[true, false]	false	カスタム認証サービスが利用可能なシナリオで使用されます。この機能を有効にすると、認証ルールが変更されても接続は切断されません。この機能は、WebSocket とオンラインビジネスが使用されるシナリオに適しています。
EnableXffTrustedCidrs	bool	[true, false]	false	ゲートウェイのフロントエンドプロキシサービス (WAF、CDN など) の信頼できる CIDR ブロックを構成するために使用されます。ゲートウェイは、XFF ヘッダーからクライアントの実際の IP アドレスを取得し、信頼できる CIDR ブロック内の IP アドレスをスキップできます。