Percorsi gateway

Per creare una route gateway 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 desideri creare la route gateway. Sono elencate tutte le mesh che possiedi e che sono state condivise con te.

3. Scegli Gateway virtuali nella barra di navigazione a sinistra.

4. Scegli il gateway virtuale a cui desideri associare una nuova rotta gateway. Se non ne è elencato nessuno, devi prima creare un gateway virtuale. Puoi creare un gateway solo per un gateway virtuale il cui account è indicato come proprietario della risorsa.

5. Nella tabella Routes gateway, scegli Crea gateway route.

6. Per il nome della route del gateway, specifica il nome da utilizzare per la route del gateway.

7. Per il tipo di route Gateway, scegli http, http2 o grpc.

8. Seleziona un nome di servizio virtuale esistente. Se non ne è elencato nessuno, devi prima creare un servizio virtuale.

9. Scegli la porta che corrisponde alla destinazione per la porta del fornitore di servizi virtuali. La porta del provider di servizi virtuali è necessaria quando il provider (router o nodo) del servizio virtuale selezionato ha più listener.

10. (Facoltativo) Per Priorità, specificare la priorità per questa route gateway.

11. Per la configurazione Match, specificare:

    • 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. Port Match è necessario se questo gateway virtuale ha più listener.

      • (Facoltativo) Hostname esatto/suffisso ‐ Specifico il nome host a cui deve corrispondere la richiesta in entrata da indirizzare al servizio virtuale di destinazione.

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

        • Prefix match ‐ Per impostazione predefinita, una richiesta corrispondente proveniente da una route gateway viene riscritta nel nome del servizio virtuale di destinazione e il prefisso corrispondente viene riscritto in. / 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.

          Importante

          • Non puoi specificare nessuno dei due /aws-appmesh* o prefix match/aws-app-mesh*. Questi prefissi sono riservati per future applicazioni interne all'App Mesh.

          • Se vengono definite più rotte gateway, una richiesta viene abbinata alla route con il prefisso più lungo. Ad esempio, se esistessero due route gateway, una con il prefisso di /chapter e l'altra con il prefisso di/, una richiesta di www.example.com/chapter/ verrebbe abbinata alla route gateway con il prefisso. /chapter

          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 exact disabilita la corrispondenza parziale per un percorso e fa in modo che restituisca il percorso solo se il percorso corrisponde ESATTAMENTE all'URL corrente.

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

      • (Opzionale) Parametri di interrogazione ‐ Questo campo consente di abbinare i parametri della query.

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

    • Se grpc è il tipo selezionato:

      • Tipo di corrispondenza del nome host e (opzionale) corrispondenza esatta/suffisso ‐ Specificano il nome host a cui deve corrispondere la richiesta in entrata da indirizzare al servizio virtuale di destinazione.

      • nome del servizio grpc ‐ Il servizio grpc funge da API per l'applicazione ed è definito con. ProtoBuf

        Importante

        Non è possibile specificare /aws.app-mesh* o aws.appmesh per il nome del servizio. Questi nomi di servizio sono riservati per usi interni futuri di App Mesh.

      • (Facoltativo) Metadata ‐ Specifica i metadati per grpc. Deve corrispondere alla richiesta in entrata da indirizzare al servizio virtuale di destinazione.

12. (Facoltativo) Per la configurazione Rewrite:

    • Se http/http2 è il tipo selezionato:

      • Se Prefix è il tipo di corrispondenza selezionato:

        • Sostituisci la riscrittura automatica del nome host ‐ Per impostazione predefinita, il nome host viene riscritto nel nome del servizio virtuale di destinazione.

        • Ignora la riscrittura automatica del prefisso ‐ Quando è attivata, Prefix rewrite specifica il valore del prefisso riscritto.

      • Se Exact Path è il tipo di corrispondenza selezionato:

        • Sostituisci la riscrittura automatica del nome host: per impostazione predefinita, il nome host viene riscritto nel nome del servizio virtuale di destinazione.

        • Riscrittura del percorso ‐ Specifica il valore del percorso riscritto. Nessun percorso predefinito.

      • Se Regex Path è il tipo di corrispondenza selezionato:

        • Sostituisci la riscrittura automatica del nome host: per impostazione predefinita, il nome host viene riscritto nel nome del servizio virtuale di destinazione.

        • Riscrittura del percorso ‐ Specifica il valore del percorso riscritto. Nessun percorso predefinito.

    • Se grpc è il tipo selezionato:

      • Sostituisci la riscrittura automatica del nome host ‐ Per impostazione predefinita, il nome host viene riscritto nel nome del servizio virtuale di destinazione.

13. Scegli Crea percorso gateway per terminare.

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. Contenuto dell'esempio create-gateway-route .json:

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

3. Output di esempio:

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

Per eliminare una route gateway 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 una route gateway. Sono elencate tutte le mesh che possiedi e che sono state condivise con te.

3. Scegli Gateway virtuali nella barra di navigazione a sinistra.

4. Scegli il gateway virtuale da cui desideri eliminare un percorso di gateway.

5. Nella tabella delle rotte del gateway, scegli la route del gateway che desideri eliminare e seleziona Elimina. Puoi eliminare una route gateway solo se il tuo account è elencato come proprietario della risorsa.

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

Per eliminare una route gateway utilizzando il AWS CLI

1. Utilizzate il seguente comando per eliminare la route del gateway (sostituite i red valori con i vostri):

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

2. Output di esempio:

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