Gateway-Routen

Um eine Gateway-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 Gateway-Route erstellen möchten. Alle Meshes, die Sie besitzen und die mit Ihnen geteilt wurden, werden aufgelistet.

3. Wählen Sie in der linken Navigationsleiste Virtuelle Gateways aus.

4. Wählen Sie das virtuelle Gateway aus, dem Sie eine neue Gateway-Route zuordnen möchten. Wenn keine aufgeführt sind, müssen Sie zuerst ein virtuelles Gateway erstellen. Sie können nur eine Gateway-Route für ein virtuelles Gateway erstellen, für das Ihr Konto als Ressourcenbesitzer aufgeführt ist.

5. Wählen Sie in der Tabelle Gateway-Routen die Option Gateway-Route erstellen aus.

6. Geben Sie unter Gateway-Routenname den Namen an, der für Ihre Gateway-Route verwendet werden soll.

7. Wählen Sie als Gateway-Routentyp entweder http, http2 oder grpc aus.

8. Wählen Sie einen vorhandenen virtuellen Dienstnamen aus. Wenn keine aufgeführt sind, müssen Sie zuerst einen virtuellen Dienst erstellen.

9. Wählen Sie den Port aus, der dem Ziel für den Port eines virtuellen Dienstanbieters entspricht. Der Port eines virtuellen Dienstanbieters ist erforderlich, wenn der Anbieter (Router oder Knoten) des ausgewählten virtuellen Dienstes über mehrere Listener verfügt.

10. (Optional) Geben Sie unter Priorität die Priorität für diese Gateway-Route an.

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

    • 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 dieses virtuelle Gateway über mehrere Listener verfügt.

      • (Optional) Exact/Suffix hostname ‐ Gibt den Hostnamen an, der in der eingehenden Anfrage für die Weiterleitung zum virtuellen Zieldienst abgeglichen werden soll.

      • (Optional) Prefix/Exact/RegexPfad — Die Methode, mit der der Pfad der URL abgeglichen wird.

        • Präfix-Abgleich — Eine übereinstimmende Anfrage von einer Gateway-Route wird standardmäßig in den Namen des virtuellen Zieldienstes und in 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.

          Wichtig

          • Sie können /aws-appmesh* weder noch /aws-app-mesh* für Präfix Match angeben. Diese Präfixe sind für die future interne Verwendung von App Mesh reserviert.

          • Wenn mehrere Gateway-Routen definiert sind, wird eine Anfrage der Route mit dem längsten Präfix zugeordnet. Wenn beispielsweise zwei Gateway-Routen existieren, von denen eine das Präfix von /chapter und eine das Präfix von hat/, dann www.example.com/chapter/ würde eine Anfrage für der Gateway-Route mit dem /chapter Präfix zugeordnet.

          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 genaue 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. Sie sollte der eingehenden Anfrage entsprechen, um sie an den virtuellen Zieldienst weiterzuleiten.

    • Wenn grpc der gewählte Typ ist:

      • Hostnamen-Match-Typ und (optional) Exact/Suffix match ‐ Gibt den Hostnamen an, der in der eingehenden Anfrage für die Weiterleitung zum virtuellen Zieldienst abgeglichen werden soll.

      • grpc-Servicename ‐ Der grpc-Service fungiert als API für Ihre Anwendung und ist mit definiert. ProtoBuf

        Wichtig

        Sie können /aws.app-mesh* oder nicht aws.appmesh für den Dienstnamen angeben. Diese Dienstnamen sind für den future internen Gebrauch von App Mesh reserviert.

      • (Optional) Metadaten — Gibt die Metadaten für grpc an. Sie sollte der eingehenden Anfrage entsprechen, um sie an den virtuellen Zieldienst weiterzuleiten.

12. (Optional) Für die Rewrite-Konfiguration:

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

      • Wenn Präfix der gewählte Übereinstimmungstyp ist:

        • Automatisches Umschreiben des Hostnamens außer Kraft setzen ‐ Standardmäßig wird der Hostname in den Namen des virtuellen Zieldienstes umgeschrieben.

        • Automatisches Umschreiben des Präfixes außer Kraft setzen — Wenn diese Option aktiviert ist, gibt Prefix Rewrite den Wert des umgeschriebenen Präfixes an.

      • Wenn Exakter Pfad der gewählte Übereinstimmungstyp ist:

        • Automatisches Umschreiben des Hostnamens außer Kraft setzen — standardmäßig wird der Hostname in den Namen des virtuellen Zieldienstes umgeschrieben.

        • Path Rewrite ‐ Gibt den Wert des umgeschriebenen Pfads an. Kein Standardpfad.

      • Wenn Regex-Pfad der gewählte Übereinstimmungstyp ist:

        • Automatisches Umschreiben des Hostnamens außer Kraft setzen — standardmäßig wird der Hostname in den Namen des virtuellen Zieldienstes umgeschrieben.

        • Path Rewrite ‐ Gibt den Wert des umgeschriebenen Pfads an. Kein Standardpfad.

    • Wenn grpc der gewählte Typ ist:

      • Automatisches Umschreiben des Hostnamens außer Kraft setzen ‐ Standardmäßig wird der Hostname in den Namen des virtuellen Zieldienstes umgeschrieben.

13. Wählen Sie zum Abschluss die Option Gateway-Route erstellen.

1. aws appmesh create-virtual-gateway \ 
   --mesh-name meshName \ 
   --virtual-gateway-name virtualGatewayName \
   --gateway-route-name gatewayRouteName \ 
   --cli-input-json file://create-gateway-route.json

2. Inhalt des Beispiels create-gateway-route .json:

   {
       "spec": {
           "httpRoute" : {
               "match" : {
                   "prefix" : "/"
               },
               "action" : {
                   "target" : {
                       "virtualService": {
                           "virtualServiceName": "serviceA.svc.cluster.local"
                       }
                   }
               }
           }
       }
   }

3. Beispielausgabe:

   {
       "gatewayRoute": {
           "gatewayRouteName": "gatewayRouteName",
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualGateway/virtualGatewayName/gatewayRoute/gatewayRouteName",
               "createdAt": "2022-04-06T11:05:32.100000-05:00",
               "lastUpdatedAt": "2022-04-06T11:05:32.100000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "httpRoute": {
                   "action": {
                       "target": {
                           "virtualService": {
                               "virtualServiceName": "serviceA.svc.cluster.local"
                           }
                       }
                   },
                   "match": {
                       "prefix": "/"
                   }
               }
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualGatewayName": "gatewayName"
       }
   }
   

Um eine Gateway-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 Gateway-Route löschen möchten. Alle Meshes, die Sie besitzen und die mit Ihnen geteilt wurden, werden aufgelistet.

3. Wählen Sie in der linken Navigationsleiste Virtuelle Gateways aus.

4. Wählen Sie das virtuelle Gateway aus, von dem Sie eine Gateway-Route löschen möchten.

5. Wählen Sie in der Tabelle Gateway-Routen die Gateway-Route aus, die Sie löschen möchten, und wählen Sie Löschen aus. Sie können eine Gateway-Route nur löschen, wenn Ihr Konto als Ressourcenbesitzer aufgeführt ist.

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

Um eine Gateway-Route mit dem zu löschen AWS CLI

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

   aws appmesh delete-gateway-route \
        --mesh-name meshName \
        --virtual-gateway-name virtualGatewayName \
        --gateway-route-name gatewayRouteName

2. Beispielausgabe:

   {
       "gatewayRoute": {
           "gatewayRouteName": "gatewayRouteName",
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualGateway/virtualGatewayName/gatewayRoute/gatewayRouteName",
               "createdAt": "2022-04-06T11:05:32.100000-05:00",
               "lastUpdatedAt": "2022-04-07T10:36:33.191000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "httpRoute": {
                   "action": {
                       "target": {
                           "virtualService": {
                               "virtualServiceName": "serviceA.svc.cluster.local"
                           }
                       }
                   },
                   "match": {
                       "prefix": "/"
                   }
               }
           },
           "status": {
               "status": "DELETED"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }