Routen

Um eine Route mit dem zu erstellen AWS Management Console

1. Öffnen Sie die App Mesh Mesh-Konsole unter https://console.aws.amazon.com/appmesh/.

2. Wählen Sie das Mesh aus, in dem Sie die Route erstellen möchten. Alle Netze, die Sie besitzen und die mit Ihnen geteilt wurden, werden aufgelistet.

3. Wählen Sie im linken Navigationsbereich die Option Virtual routers (Virtuelle Router) aus.

4. Wählen Sie den virtuellen Router aus, dem Sie eine neue Route zuordnen möchten. Wenn keine aufgeführt sind, müssen Sie zuerst einen virtuellen Router erstellen.

5. Wählen Sie in der Tabelle Routes (Routen) die Option Create route (Route erstellen). Um eine Route zu erstellen, muss Ihre Konto-ID als Ressourcenbesitzer der Route aufgeführt sein.

6. Geben Sie unter Route name (Routen-Name) den Namen ein, der für Ihre Route verwendet werden soll.

7. Wählen Sie unter Routentyp das Protokoll aus, das Sie weiterleiten möchten. Das von Ihnen ausgewählte Protokoll muss mit dem Listener-Protokoll übereinstimmen, das Sie für Ihren virtuellen Router und den virtuellen Knoten ausgewählt haben, zu dem Sie den Datenverkehr weiterleiten.

8. (Optional) Geben Sie für Routenpriorität eine Priorität zwischen 0 und 1000 an, die für Ihre Route verwendet werden soll. Routen werden auf Grundlage des angegebenen Werts zugewiesen, wobei 0 die höchste Priorität darstellt.

9. (Optional) Wählen Sie Zusätzliche Konfiguration. Wählen Sie aus den unten aufgeführten Protokollen das Protokoll aus, das Sie als Routentyp ausgewählt haben, und geben Sie die gewünschten Einstellungen in der Konsole an.

10. Wählen Sie für die Zielkonfiguration den vorhandenen virtuellen App Mesh-Knoten aus, an den der Datenverkehr weitergeleitet werden soll, und geben Sie ein Gewicht an. Sie können Ziel hinzufügen wählen, um weitere Ziele hinzuzufügen. Der Prozentsatz für alle Ziele muss zusammen 100 ergeben. Wenn keine virtuellen Knoten aufgeführt sind, müssen Sie zuerst einen erstellen. Wenn der ausgewählte virtuelle Knoten über mehrere Listener verfügt, ist der Zielport erforderlich.

11. Geben Sie für die Match-Konfiguration Folgendes an:

    Die Match-Konfiguration ist nicht verfügbar für tcp

    • Wenn http/http2 der gewählte Typ ist:

      • (Optional) Methode ‐ gibt den Methodenheader an, der in den eingehenden http/http2-Anfragen abgeglichen werden soll.

      • (Optional) Port Match — Ordnet den Port für den eingehenden Verkehr zu. Eine Portübereinstimmung ist erforderlich, wenn dieser virtuelle Router über mehrere Listener verfügt.

      • (Optional) Prefix/Exact/RegexPfad — Methode zum Abgleichen des Pfads der URL.

        • Präfixabgleich — Eine übereinstimmende Anfrage einer Gateway-Route wird standardmäßig in den Namen des virtuellen Zieldienstes und das entsprechende Präfix / umgeschrieben. Je nachdem, wie Sie Ihren virtuellen Dienst konfigurieren, könnte dieser einen virtuellen Router verwenden, um die Anfrage anhand bestimmter Präfixe oder Header an verschiedene virtuelle Knoten weiterzuleiten.

          Anmerkung

          Wenn Sie den auf Pfad und Präfix basierenden Abgleich aktivieren, aktiviert App Mesh die Pfadnormalisierung (normalize_path und merge_slashes), um die Wahrscheinlichkeit von Pfadverwirrungsschwachstellen zu minimieren.

          Sicherheitslücken mit Pfadverwirrungen treten auf, wenn an der Anfrage beteiligte Parteien unterschiedliche Pfaddarstellungen verwenden.

        • Exakte Übereinstimmung — Der exakte Parameter deaktiviert den teilweisen Abgleich für eine Route und stellt sicher, dass die Route nur zurückgegeben wird, wenn der Pfad EXAKT mit der aktuellen URL übereinstimmt.

        • Regex-Übereinstimmung — wird verwendet, um Muster zu beschreiben, bei denen mehrere tatsächlich eine einzelne Seite auf der Website identifizieren URLs können.

      • (Optional) Abfrageparameter — in diesem Feld können Sie die Abfrageparameter abgleichen.

      • (Optional) Headers ‐ gibt die Header für http und http2 an. Es sollte mit der eingehenden Anfrage übereinstimmen, um an den virtuellen Zieldienst weitergeleitet zu werden.

    • Wenn grpc der gewählte Typ ist:

      • Dienstname — der Zieldienst, für den die Anfrage abgeglichen werden soll.

      • Methodenname — die Zielmethode, für die die Anfrage abgeglichen werden soll.

      • (Optional) Metadaten — gibt Match anhand des Vorhandenseins von Metadaten an. Alle müssen übereinstimmen, damit die Anfrage bearbeitet werden kann.

12. Wählen Sie Route erstellen aus.

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

2. Inhalt des Beispiels .json create-route-grpc

   {
       "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. Beispielausgabe:

   {
       "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"
       }
   }

Um eine Route mit dem zu löschen AWS Management Console

1. Öffnen Sie die App Mesh Mesh-Konsole unter https://console.aws.amazon.com/appmesh/.

2. Wählen Sie das Mesh aus, aus dem Sie eine Route löschen möchten. Alle Netze, die Sie besitzen und die mit Ihnen geteilt wurden, werden aufgelistet.

3. Wählen Sie im linken Navigationsbereich die Option Virtual routers (Virtuelle Router) aus.

4. Wählen Sie den Router aus, von dem Sie eine Route löschen möchten.

5. Wählen Sie in der Tabelle Routen die Route aus, die Sie löschen möchten, und wählen Sie in der oberen rechten Ecke Löschen aus.

6. Geben Sie in das Bestätigungsfeld ein delete und klicken Sie dann auf Löschen.

Um eine Route mit dem zu löschen AWS CLI

1. Verwenden Sie den folgenden Befehl, um Ihre Route zu löschen (ersetzen Sie die red Werte durch Ihre eigenen):

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

2. Beispielausgabe:

   {
       "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"
       }
   }