Serverless App Engine:ALB ゲートウェイルーティングのベストプラクティス

パスの構成

転送条件でパスの正規表現を構成した後、転送操作のパスは正規表現の置き換えをサポートします。転送ルールの追加方法については、「アプリケーション ( ALB ) のルーティング規則の構成」をご参照ください。

• 注意事項

  • 転送条件の正規表現のかっこ () の数は、転送操作の書き換えられたパスにある $variables の数と一致する必要があります。

  • 転送操作の書き換えられたパスには、${1}、${2}、${3} のいずれか 1 つ以上が含まれている必要があり、これらの 3 つの変数を他の文字に置き換えることはできません。

• 置き換えの原則

  1. URL の一致: クライアントがリクエストを送信し、リクエストが転送ルールで指定された正規表現と一致します。

  2. 抽出と置き換え: 正規表現の標準に従って、最初の 3 つのペアのかっこ () から抽出された内容は、転送操作の書き換えられたパスで置き換えるために、それぞれ ${1}、${2}、${3} に保存されます。

  3. 連結: 転送操作の書き換えられたパスの構成に従って、${1}、${2}、${3} の値を置き換え、最終的にそれらを連結して実際に書き換えられたパスにします。

  番号	手順	例
  1	転送ルールで転送条件と転送操作を構成します。	転送条件のパス: /sys/(.*)/(.*)/aaa 転送操作の書き換えパス: /${1}/${2}
  2	クライアントリクエストが転送ルールのパスと一致します。	クライアントリクエストのパス: /sys/ccc/bbb/aaa 一致した転送条件のパス: /sys/(.*)/(.*)/aaa
  3	抽出と置き換え。	正規表現の標準に従って、転送条件のパスにある 2 つの (.*) は、それぞれ ccc と bbb を抽出し、転送操作の書き換えられたパスにある ${1} と ${2} に格納します。 ${1} は ccc に置き換えられます ${2} は bbb に置き換えられます
  4	パスの連結。	バックエンドサーバーが受信したパス: /ccc/bbb

クエリの構成

クエリの内容とは、URL の疑問符の後の部分を指します。リダイレクトされたクエリがデフォルトの ${query} の場合、元のクエリパラメーターで動的に置き換えられます。

例:

クライアントが URL www.example.com/test/test1?x=1 にアクセスする場合、クエリの内容は x=1 です。

プロトコルの概要

• HTTP リスナーは、HTTP リクエストを別の HTTP リスナーまたは HTTPS リスナーにリダイレクトすることをサポートしています。

• HTTPS リスナーは、HTTPS リクエストを別の HTTPS リスナーにリダイレクトすることをサポートしています。

ドメイン名の概要

転送操作のドメイン名の構成は、転送条件と同じです。具体的な構成については、「ドメイン名の構成」をご参照ください。

アクセス ポートの概要

対応するプロトコルのリスニング ポートを構成します。たとえば、HTTP リクエスト (アクセス ポート: 80 ) が HTTPS (アクセス ポート: 443 ) にリダイレクトされる場合です。

パスの概要

転送条件でパスの正規表現を構成した後、転送操作のパスは正規表現の置き換えをサポートします。転送ルールの追加方法については、「アプリケーション ( ALB ) のルーティング規則の構成」をご参照ください。

• 注意事項

  • 転送条件の正規表現のかっこ () の数は、転送操作のリダイレクトされたパスにある $variables の数と一致する必要があります。

  • 転送操作のリダイレクトされたパスには、${1}、${2}、${3} のいずれか 1 つ以上が含まれている必要があり、これらの 3 つの変数を他の文字に置き換えることはできません。

• 置き換えの原則

  1. URL の一致: クライアントがリクエストを送信し、リクエストが転送ルールで指定された正規表現と一致します。

  2. 抽出と置き換え: 正規表現の標準に従って、最初の 3 つのペアのかっこ () から抽出された内容は、転送操作のリダイレクトされたパスで置き換えるために、それぞれ ${1}、${2}、${3} に保存されます。

  3. 連結: 転送操作のリダイレクトされたパスの構成に従って、${1}、${2}、${3} の値を置き換え、最終的にそれらを連結して実際に書き換えられたパスにします。

  番号	手順	例
  1	転送ルールで転送条件と転送操作を構成します。	転送条件パス: /sys/(.*)/(.*)/aaa 転送操作リダイレクトパス: /${1}/${2}
  2	クライアント リクエストは、転送ルール内のパスと一致します。	クライアント リクエスト パス: /sys/ccc/bbb/aaa 一致した転送条件パス: /sys/(.*)/(.*)/aaa
  3	抽出と置換。	正規表現の標準に従って、転送条件パス内の 2 つの (.*) は、それぞれ ccc と bbb を抽出し、転送操作のリダイレクトパスにある ${1} と ${2} に格納します。 ${1} は ccc に置き換えられます ${2} は bbb に置き換えられます
  4	パスの連結。	バックエンドサーバーが受信したパス: /ccc/bbb

クエリの概要

クエリコンテンツとは、URL の疑問符の後の部分を指します。リダイレクトされたクエリがデフォルトの ${query} である場合、元の リクエスト の クエリパラメータ で動的に置き換えられることを意味します。

例:

クライアントが www.example.com/test/test1?x=1 という URL にアクセスする場合、クエリ内容は x=1 です。

状態コードの概要

ALB リダイレクトのデフォルト HTTP ステータスコードは 301 です。必要に応じて HTTP ステータスコードを指定できます。次の表に、ALB でサポートされている HTTP ステータスコードを示します。