Gateway virtuali

Per creare un gateway virtuale 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 gateway virtuale. 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 Crea gateway virtuale.

5. Per Nome gateway virtuale, inserisci un nome per il tuo gateway virtuale.

6. (Facoltativo, ma consigliato) Configura le impostazioni predefinite delle politiche del client.

   1. (Facoltativo) Seleziona Enforce TLS se desideri che il gateway comunichi solo con i servizi virtuali utilizzando Transport Layer Security (TLS).

   2. (Facoltativo) Per Porte, specifica una o più porte su cui desideri imporre la comunicazione TLS con i servizi virtuali.

   3. Per Metodo di convalida, selezionate una delle seguenti opzioni. Il certificato specificato deve già esistere e soddisfare requisiti specifici. Per ulteriori informazioni, consulta Requisiti del certificato.

      • AWS Private Certificate Authorityhosting: seleziona uno o più certificati esistenti.

      • Hosting Envoy Secret Discovery Service (SDS): inserisci il nome del segreto che Envoy recupera utilizzando Secret Discovery Service.

      • Hosting di file locale: specifica il percorso del file della catena di certificati sul file system in cui è distribuito Envoy.

   4. (Facoltativo) Inserite un nome alternativo per il soggetto. Per aggiungerne altri SANs, seleziona Aggiungi SAN. SANs deve essere in formato FQDN o URI.

   5. (Facoltativo) Seleziona Fornisci certificato client e una delle opzioni seguenti per fornire un certificato client quando un server lo richiede e abilitare l'autenticazione TLS reciproca. Per ulteriori informazioni su Mutual TLS, consulta i documenti di autenticazione TLS Mutual App Mesh.

      • Hosting Envoy Secret Discovery Service (SDS): inserisci il nome del segreto che Envoy recupera utilizzando Secret Discovery Service.

      • Hosting di file locale: specifica il percorso del file della catena di certificati, nonché la chiave privata, sul file system in cui è distribuito Envoy. Per una descrizione completa e dettagliata end-to-end dell'implementazione di una mesh con un'applicazione di esempio che utilizza la crittografia con file locali, vedi Configurazione di TLS con certificati TLS forniti da file su. GitHub

7. (Facoltativo) Per configurare la registrazione, seleziona Registrazione. Immettete il percorso dei log di accesso HTTP che desiderate che Envoy utilizzi. Ti consigliamo il /dev/stdout percorso in modo da poter utilizzare i driver di registro Docker per esportare i log di Envoy su un servizio come Amazon Logs. CloudWatch

   Nota

   I log devono ancora essere integrati da un agente nell'applicazione e inviati a una destinazione. Questo percorso file indica a Envoy dove inviare i log.

   Mostra piùMostra meno

8. Configura il listener.

   1. Seleziona un protocollo e specifica la porta su cui Envoy ascolta il traffico. Il listener http consente la transizione della connessione ai websocket. È possibile fare clic su Aggiungi ascoltatore per aggiungere più ascoltatori. Il pulsante Rimuovi rimuoverà quel listener.

   2. (Facoltativo) Abilita il pool di connessioni

      Il pool di connessioni limita il numero di connessioni che Virtual Gateway Envoy può stabilire contemporaneamente. Ha lo scopo di proteggere l'istanza di Envoy dal sovraccarico di connessioni e consente di adattare la modellazione del traffico alle esigenze delle applicazioni.

      È possibile configurare le impostazioni del pool di connessioni sul lato di destinazione per un listener gateway virtuale. App Mesh imposta le impostazioni del pool di connessioni lato client su infinite per impostazione predefinita, semplificando la configurazione della mesh.

      Nota

      I protocolli connectionPool e connectionPool PortMapping devono essere gli stessi. Se il protocollo del listener è grpc ohttp2, specifica solo. maxRequests Se il protocollo del listener èhttp, puoi specificare entrambi maxConnections e. maxPendingRequests

      • Per Numero massimo di connessioni, specificare il numero massimo di connessioni in uscita.

      • Per Maximum requests, specifica il numero massimo di richieste parallele che possono essere stabilite con Virtual Gateway Envoy.

      • (Facoltativo) Per il numero massimo di richieste in sospeso, specifica il numero di richieste in eccesso dopo il numero massimo di connessioni messe in coda da un Envoy. Il valore predefinito è 2147483647.

      Mostra piùMostra meno

   3. (Facoltativo) Se desideri configurare un controllo sanitario per il tuo listener, seleziona Abilita il controllo dello stato.

      Una politica di controllo dello stato di salute è facoltativa, ma se si specificano valori per una politica sanitaria, è necessario specificare i valori per Healthy threshold, Health check interval, Health check protocol, Timeout period e Unhealthy threshold.

      • Per il protocollo Health check, scegli un protocollo. Se si seleziona grpc, il servizio deve essere conforme al GRPC Health Checking Protocol.

      • Per Health check port (Porta del controllo dello stato), specificare la porta su cui deve essere eseguito il controllo dello stato.

      • Per Healthy threshold (Soglia di integrità), specificare il numero di controlli dello stato andati a buon fine consecutivi che devono verificarsi prima di dichiarare il listener integro.

      • Per Health check interval (Intervallo del controllo dello stato), specificare il periodo di tempo in millisecondi tra ogni esecuzione del controllo dello stato.

      • Per Path (Percorso), specificare il percorso di destinazione per la richiesta di controllo dello stato. Questo valore viene utilizzato solo se il protocollo Health check è http ohttp2. Il valore viene ignorato per gli altri protocolli.

      • Per Periodo di timeout, specifica il tempo di attesa per ricevere una risposta dal controllo sanitario in millisecondi.

      • Per Unhealthy threshold (Soglia di mancata integrità), specificare il numero di controlli dello stato non andati consecutivamente a buon fine che sono necessari per dichiarare il listener non integro.

      Mostra piùMostra meno

   4. (Facoltativo) Se desideri specificare se i client comunicano con questo gateway virtuale tramite TLS, seleziona Abilita la terminazione TLS.

      • Per Modalità, selezionate la modalità per la quale desiderate che TLS sia configurato sul listener.

      • Per Metodo Certificate, selezionate una delle seguenti opzioni. Il certificato deve soddisfare requisiti specifici. Per ulteriori informazioni, consulta Requisiti del certificato.

        • AWS Certificate Manager hosting: seleziona un certificato esistente.

        • Hosting Envoy Secret Discovery Service (SDS): inserisci il nome del segreto che Envoy recupera utilizzando Secret Discovery Service.

        • Hosting di file locale: specifica il percorso della catena di certificati e dei file con chiave privata sul file system in cui è distribuito Envoy.

      • (Facoltativo) Seleziona Richiedi certificato client e una delle opzioni seguenti per abilitare l'autenticazione TLS reciproca se il client fornisce un certificato. Per ulteriori informazioni su Mutual TLS, consulta i documenti di autenticazione TLS Mutual App Mesh.

        • Hosting Envoy Secret Discovery Service (SDS): inserisci il nome del segreto che Envoy recupera utilizzando Secret Discovery Service.

        • Hosting di file locale: specifica il percorso del file della catena di certificati sul file system in cui è distribuito Envoy.

      • (Facoltativo) Inserite un nome alternativo per il soggetto. Per aggiungerne altri SANs, seleziona Aggiungi SAN. SANs deve essere in formato FQDN o URI.

      Mostra piùMostra meno

9. Scegli Crea gateway virtuale per terminare.

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

2. Contenuto dell'esempio create-virtual-gateway .json:

   {
       "spec": {
         "listeners": [
           {
             "portMapping": {
               "port": 9080,
               "protocol": "http"
             }
           }
         ]
       }
   }

3. Output di esempio:

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-06T10:42:42.015000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }
   

Per eliminare un gateway virtuale 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 gateway virtuale. Vengono 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 che desideri eliminare e seleziona Elimina. Non è possibile eliminare un gateway virtuale se ha delle route gateway associate. È necessario prima eliminare tutte le route gateway associate. Puoi eliminare solo un gateway virtuale in cui il tuo account è elencato come proprietario della risorsa.

5. Nella casella di conferma, digita delete e seleziona Elimina.

Per eliminare un gateway virtuale utilizzando il AWS CLI

1. Utilizza il seguente comando per eliminare il gateway virtuale (sostituisci i red valori con i tuoi):

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

2. Output di esempio:

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-07T10:57:22.638000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "DELETED"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }