Routen

Wichtig

Hinweis zum Ende des Supports: Am 30. September 2026 AWS wird der Support für eingestellt. AWS App Mesh Nach dem 30. September 2026 können Sie nicht mehr auf die AWS App Mesh Konsole oder die Ressourcen zugreifen. AWS App Mesh Weitere Informationen finden Sie in diesem Blogbeitrag Migration von AWS App Mesh zu Amazon ECS Service Connect.

Eine Route ist einem virtuellen Router zugeordnet. Die Route wird verwendet, um Anfragen für den virtuellen Router abzugleichen und den Verkehr an die zugehörigen virtuellen Knoten zu verteilen. Wenn eine Route mit einer Anfrage übereinstimmt, kann sie den Verkehr auf einen oder mehrere virtuelle Zielknoten verteilen. Sie können für jeden virtuellen Knoten eine relative Gewichtung angeben. Dieses Thema hilft Ihnen bei der Arbeit mit Routen in einem Service Mesh.

Eine Route erstellen

AWS Management Console

Um eine Route mit dem zu erstellen AWS Management Console

Öffnen Sie die App Mesh Mesh-Konsole unter https://console.aws.amazon.com/appmesh/.
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.
Wählen Sie im linken Navigationsbereich die Option Virtual routers (Virtuelle Router) aus.
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.
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.
Geben Sie unter Route name (Routen-Name) den Namen ein, der für Ihre Route verwendet werden soll.
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.
(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.
(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.
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.
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.
Wählen Sie Route erstellen aus.

AWS CLI

Um eine Route mit dem zu erstellen AWS CLI.

Erstellen Sie eine gRPC-Route mit dem folgenden Befehl und geben Sie JSON ein (ersetzen Sie die red Werte durch Ihre eigenen):


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

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

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

Weitere Informationen zum Erstellen einer Route mit dem AWS CLI for App Mesh finden Sie unter dem Befehl create-route in der AWS CLI Referenz.

(Optional) Abgleichen

(Optional) Geben Sie den Dienstnamen des Zieldienstes ein, der der Anfrage entspricht. Wenn Sie keinen Namen angeben, werden Anfragen an einen beliebigen Dienst zugeordnet.
(Optional) Geben Sie den Methodennamen der Zielmethode ein, die der Anfrage entspricht. Wenn Sie keinen Namen angeben, werden Anfragen an jede Methode abgeglichen. Wenn Sie einen Methodennamen angeben, müssen Sie einen Dienstnamen angeben.

(Optional) Metadaten

Wählen Sie Metadaten hinzufügen aus.

(Optional) Geben Sie den Namen der Metadaten ein, auf deren Grundlage Sie weiterleiten möchten, wählen Sie einen Übereinstimmungstyp und geben Sie einen Übereinstimmungswert ein. Wenn Sie Invertieren wählen, entspricht das Gegenteil. Wenn Sie beispielsweise den MetadatennamenmyMetadata, den Übereinstimmungstyp Exakt und einen Übereinstimmungswert von 123 angeben und Invertieren auswählen, wird die Route für jede Anfrage abgeglichen, deren Metadatenname mit einem anderen Namen als beginnt. 123
(Optional) Wählen Sie Metadaten hinzufügen aus, um bis zu zehn Metadatenelemente hinzuzufügen.

(Optional) Richtlinie erneut versuchen

Eine Wiederholungsrichtlinie ermöglicht Clients, sich vor zeitweiligen Netzwerkausfällen oder zeitweiligen serverseitigen Ausfällen zu schützen. Eine Wiederholungsrichtlinie ist optional, wird aber empfohlen. Die Werte für das Wiederholungs-Timeout definieren das Timeout pro Wiederholungsversuch (einschließlich des ersten Versuchs). Wenn Sie keine Wiederholungsrichtlinie definieren, erstellt App Mesh möglicherweise automatisch eine Standardrichtlinie für jede Ihrer Routen. Weitere Informationen finden Sie unter Standardrichtlinie für die Wiederholung von Routen.

Geben Sie unter Timeout für Wiederholungsversuche die Anzahl der Einheiten für die Timeout-Dauer ein. Ein Wert ist erforderlich, wenn Sie ein Protokollwiederholungsereignis auswählen.
Wählen Sie für „Timeout-Einheit wiederholen“ eine Einheit aus. Ein Wert ist erforderlich, wenn Sie ein Protokollwiederholungsereignis auswählen.
Geben Sie unter Max. Wiederholungen die maximale Anzahl von Wiederholungsversuchen ein, wenn die Anfrage fehlschlägt. Ein Wert ist erforderlich, wenn Sie ein Protokollwiederholungsereignis auswählen. Wir empfehlen einen Wert von mindestens zwei.
Wählen Sie ein oder mehrere HTTP-Wiederholungsereignisse aus. Wir empfehlen, mindestens Stream-Error und Gateway-Error auszuwählen.
Wählen Sie ein TCP-Wiederholungsereignis aus.
Wählen Sie ein oder mehrere gRPC-Wiederholungsereignisse aus. Wir empfehlen, mindestens storniert und nicht verfügbar auszuwählen.

(Optional) Timeouts

Die Standardeinstellung ist 15 Sekunden. Wenn Sie eine Wiederholungsrichtlinie angegeben haben, sollte die Dauer, die Sie hier angeben, immer größer oder gleich der Wiederholungsdauer sein, multipliziert mit der maximalen Anzahl von Wiederholungen, die Sie in der Wiederholungsrichtlinie definiert haben, damit Ihre Wiederholungsrichtlinie abgeschlossen werden kann. Wenn Sie eine Dauer von mehr als 15 Sekunden angeben, stellen Sie sicher, dass das für den Listener eines beliebigen virtuellen Knotenziels angegebene Timeout ebenfalls größer als 15 Sekunden ist. Weitere Informationen finden Sie unter Virtuelle Knoten.
Durch einen Wert des Typs 0 wird der Timout deaktiviert.
Die maximale Zeit, während der die Route inaktiv sein kann.

(Optional) Übereinstimmung

Geben Sie das Präfix an, dem die Route entsprechen soll. Beispiel: Wenn der Name Ihres virtuellen Service service-b.local lautet und die Route Anforderungen service-b.local/metrics zuordnen soll, sollte das Präfix /metrics lauten. Geben Sie / Routen für den gesamten Verkehr an.
(Optional) Wählen Sie eine Methode aus.
(Optional) Wählen Sie ein Schema aus. Gilt nur für HTTP2 Routen.

(Optional) Kopfzeilen

(Optional) Wählen Sie Kopfzeile hinzufügen aus. Geben Sie den Namen der Kopfzeile ein, auf deren Grundlage Sie weiterleiten möchten, wählen Sie einen Übereinstimmungstyp und geben Sie einen Übereinstimmungswert ein. Wenn Sie Invertieren auswählen, entspricht dies dem Gegenteil. Wenn Sie beispielsweise einen Header clientRequestId mit dem Präfix von 123 angeben und Invertieren auswählen, wird die Route für jede Anfrage abgeglichen, deren Header mit etwas anderem als beginnt. 123
(Optional) Wählen Sie Header hinzufügen aus. Sie können bis zu zehn Header hinzufügen.

(Optional) Richtlinie erneut versuchen

Geben Sie unter Timeout für Wiederholungsversuche die Anzahl der Einheiten für die Timeout-Dauer ein. Ein Wert ist erforderlich, wenn Sie ein Protokollwiederholungsereignis auswählen.
Wählen Sie für „Timeout-Einheit wiederholen“ eine Einheit aus. Ein Wert ist erforderlich, wenn Sie ein Protokollwiederholungsereignis auswählen.
Geben Sie unter Max. Wiederholungen die maximale Anzahl von Wiederholungsversuchen ein, wenn die Anfrage fehlschlägt. Ein Wert ist erforderlich, wenn Sie ein Protokollwiederholungsereignis auswählen. Wir empfehlen einen Wert von mindestens zwei.
Wählen Sie ein oder mehrere HTTP-Wiederholungsereignisse aus. Wir empfehlen, mindestens Stream-Error und Gateway-Error auszuwählen.
Wählen Sie ein TCP-Wiederholungsereignis aus.

(Optional) Timeouts

Timeout für Anfragen — Die Standardeinstellung ist 15 Sekunden. Wenn Sie eine Wiederholungsrichtlinie angegeben haben, sollte die Dauer, die Sie hier angeben, immer größer oder gleich der Wiederholungsdauer sein, multipliziert mit der maximalen Anzahl von Wiederholungen, die Sie in der Wiederholungsrichtlinie definiert haben, damit Ihre Wiederholungsrichtlinie abgeschlossen werden kann.
Dauer im Leerlauf — Die Standardeinstellung ist 300 Sekunden.
Durch einen Wert des Typs 0 wird der Timout deaktiviert.

Anmerkung

Wenn Sie ein Timeout angeben, das über dem Standard liegt, stellen Sie sicher, dass das für den Listener für alle Teilnehmer des virtuellen Knotens angegebene Timeout ebenfalls höher als der Standard ist. Wenn Sie das Timeout jedoch auf einen Wert reduzieren, der unter dem Standardwert liegt, ist es optional, das Timeout an virtuellen Knoten zu aktualisieren. Weitere Informationen finden Sie unter Virtuelle Knoten.

(Optional) Timeouts

Dauer des Leerlaufs — Die Standardeinstellung ist 300 Sekunden.
Durch einen Wert des Typs 0 wird der Timout deaktiviert.

Eine Route löschen

AWS Management Console

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

Öffnen Sie die App Mesh Mesh-Konsole unter https://console.aws.amazon.com/appmesh/.
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.
Wählen Sie im linken Navigationsbereich die Option Virtual routers (Virtuelle Router) aus.
Wählen Sie den Router aus, von dem Sie eine Route löschen möchten.
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.
Geben Sie in das Bestätigungsfeld ein delete und klicken Sie dann auf Löschen.

AWS CLI

Um eine Route mit dem zu löschen AWS CLI

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

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

Weitere Informationen zum Löschen einer Route mit dem AWS CLI for App Mesh finden Sie unter dem Befehl delete-route in der Referenz. AWS CLI

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Virtuelle Router

Envoy