ルート

を使用してルートを作成するには AWS Management Console

1. で App Mesh コンソールを開きますhttps://console.aws.amazon.com/appmesh/。

2. ルートを作成するメッシュを選択します。所有しているメッシュや、共有されているメッシュがすべて一覧表示されます。

3. 左側のナビゲーションで [仮想ルーター] を選択します。

4. 新しいルートを関連付ける仮想ルーターを選択します。一覧に表示されていない場合は、最初に仮想ルーターを作成する必要があります。

5. [ルート] テーブルで [ルートを作成] を選択します。ルートを作成するには、アカウント ID は、ルートのリソース所有者として一覧表示されている必要があります。

6. [ルート名] に、ルートに使用する名前を指定します。

7. ルートタイプで、ルーティングするプロトコルを選択します。選択したプロトコルは、仮想ルーターとトラフィックをルーティングする仮想ノードで選択したリスナープロトコルと一致する必要があります。

8. (オプション)ルート優先度で、ルートに使用する優先度を0～1000の範囲で指定します。ルートは、指定された値に基づいて一致させます。ここで、0 は最も高い優先順位になります。

9. (オプション) [追加設定] を選択します。下のプロトコルの中から、ルートタイプ で選択したプロトコルを選択し、コンソールで必要な設定を行います。

10. ターゲットの設定で、トラフィックをルーティングする既存の App Mesh 仮想ノードを選択し、重みを指定します。ターゲットの追加を選択して、ターゲットを追加します。すべてのターゲットのパーセンテージは 100 まで加算する必要があります。仮想ノードが一覧表示されていない場合は、最初に作成する必要があります。選択した仮想ノードに複数のリスナーがある場合は、ターゲットポートが必要です。

11. 一致の設定では、次を指定します。

    一致の設定では、tcp の利用はできない

    • http/http2が、選択されたタイプの場合：

      • (オプション)メソッド‐着信したhttp/http2リクエストに一致させるメソッドヘッダーを指定します。

      • (オプション) [ポートの一致] - 受信トラフィックのポートを照合します。この仮想ルーターに複数のリスナーがある場合は、ポートを一致させる必要があります。

      • （オプション) プレフィックス/Exact/Regex パス - のパスに一致する方法URL。

        • プレフィックスの一致‐デフォルトでは、ゲートウェイルートによって一致したリクエストがターゲット仮想サービスの名前に書き換えられ、一致したプレフィックスが書き換えられます/ 仮想サービスの設定によっては、仮想ルーターを使用して、特定のプレフィックスやヘッダーに基づき、異なる仮想ノードにリクエストをルーティングすることができます。

          注記

          パス/プレフィックスに基づいた一致を有効にすると、App Mesh はパスの正規化 (normalize_path と merge_slashes) を有効にし、パス混同の脆弱性が発生する確率を最小化します。

          パス混乱の脆弱性は、リクエストに参加している当事者が異なるパス表現を使用する場合に発生します。

        • 完全一致 - 正確なパラメータは、ルートの部分一致を無効にし、パスが現在の URL EXACTと一致する場合にのみルートを返します。

        • 正規表現一致 - 複数の がウェブサイト上の 1 つのページを実際に特定URLsするパターンを記述するために使用されます。

      • (オプション) クエリパラメータ - このフィールドでは、クエリパラメータで一致を行うことができます。

      • (オプション)ヘッダー‐httpとhttp2のヘッダを指定します。受信したリクエストに一致させて、対象の仮想サービスにルーティングする必要があります。

    • gRPCが選択されている場合：

      • サービス名‐リクエストを一致させる宛先サービス。

      • メソッド名‐リクエストを一致させるデスティネーションメソッド。

      • (オプション) メタデータ ‐ メタデータの存在に基づいた Match を指定します。リクエストを処理するには、すべてが一致する必要があります。

12. [ルートを作成] を選択します。

1. aws appmesh create-route \
        --cli-input-json file://create-route-grpc.json

2. サンプル create-route-grpc.json の内容

   {
       "meshName" : "meshName",
       "routeName" : "routeName",
       "spec" : {
          "grpcRoute" : {
             "action" : {
                "weightedTargets" : [
                   {
                      "virtualNode" : "nodeName",
                      "weight" : 100
                   }
                ]
             },
             "match" : {
                "metadata" : [
                   {
                      "invert" : false,
                      "match" : {
                         "prefix" : "123"
                      },
                      "name" : "myMetadata"
                   }
                ],
                "methodName" : "nameOfmethod",
                "serviceName" : "serviceA.svc.cluster.local"
             },
             "retryPolicy" : {
                "grpcRetryEvents" : [ "deadline-exceeded" ],
                "httpRetryEvents" : [ "server-error", "gateway-error" ],
                "maxRetries" : 3,
                "perRetryTimeout" : {
                   "unit" : "s",
                   "value" : 15
                },
                "tcpRetryEvents" : [ "connection-error" ]
             }
          },
          "priority" : 100
       },
       "virtualRouterName" : "routerName"
   }

3. 出力例:

   {
       "route": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName/route/routeName",
               "createdAt": "2022-04-06T13:48:20.749000-05:00",
               "lastUpdatedAt": "2022-04-06T13:48:20.749000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "routeName": "routeName",
           "spec": {
               "grpcRoute": {
                   "action": {
                       "weightedTargets": [
                           {
                               "virtualNode": "nodeName",
                               "weight": 100
                           }
                       ]
                   },
                   "match": {
                       "metadata": [
                           {
                               "invert": false,
                               "match": {
                                   "prefix": "123"
                               },
                               "name": "myMetadata"
                           }
                       ],
                       "methodName": "nameOfMehod",
                       "serviceName": "serviceA.svc.cluster.local"
                   },
                   "retryPolicy": {
   "grpcRetryEvents": [
                           "deadline-exceeded"
                       ],
                       "httpRetryEvents": [
                           "server-error",
                           "gateway-error"
                       ],
                       "maxRetries": 3,
                       "perRetryTimeout": {
                           "unit": "s",
                           "value": 15
                       },
                       "tcpRetryEvents": [
                           "connection-error"
                       ]
                   }
               },
               "priority": 100
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualRouterName": "routerName"
       }
   }

を使用してルートを削除するには AWS Management Console

1. で App Mesh コンソールを開きますhttps://console.aws.amazon.com/appmesh/。

2. ルートを削除するメッシュを選択します。所有しているメッシュや、共有されているメッシュがすべて一覧表示されます。

3. 左側のナビゲーションで [仮想ルーター] を選択します。

4. ルートを削除するルーターを選択します。

5. [ルート] テーブルで、削除するルートを選択し、右上隅の [削除]を選択します。

6. 確認ボックスで、「delete」と入力し、[削除] をクリックします。

を使用してルートを削除するには AWS CLI

1. 次のコマンドを使用してルートを削除します ( red 独自の値):

   aws appmesh delete-route \
        --mesh-name meshName \
        --virtual-router-name routerName \
        --route-name routeName

2. 出力例:

   {
       "route": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName/route/routeName",
               "createdAt": "2022-04-06T13:46:54.750000-05:00",
               "lastUpdatedAt": "2022-04-07T10:43:57.152000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "routeName": "routeName",
           "spec": {
               "grpcRoute": {
                   "action": {
                       "weightedTargets": [
                           {
                               "virtualNode": "nodeName",
                               "weight": 100
                           }
                       ]
                   },
                   "match": {
                       "metadata": [
                           {
                               "invert": false,
                               "match": {
                                   "prefix": "123"
                               },
                               "name": "myMetadata"
                           }
                       ],
                       "methodName": "methodName",
                       "serviceName": "serviceA.svc.cluster.local"
                   },
                   "retryPolicy": {
                       "grpcRetryEvents": [
                           "deadline-exceeded"
                       ],
                       "httpRetryEvents": [
                           "server-error",
                           "gateway-error"
                       ],
                       "maxRetries": 3,
                       "perRetryTimeout": {
                           "unit": "s",
                           "value": 15
                       },
                       "tcpRetryEvents": [
                           "connection-error"
                       ]
                   }
               },
               "priority": 100
           },
           "status": {
               "status": "DELETED"
           },
           "virtualRouterName": "routerName"
       }
   }