旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。

式を使用してルートを設定する方法

複雑または大規模な構成を扱う際、式を使用してルートを設定すると、 柔軟性とパフォーマンスが向上します。 このハウツーガイドでは、Expressionsルーターに切り替える方法と、新しい表現力豊かなドメイン固有言語でルートを設定する方法について説明します。 このガイドの残りの部分に進む前に 式言語リファレンスを理解しておきましょう。

前提条件

kong.confを編集してrouter_flavor = expressions行を追加し、 Kong Gatewayを再起動します。

注: 式を有効にした後も、ルートオブジェクトの従来の照合フィールド（paths や methods など）は引き続き設定できます。新しい expression フィールドで式を指定できます。ただし、これらを従来の一致フィールドと同時に構成することはできません。さらに、expression フィールドと組み合わせて使用する新しい priority フィールドでは、式ルートの評価順序を指定できます。

式を使用したルートの作成

式を使用して新しいルートオブジェクトを作成するには、サービスエンドポイントに POST リクエストを送信してください。

curl --request POST \
  --url http://localhost:8001/services/example-service/routes \
  --form-string expression='http.path == "/mock"'

この例では、既存のサービス example-service にパス /mock で新しいルートオブジェクトを関連付けました。 表現式 DSL を使用すると、複雑なルーターの一致条件を作成することもできます。

curl --request POST \
  --url http://localhost:8001/services/example-service/routes \
  --header 'Content-Type: multipart/form-data' \
  --form-string 'expression=(http.path == "/mock" || net.protocol == "https")'

式を使用して複雑なルートを作成

POSTリクエスト内で演算子を使用して複雑なルートオブジェクトを記述できます。

curl --request POST \
  --url http://localhost:8001/services/example-service/routes \
  --header 'Content-Type: multipart/form-data' \
  --form-string name=complex_object \
  --form-string 'expression=(net.protocol == "http" || net.protocol == "https") &&
                (http.method == "GET" || http.method == "POST") &&
                (http.host == "example.com" || http.host == "example.test") &&
                (http.path ^= "/mock" || http.path ^= "/mocking") &&
                http.headers.x_another_header == "example_header" && (http.headers.x_my_header == "example" || http.headers.x_my_header == "example2")'

一般的なユースケースとそれら向けの式ルートの記述方法については、式言語の概要ページを参照してください。

利用可能なすべての言語機能のリストについては、表現言語リファレンスを参照してください。

マッチングフィールド

次の表では、式ベースのルーターを使用する場合に使用可能な照合フィールドと、それに関連するタイプについて説明しています。

その他の情報

• 式言語に関する参考資料
• Expressionsルーターエンジンのリポジトリ