Route

Per creare un percorso utilizzando il AWS Management Console

1. Apri la console App Mesh all'indirizzo https://console.aws.amazon.com/appmesh/.

2. Scegli la mesh in cui vuoi creare il percorso. Sono elencate tutte le mesh che possiedi e che sono state condivise con te.

3. Nel riquadro di navigazione sinistro, scegliere Virtual routers (Router virtuali).

4. Scegli il router virtuale a cui desideri associare un nuovo percorso. Se non ne è elencato nessuno, devi prima creare un router virtuale.

5. Nella tabella Routes (Route), scegliere Create route (Crea route). Per creare un percorso, l'ID del tuo account deve essere indicato come proprietario della risorsa del percorso.

6. In Route name (Nome route), specificare il nome da utilizzare per la route.

7. Per Tipo di percorso, scegli il protocollo che desideri instradare. Il protocollo selezionato deve corrispondere al protocollo listener selezionato per il router virtuale e il nodo virtuale verso cui instradare il traffico.

8. (Facoltativo) Per la priorità del percorso, specifica una priorità compresa tra 0 e 1000 da utilizzare per il percorso. Le route vengono messe in corrispondenza in base al valore specificato, dove 0 è la priorità più alta.

9. (Facoltativo) Scegli Configurazione aggiuntiva. Dai protocolli in basso, scegli il protocollo selezionato per Tipo di percorso e specifica le impostazioni desiderate nella console.

10. Per la configurazione di Target, seleziona il nodo virtuale App Mesh esistente verso cui indirizzare il traffico e specifica un Weight. Puoi scegliere Aggiungi destinazione per aggiungere altre destinazioni. La percentuale per tutti gli obiettivi deve essere pari a 100. Se non è elencato alcun nodo virtuale, devi prima crearne uno. Se il nodo virtuale selezionato ha più listener, è richiesta la porta Target.

11. Per la configurazione Match, specifica:

    La configurazione Match non è disponibile per tcp

    • Se http/http2 è il tipo selezionato:

      • (Facoltativo) Metodo ‐ specifica l'intestazione del metodo da abbinare nelle richieste http/http2 in entrata.

      • (Facoltativo) Port match ‐ Corrisponde alla porta per il traffico in entrata. La corrispondenza delle porte è richiesta se questo router virtuale ha più listener.

      • (Facoltativo) Prefix/Exact/Regexpath ‐ metodo per abbinare il percorso dell'URL.

        • Prefix match ‐ una richiesta corrispondente proveniente da una route gateway viene riscritta nel nome del servizio virtuale di destinazione e il prefisso corrispondente viene riscritto in, per impostazione predefinita. / A seconda di come configuri il servizio virtuale, potrebbe utilizzare un router virtuale per indirizzare la richiesta a diversi nodi virtuali, in base a prefissi o intestazioni specifici.

          Nota

          Se abiliti la corrispondenza basata su Path /Prefix, App Mesh abilita la normalizzazione del percorso (normalize_path e merge_slashes) per ridurre al minimo la probabilità di vulnerabilità legate alla confusione dei percorsi.

          Le vulnerabilità legate alla confusione dei percorsi si verificano quando le parti che partecipano alla richiesta utilizzano rappresentazioni di percorso diverse.

        • Corrispondenza esatta: il parametro esatto disabilita la corrispondenza parziale per una rotta e si assicura che restituisca la rotta solo se il percorso corrisponde ESATTAMENTE all'URL corrente.

        • Regex match ‐ usato per descrivere modelli in cui più di uno URLs possono effettivamente identificare una singola pagina sul sito web.

      • (Facoltativo) Parametri di interrogazione ‐ questo campo consente di abbinare i parametri della query.

      • (Facoltativo) Headers ‐ specifica le intestazioni per http e http2. Deve corrispondere alla richiesta in entrata da indirizzare al servizio virtuale di destinazione.

    • Se grpc è il tipo selezionato:

      • Nome del servizio ‐ il servizio di destinazione per il quale abbinare la richiesta.

      • Nome del metodo ‐ il metodo di destinazione per il quale abbinare la richiesta.

      • (Facoltativo) Metadati ‐ specifica Match in base alla presenza di metadati. Affinché la richiesta venga elaborata, tutti devono corrispondere.

12. Seleziona Crea percorso.

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

2. Contenuto dell'esempio .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. Output di esempio:

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

Per eliminare un percorso utilizzando il AWS Management Console

1. Apri la console App Mesh all'indirizzo https://console.aws.amazon.com/appmesh/.

2. Scegli la mesh da cui desideri eliminare un percorso. Sono elencate tutte le mesh che possiedi e che sono state condivise con te.

3. Nel riquadro di navigazione sinistro, scegliere Virtual routers (Router virtuali).

4. Scegli il router da cui desideri eliminare un percorso.

5. Nella tabella Percorsi, scegli il percorso che desideri eliminare e seleziona Elimina nell'angolo in alto a destra.

6. Nella casella di conferma, digita delete e quindi fai clic su Elimina.

Per eliminare un percorso utilizzando il AWS CLI

1. Usa il seguente comando per eliminare la tua rotta (sostituisci i red valori con i tuoi):

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

2. Output di esempio:

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