Configura le VM di Compute Engine utilizzando il deployment automatico di Envoy

Questo documento si applica alle API precedenti. Se esegui il deployment con le nuove API di routing dei servizi, che sono in anteprima, consulta Configurazione di Cloud Service Mesh per i proxy Envoy con i servizi HTTP.

Prima di seguire le istruzioni riportate in questa guida, completa le attività preliminari descritte in Preparati per la configurazione delle API di routing dei servizi con Envoy e workload senza proxy.

Questa guida mostra come eseguire automaticamente il deployment di un piano dati costituito da proxy sidecar Envoy, configurarlo utilizzando Cloud Service Mesh e verificare la configurazione per assicurarti che funzioni correttamente. Questo processo prevede quanto segue:

  1. Abilitazione dell'API Cloud OS Config.
  2. Creazione di un servizio di test.
  3. Deployment di un piano dati semplice su Compute Engine utilizzando i proxy Envoy (versione Envoy 1.18.4, che supporta solo xDS v3).
  4. Configurazione di Cloud Service Mesh utilizzando le API di Compute Engine, che consentono a Cloud Service Mesh di configurare i proxy sidecar Envoy.
  5. Accesso a una VM che esegue un proxy Envoy e invio di una richiesta a un backend con bilanciamento del carico tramite il proxy Envoy.

Gli esempi di configurazione in questo documento sono a scopo dimostrativo. Per un ambiente di produzione, potresti dover eseguire il deployment di componenti aggiuntivi, in base al tuo ambiente e ai tuoi requisiti.

Abilitazione dell'API Cloud OS Config

Assicurati di abilitare l'API Cloud OS Config. In caso contrario, non potrai installare i componenti richiesti sulle VM.

A tal fine:

Console

  1. Nella Google Cloud console, vai ad API e servizi.
    Vai alla pagina Libreria API
  2. Seleziona il progetto corretto.
  3. Nella casella di ricerca, inserisci API Cloud OS Config e premi Invio.
  4. Seleziona API Cloud OS Config.
  5. Fai clic su Attiva.

gcloud 

gcloud services enable osconfig.googleapis.com

Creazione del servizio di test Hello World

Questa sezione mostra come creare un semplice servizio di test che restituisce il nome host della VM che ha gestito la richiesta del client. Il servizio di test è semplice: è un server web di cui è stato eseguito il deployment in un gruppo di istanze gestite di Compute Engine.

Creazione del template di istanza per il servizio di test Hello World

Il template di istanza che crei configura un server web apache2 di esempio utilizzando il parametro startup-script.

Console

  1. Nella Google Cloud console, vai alla pagina Modelli di istanza.

    Vai a Modelli di istanza

  2. Fai clic su Crea modello di istanza.
  3. Nei campi, inserisci le seguenti informazioni:
    • Nome: td-demo-hello-world-template
    • Disco di avvio: scegli un sistema operativo e una versione.
    • Service account: account di servizio predefinito di Compute Engine
    • Ambiti di accesso: consenti l'accesso completo a tutte le API Cloud
  4. Fai clic su Gestione, sicurezza, dischi, networking, single tenancy. 1 Nella scheda Networking, nel campo Tag di rete, aggiungi il td-http-server tag.

  5. Nella scheda Gestione, copia il seguente script nel campo Script di avvio.

    #!/bin/bash
sudo apt-get update -y
sudo apt-get install apache2 -y
sudo service apache2 restart
echo '<!doctype html><html><body><h1>'\`/bin/hostname\`'</h1></body></html>' | sudo tee /var/www/html/index.html

  6. Fai clic su Crea.

gcloud

Puoi scegliere tra molte versioni del sistema operativo. Questo esempio utilizza il valore predefinito Debian 10.

Per creare il modello di istanza:

gcloud compute instance-templates create td-demo-hello-world-template \
  --machine-type=n1-standard-1 \
  --boot-disk-size=20GB \
  --image-family=debian-10  \
  --image-project=debian-cloud \
  --scopes=https://www.googleapis.com/auth/cloud-platform \
  --tags=td-http-server \
  --metadata=startup-script="#! /bin/bash
sudo apt-get update -y
sudo apt-get install apache2 -y
sudo service apache2 restart
sudo mkdir -p /var/www/html/
echo '<!doctype html><html><body><h1>'\`/bin/hostname\`'</h1></body></html>' | sudo tee /var/www/html/index.html"

Creazione del gruppo di istanze gestite per il servizio Hello World

In questa sezione, specifichi che il gruppo di istanze gestite ha sempre due istanze del servizio di test. Questo è a scopo dimostrativo. Cloud Service Mesh supporta i gruppi di istanze gestite con scalabilità automatica.

Console

  1. Nella Google Cloud console, vai alla pagina Gruppi di istanze.

    Vai alla pagina Gruppi di istanze

  2. Fai clic su Crea gruppo di istanze.
  3. Seleziona Nuovo gruppo di istanze gestite (stateless). Per saperne di più, consulta MIG stateful o stateless.
  4. Inserisci td-demo-hello-world-mig come nome del gruppo di istanze gestite e seleziona la zona us-central1-a.
  5. In Template di istanza, seleziona td-demo-hello-world-template, il modello di istanza che hai creato.
  6. In Modalità di scalabilità automatica, seleziona Off:do not autoscale.
  7. In Numero massimo di istanze, specifica almeno due come numero di istanze che vuoi creare nel gruppo.
  8. Fai clic su Crea.

gcloud

Utilizza gcloud CLI per creare un gruppo di istanze gestite con il modello di istanza che hai creato in precedenza.

gcloud compute instance-groups managed create td-demo-hello-world-mig \
  --zone us-central1-a \
  --size=2 \
  --template=td-demo-hello-world-template

Creazione del modello di istanza e del gruppo di istanze gestite in cui viene eseguito il deployment di Envoy

Segui le istruzioni riportate in questa sezione per creare un modello di istanza e un gruppo di istanze gestite per Cloud Service Mesh con i proxy Envoy di cui è stato eseguito il deployment automatico. I gruppi di istanze gestite creano nuove VM di backend utilizzando la scalabilità automatica.

Componenti software in esecuzione sulle VM

Quando crei un modello di istanza con --service-proxy=enabled, sulle VM vengono installati i seguenti componenti.

  • Il proxy Envoy, configurato da Cloud Service Mesh, viene scaricato da un bucket Cloud Storage dedicato. Il bucket contiene una build del proxy Envoy fornita da Google.
  • L'agente proxy di servizio, che inizializza il proxy Envoy e i componenti del proxy. Quando una VM è in esecuzione, l'agente proxy di servizio configura l'intercettazione del traffico e monitora l'integrità del proxy Envoy. Anche l'agente proxy di servizio viene scaricato da un bucket Cloud Storage.

L'unica versione di Envoy disponibile è il file binario Envoy più recente ospitato in una località Cloud Storage dedicata. Questa versione di Envoy è supportata su Compute Engine Debian, CentOS 7/8 e RHEL 7/8. Durante il ripristino automatico e lo scale up, il gruppo di istanze gestite installa una versione recente di Envoy sulla VM. In alcuni casi, questa versione potrebbe essere più recente di quella di Envoy di cui è stato eseguito il deployment nelle istanze VM create in precedenza. Ciò potrebbe comportare un'incoerenza nelle versioni installate nelle VM di un gruppo di istanze gestite. Le versioni incoerenti funzionano correttamente insieme. Se è disponibile un aggiornamento della sicurezza per Envoy, ti consigliamo di eseguire l'upgrade del gruppo di istanze gestite utilizzando una sostituzione in sequenza.

Creazione del modello di istanza

Un modello di istanza specifica la configurazione delle istanze VM create in un gruppo di istanze gestite. I flag che passi al modello di istanza installano Envoy e configurano le istanze VM in modo che siano pronte per Cloud Service Mesh.

Puoi utilizzare Debian 10/11, CentOS 7/8 o RHEL 7/8 per l'immagine del disco di avvio nel modello di istanza.

Per creare un modello di istanza di questo tipo:

  gcloud compute instance-templates create td-vm-template-auto \
    --image-family=[ debian-10 | centos-7 | centos-8 | rhel-7 | rhel-8 ]  \
    --image-project=[ debian-cloud | centos-cloud |rhel-cloud ] \
    --service-proxy=enabled

Per personalizzare il deployment di Envoy, consulta la Guida di riferimento per il deployment automatico di Envoy.

Creazione del gruppo di istanze gestite

Console

  1. Nella Google Cloud console, vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Fai clic su Crea un gruppo di istanze.
  3. Inserisci td-vm-mig-us-central1 come nome del gruppo di istanze gestite e seleziona la zona us-central1-a.
  4. In Tipo di gruppo, seleziona Gruppo di istanze gestite.
  5. In Modello di istanza, seleziona td-vm-template-auto, il modello di istanza che hai creato.
  6. Specifica 2 come numero di istanze che vuoi creare nel gruppo.
  7. Fai clic su Crea per creare il nuovo profilo.

gcloud

Utilizza gcloud CLI per creare un gruppo di istanze gestite con il modello di istanza che hai creato in precedenza.

 gcloud compute instance-groups managed create td-vm-mig-us-central1 \
    --zone us-central1-a --size=2 --template=td-vm-template-auto

Configurazione di Cloud Service Mesh con Google Cloud componenti di bilanciamento del carico

Le istruzioni riportate in questa sezione mostrano come configurare Cloud Service Mesh in modo che i proxy Envoy eseguano il bilanciamento del carico del traffico in uscita su due istanze di backend. Configura i seguenti componenti:

Creazione del controllo di integrità

Segui le istruzioni riportate di seguito per creare un controllo di integrità. Per saperne di più, consulta Creazione di controlli di integrità.

Console

  1. Vai alla pagina Controlli di integrità nella Google Cloud console.
    Vai alla pagina Controlli di integrità
  2. Fai clic su Crea controllo di integrità.
  3. Inserisci td-vm-health-check come nome.
  4. In Protocollo, seleziona HTTP.
  5. Fai clic su Crea.

gcloud

  1. Crea il controllo di integrità.

    gcloud compute health-checks create http td-vm-health-check

Creazione della regola firewall

Segui le istruzioni riportate di seguito per creare la regola firewall richiesta per i probe del controllo di integrità. Per saperne di più, consulta Regole firewall per i controlli di integrità.

Console

  1. Vai alla pagina Policy del firewall nella Google Cloud console.
    Vai alla pagina Policy del firewall
  2. Fai clic su Crea regola firewall.
  3. Nella pagina Crea una regola firewall, fornisci le seguenti informazioni:
    • Nome: fw-allow-health-checks
    • Rete: scegli la rete VPC.
    • Priorità: inserisci un numero per la priorità o 1000 per impostazione predefinita.
    • Direzione del traffico: scegli in entrata.
    • Azione in caso di corrispondenza: scegli Consenti.
    • Destinazioni: scegli Tag di destinazione specificati, quindi inserisci td-http-server nella casella di testo Tag di destinazione.
    • Filtro di origine: scegli il tipo di intervallo IP corretto.
    • Intervalli IP di origine: 35.191.0.0/16,130.211.0.0/22
    • Filtro di destinazione: seleziona il tipo di IP.
    • Protocolli e porte: fai clic su Protocolli e porte specificati, quindi seleziona il tipo tcp nella porta 80

gcloud

  1. Crea la regola firewall per il controllo di integrità.

    gcloud compute firewall-rules create fw-allow-health-checks \
  --action ALLOW \
  --direction INGRESS \
  --source-ranges 35.191.0.0/16,130.211.0.0/22 \
  --target-tags td-http-server \
  --rules tcp:80

Creazione del servizio di backend

Crea il servizio di backend. Se utilizzi Google Cloud CLI, devi designarlo come servizio di backend globale con uno schema di bilanciamento del carico INTERNAL_SELF_MANAGED. Aggiungi il controllo di integrità e un gruppo di istanze gestite o non gestite al servizio di backend. Tieni presente che questo esempio utilizza il gruppo di istanze gestite con il modello di VM di Compute Engine che esegue il servizio HTTP di esempio creato in Creazione del gruppo di istanze gestite.

Console

  1. Vai alla pagina Cloud Service Mesh nella Google Cloud console.

    Vai alla pagina Cloud Service Mesh

  2. Nella scheda Servizi, fai clic su Crea servizio.

  3. Fai clic su Continua.

  4. Inserisci td-vm-service come nome del servizio.

  5. Seleziona la rete VPC corretta.

  6. Assicurati che Tipo di backend sia Gruppi di istanze.

  7. Seleziona td-demo-hello-world-mig, il gruppo di istanze gestite che hai creato e che contiene i backend per il servizio di test Hello World.

  8. Inserisci i numeri di porta corretti.

  9. Scegli Utilizzo o Tasso come Modalità di bilanciamento. Il valore predefinito è Tasso.

  10. Fai clic su Fine.

  11. Seleziona il controllo di integrità che hai creato oppure fai clic su Crea un altro controllo di integrità e assicurati di selezionare HTTP come protocollo.

  12. In Timeout per lo svuotamento della connessione, imposta il valore su 30 secondi o più.

  13. Fai clic su Continua.

  14. Fai clic su Crea.

gcloud

  1. Crea il servizio di backend.

    gcloud compute backend-services create td-vm-service \
 --global \
 --load-balancing-scheme=INTERNAL_SELF_MANAGED \
 --connection-draining-timeout=30s \
 --health-checks td-vm-health-check

  2. Aggiungi i backend al servizio di backend.

    gcloud compute backend-services add-backend td-vm-service \
  --instance-group td-demo-hello-world-mig \
  --instance-group-zone us-central1-a \
  --global

Creazione della mappa di regole di routing

La mappa di regole di routing definisce la modalità di routing del traffico di Cloud Service Mesh nel mesh. Nell'ambito della mappa di regole di routing, configuri un indirizzo IP virtuale (VIP) e un insieme di regole di gestione del traffico associate, come il routing basato su host. Quando un'applicazione invia una richiesta al VIP, il proxy Envoy:

  1. Intercetta la richiesta.
  2. La valuta in base alle regole di gestione del traffico nella mappa URL.
  3. Seleziona un servizio di backend in base al nome host nella richiesta.
  4. Sceglie un backend o un endpoint associato al servizio di backend selezionato.
  5. Invia il traffico a quel backend o endpoint.

Per saperne di più sulla gestione del traffico, consulta Gestione avanzata del traffico.

Console

Nella Google Cloud console, la creazione del proxy di destinazione è combinata con la creazione della regola di forwarding. Quando crei la regola di forwarding, Google Cloud viene creato automaticamente un proxy HTTP di destinazione e viene collegato alla mappa URL.

  1. Vai alla pagina Cloud Service Mesh nella Google Cloud console.

    Vai alla pagina Cloud Service Mesh

  2. Nella scheda Mappe di regole di routing, fai clic su Crea mappa di regole di routing.

  3. Inserisci un nome.

  4. Fai clic su Aggiungi regola di forwarding.

  5. Inserisci td-vm-forwarding-rule come nome della regola di forwarding.

  6. Seleziona la rete.

  7. Seleziona il tuo IP interno. Il traffico diretto a questo indirizzo IP viene intercettato dal proxy Envoy e inviato al servizio appropriato in base alle regole host e percorso.

    La regola di forwarding viene creata come regola di forwarding globale con load-balancing-scheme impostato su INTERNAL_SELF_MANAGED.

  8. Nel campo IP personalizzato, digita 10.0.0.1. Quando la VM invia a questo indirizzo IP, il proxy Envoy lo intercetta e lo invia all'endpoint del servizio di backend appropriato in base alle regole di gestione del traffico definite nella mappa URL.

    Ogni regola di forwarding in una rete VPC deve avere un indirizzo IP e una porta univoci per rete VPC. Se crei più di una regola di forwarding con lo stesso indirizzo IP e la stessa porta in una determinata rete VPC, solo la prima regola di forwarding è valida. Le altre vengono ignorate. Se 10.0.0.1 non è disponibile nella tua rete, scegli un altro indirizzo IP.

  9. Assicurati che Porta sia impostato su 80.

  10. Fai clic su Salva.

  11. Nella sezione Regole di routing, seleziona Regola host e percorso semplice.

  12. Nella sezione Regole host e percorso, seleziona td-vm-service come servizio.

  13. Fai clic su Aggiungi regola host e percorso.

  14. In Host, inserisci hello-world.

  15. In Servizio, seleziona td-vm-service.

  16. Fai clic su Salva.

gcloud

  1. Crea una mappa URL che utilizzi il servizio di backend td-vm-service come predefinito.

    gcloud compute url-maps create td-vm-url-map \
   --default-service td-vm-service

  2. Crea un matcher percorso e una regola host per instradare il traffico per il tuo servizio in base al nome host e a un percorso. Questo esempio utilizza td-vm-service come nome del servizio e un matcher percorso predefinito che corrisponde a tutte le richieste di percorso per questo host (/*).

    gcloud compute url-maps add-path-matcher td-vm-url-map \
   --default-service td-vm-service \
   --path-matcher-name td-vm-path-matcher

    gcloud compute url-maps add-host-rule td-vm-url-map \
   --path-matcher-name=td-vm-path-matcher \
   --hosts=hello-world

  3. Crea il proxy HTTP di destinazione.

    gcloud compute target-http-proxies create td-vm-proxy \
   --url-map=td-vm-url-map

  4. Crea la regola di forwarding.

    La regola di forwarding deve essere globale e deve essere creata con il valore di load-balancing-scheme impostato su INTERNAL_SELF_MANAGED.

    gcloud compute forwarding-rules create td-vm-forwarding-rule \
   --global \
   --load-balancing-scheme=INTERNAL_SELF_MANAGED \
   --address=10.0.0.1 \
   --target-http-proxy=td-vm-proxy \
   --ports=80 \
   --network=default

A questo punto, Cloud Service Mesh è configurato per eseguire il bilanciamento del carico del traffico per i servizi specificati nella mappa URL tra i backend del gruppo di istanze gestite.

Verifica della configurazione

In questa parte finale della guida alla configurazione di Cloud Service Mesh per le VM di Compute Engine, verifichi che il traffico inviato dalla VM client destinato al VIP della regola di forwarding venga intercettato e reindirizzato al proxy Envoy, che poi instrada la richiesta alle VM che ospitano il servizio Hello World.

Per farlo, accedi alla VM client, che è stata configurata per intercettare il traffico e reindirizzarlo a Envoy. Invia una richiesta curl al VIP associato alla mappa di regole di routing. Envoy ispeziona la richiesta curl, determina il servizio a cui deve essere risolta e invia la richiesta a un backend associato a quel servizio.

  1. Nella Google Cloud console, vai alla pagina Gruppi di istanze.

    Vai alla pagina Gruppi di istanze

  2. Seleziona il gruppo di istanze td-vm-mig-us-central1.
  3. Nella sezione di riepilogo della VM, in Connetti, fai clic su SSH.
  4. Dopo aver eseguito l'accesso alla VM client, utilizza lo strumento curl per inviare una richiesta al servizio Hello World tramite Envoy:
curl -H "Host: hello-world" http://10.0.0.1/

Quando esegui questo comando ripetutamente, dovresti visualizzare risposte HTML diverse contenenti i nomi host dei backend nel gruppo di istanze gestite Hello World. Questo perché Envoy utilizza il bilanciamento del carico round robin, l'algoritmo di bilanciamento del carico predefinito, quando invia il traffico ai backend del servizio Hello World.

Passaggi successivi