Configurazione del routing basato su parametri di query e intestazioni per l'Application Load Balancer classico

Questa pagina include due esempi di Application Load Balancer classico:

• Configurare il routing basato su parametri di query
• Configurare il routing basato su intestazioni HTTP

Per configurare la gestione del traffico per l'Application Load Balancer esterno globale e per l'Application Load Balancer esterno regionale, consulta le seguenti pagine:

• Configura la gestione del traffico per il bilanciatore del carico delle applicazioni esterno globale
• Configura la gestione del traffico per il bilanciatore del carico delle applicazioni esterno regionale

Prima di iniziare

• Leggi la panoramica della gestione del traffico per i bilanciatori del carico delle applicazioni esterni.
• Acquisisci familiarità con l'API URL Map.

Configurare il routing basato su parametri di query

Questo esempio mostra l'utilizzo parametri di ricerca per eseguire test A/B mediante corrispondenza in base alla stringa di query.

Aggiungi due gruppi di istanza di backend

Affinché il routing sia utile, devi avere più backend.

Per configurare due backend, le VM devono trovarsi in due gruppi di istanze. Questa guida descrive come creare gruppi di istanze gestite con VM Linux in cui è in esecuzione Apache e come configurare il bilanciamento del carico.

I gruppi di istanze gestite forniscono VM che eseguono i server di backend di un bilanciatore del carico HTTP esterno. A scopo dimostrativo, i backend gestiscono i propri nomi host.

Per semplicità, i backend risiedono nella stessa regione. Se vuoi una configurazione per più regioni, devi avere configurato un modello di istanza per la seconda regione.

Console

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

   Vai a Modelli di istanza

   1. Fai clic su Crea modello istanza.
   2. In Nome, inserisci lb-backend-template.
   3. Assicurati che il disco di avvio sia impostato su un'immagine Debian, ad esempio Debian GNU/Linux 10 (buster). Queste istruzioni utilizzano comandi disponibili solo su Debian, come apt-get.
   4. Fai clic su Opzioni avanzate.
   5. Fai clic su Networking e configura il seguente campo:
      1. In Tag di rete, inserisci allow-health-check.

   6. Fai clic su Gestione. Inserisci lo script seguente nel campo Script di avvio.

      #! /bin/bash
      apt-get update
      apt-get install apache2 -y
      a2ensite default-ssl
      a2enmod ssl
      vm_hostname="$(curl -H "Metadata-Flavor:Google" \
      http://metadata.google.internal/computeMetadata/v1/instance/name)"
      echo "Page served from: $vm_hostname" | \
      tee /var/www/html/index.html
      systemctl restart apache2
      

   7. Fai clic su Crea.

2. Creare un gruppo di istanze gestite. Vai alla pagina Gruppi di istanze nella console Google Cloud.

   Vai a Gruppi di istanze

   1. Fai clic su Crea gruppo di istanze.
   2. Seleziona Nuovo gruppo di istanze gestite (stateless). Per ulteriori informazioni, consulta la pagina relativa a MIG stateless o stateful.
   3. In Nome, inserisci first-example-ig.
   4. In Località, seleziona Zona singola.
   5. In Regione, seleziona l'area geografica che preferisci. In questo esempio viene utilizzato us-east1.
   6. In Zona, seleziona us-east1-b.
   7. In Modello di istanza, seleziona il modello di istanza lb-backend-template.
   8. In Numero massimo di istanze, inserisci 2.
   9. In Modalità di scalabilità automatica, seleziona Off:do not autoscale.
   10. Fai clic su Crea.

Crea un altro gruppo di istanze gestite come questo. Nomina il secondo modello second-example-ig e basalo sul modello lb-backend-template.

gcloud

1. Creare un modello di istanza.

   gcloud compute instance-templates create `lb-backend-template` \
      --region=us-east1 \
      --network=default \
      --subnet=default \
      --tags=allow-health-check \
      --image-family=debian-10 \
      --image-project=debian-cloud \
      --metadata=startup-script='#! /bin/bash
        apt-get update
        apt-get install apache2 -y
        a2ensite default-ssl
        a2enmod ssl
        vm_hostname="$(curl -H "Metadata-Flavor:Google" \
        http://metadata.google.internal/computeMetadata/v1/instance/name)"
        echo "Page served from: $vm_hostname" | \
        tee /var/www/html/index.html
        systemctl restart apache2'
   

2. Crea il primo gruppo di istanze gestite basato sul modello.

   gcloud compute instance-groups managed create first-example-ig \
      --template=lb-backend-template --size=2 --zone=us-east1-b
   

3. Crea il secondo gruppo di istanze gestite basato sul modello.

   gcloud compute instance-groups managed create second-example-ig \
      --template=lb-backend-template --size=2 --zone=us-east1-c
   

Configurazione di una regola firewall

In questo esempio, creerai la regola firewall fw-allow-health-check. Questa è una regola in entrata che consente il traffico dai sistemi di controllo di integrità di Google Cloud (130.211.0.0/22 e 35.191.0.0/16). In questo esempio viene utilizzato il tag di destinazione allow-health-check per identificare le VM.

Console

1. Nella console Google Cloud, vai alla pagina Criteri firewall.
   Vai a Criteri firewall
2. Fai clic su Crea regola firewall per creare la seconda regola firewall:
3. Inserisci un Nome pari a fw-allow-health-check.
4. In Rete, seleziona Default.
5. In Destinazioni, seleziona Tag di destinazione specificati.
6. Compila il campo Tag di destinazione con allow-health-check.
7. Imposta Filtro di origine su Intervalli IPv4.
8. Imposta Intervalli IPv4 di origine su 130.211.0.0/22 e 35.191.0.0/16.
9. In Protocolli e porte, seleziona Protocolli e porte specificati.
10. Seleziona la casella di controllo TCP e inserisci 80 per i numeri di porta.
11. Fai clic su Crea.

gcloud

gcloud compute firewall-rules create fw-allow-health-check \
    --network=default \
    --action=allow \
    --direction=ingress \
    --source-ranges=130.211.0.0/22,35.191.0.0/16 \
    --target-tags=allow-health-check \
    --rules=tcp

Prenotazione di un indirizzo IP esterno

Ora che le istanze sono operative, configura un indirizzo IP esterno statico e globale che verrà utilizzato dai clienti per raggiungere il bilanciatore del carico.

Console

1. Vai alla pagina Indirizzi IP esterni nella console Google Cloud.
   Vai alla pagina Indirizzi IP esterni
2. Fai clic su Prenota indirizzo statico per prenotare un indirizzo IPv4.
3. Assegna un nome pari a lb-ipv4-1.
4. Imposta il livello di rete su Standard.
5. Imposta la versione IP su IPv4.
6. Imposta il Tipo su Globale.
7. Fai clic su Prenota.
8. Assicurati che Tipo sia impostato su Globale.
9. Fai clic su Prenota.

gcloud

gcloud compute addresses create lb-ipv4-1 \
    --ip-version=IPV4 \
    --network-tier=PREMIUM \
    --global

Prendi nota dell'indirizzo IPv4 riservato:

gcloud compute addresses describe lb-ipv4-1 \
    --format="get(address)" \
    --global

Configurazione dei backend del bilanciatore del carico

Console

La console Google Cloud al momento non è supportata per la configurazione del routing basato su intestazioni e parametri. Utilizza gcloud o l'API.

gcloud

1. Crea un controllo di integrità.

       gcloud compute health-checks create http http-basic-check \
           --port 80
       

2. Crea il primo servizio di backend.
   • Per un bilanciatore del carico delle applicazioni esterno globale, utilizza il comando gcloud CLI con load-balancing-scheme=EXTERNAL_MANAGED. Questa impostazione offre funzionalità avanzate di gestione del traffico.
   • Per un bilanciatore del carico delle applicazioni classico, utilizza load-balancing-scheme=EXTERNAL.

       gcloud compute backend-services create service-a \
           --load-balancing-scheme=LOAD_BALANCING_SCHEME \
           --global-health-checks \
           --protocol HTTP \
           --health-checks http-basic-check \
           --global
       

3. Crea il secondo servizio di backend.

       gcloud compute backend-services create service-b \
           --load-balancing-scheme=LOAD_BALANCING_SCHEME \
           --global-health-checks \
           --protocol HTTP \
           --health-checks http-basic-check \
           --global
       

4. Aggiungi il tuo primo gruppo di istanze come backend del primo servizio di backend.

       gcloud compute backend-services add-backend service-a \
           --balancing-mode=UTILIZATION \
           --max-utilization=0.8 \
           --capacity-scaler=1 \
           --instance-group=first-example-ig \
           --instance-group-zone=us-east1-b \
           --global
       

5. Aggiungi il tuo secondo gruppo di istanze come backend del secondo servizio di backend.

       gcloud compute backend-services add-backend service-b \
           --balancing-mode=UTILIZATION \
           --max-utilization=0.8 \
           --capacity-scaler=1 \
           --instance-group=second-example-ig \
           --instance-group-zone=us-east1-c \
           --global
       

Creazione della mappa URL

Console

La console Google Cloud al momento non è supportata per la configurazione del routing basato su intestazioni e parametri. Utilizza gcloud o l'API.

gcloud

1. Crea un file YAML /tmp/web-map-http.yaml. Sostituisci PROJECT_ID con l'ID progetto.

   defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
   hostRules:
   - hosts:
     - '*'
     pathMatcher: path-matcher-1
   name: web-map-http
   pathMatchers:
   - defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
     name: path-matcher-1
     routeRules:
       - matchRules:
           - prefixMatch: /
             queryParameterMatches:
               - name: ABTest
                 exactMatch: A
         priority: 0
         service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
       - matchRules:
           - prefixMatch: /
             queryParameterMatches:
               - name: ABTest
                 exactMatch: B
         priority: 1
         service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-b
   selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/web-map-http
   tests:
   - description: Test routing for query ABTest with A
     host: example.com
     path: /?ABTest=A
     service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
     expectedOutputUrl: http://example.com/?ABTest=A
   - description: Test routing for query ABTest with B
     host: example.com
     path: /?ABTest=B
     service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-b
     expectedOutputUrl: http://example.com/?ABTest=B
   

2. Convalida la mappa URL.

   gcloud compute url-maps validate --source /tmp/web-map-http.yaml
   

   Se i test vengono superati e il comando restituisce un messaggio di esito positivo, salva le modifiche nella mappa URL.

3. Aggiorna la mappa degli URL.

   gcloud compute url-maps import web-map-http \
      --source /tmp/web-map-http.yaml \
      --global
   

Creazione del proxy di destinazione e della regola di forwarding

Console

La console Google Cloud al momento non è supportata per la configurazione del routing basato su intestazioni e parametri. Utilizza gcloud o l'API.

gcloud

1. Crea un proxy HTTP di destinazione per instradare le richieste alla mappa degli URL.

       gcloud compute target-http-proxies create http-lb-proxy \
           --url-map web-map-http
       

2. Crea una regola di forwarding globale per instradare le richieste in entrata al proxy.
   • Per un bilanciatore del carico delle applicazioni esterno globale, utilizza il comando gcloud CLI con load-balancing-scheme=EXTERNAL_MANAGED. Questa impostazione offre funzionalità avanzate di gestione del traffico.
   • Per un bilanciatore del carico delle applicazioni classico, utilizza load-balancing-scheme=EXTERNAL.

       gcloud compute forwarding-rules create http-content-rule \
           --load-balancing-scheme=LOAD_BALANCING_SCHEME \
           --network-tier=PREMIUM \
           --address=lb-ipv4-1 \
           --global \
           --target-http-proxy=http-lb-proxy \
           --ports=80
       

Test

Prendi nota dell'indirizzo IPv4 riservato:

gcloud compute addresses describe lb-ipv4-1 \
    --format="get(address)" \
    --global

Verifica questa configurazione eseguendo:

curl http://IP_ADDRESS?ABTest=A

curl http://IP_ADDRESS?ABTest=B

In un browser, apri http://IP_ADDRESS?ABTest=A e http://IP_ADDRESS?ABTest=B.

Configurazione del routing basato su intestazioni HTTP

Questo esempio mostra l'aggiunta e la rimozione delle intestazioni HTTP per eseguire il routing intelligente.

Prima di iniziare

Puoi utilizzare un bilanciatore del carico delle applicazioni esterno esistente o crearne uno nuovo.

Puoi utilizzare questa funzionalità con uno qualsiasi dei tipi di backend supportati. Questo esempio presuppone che tu stia utilizzando le VM in un gruppo di istanze.

Per configurare un bilanciatore del carico semplice, consulta l'esempio basato su parametri di query riportato sopra.

Aggiornamento della mappa URL

Console

La console Google Cloud al momento non è supportata per la configurazione del routing basato su intestazioni e parametri. Utilizza gcloud o l'API.

gcloud

1. Questo esempio mostra l'utilizzo delle intestazioni delle richieste HTTP per eseguire test A/B abbinando i valori nelle intestazioni HTTP della richiesta.

   Crea un file YAML /tmp/web-map-http.yaml. Sostituisci PROJECT_ID con l'ID progetto.

   defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
   kind: compute#urlMap
   name: web-map-http
   hostRules:
   - hosts:
     - '*'
     pathMatcher: path-matcher-1
   pathMatchers:
   - defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
     name: path-matcher-1
     routeRules:
       - matchRules:
           - prefixMatch: /
             headerMatches:
               - headerName: ABTest
                 exactMatch: A
         priority: 0
         service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
       - matchRules:
           - prefixMatch: /
             headerMatches:
               - headerName: ABTest
                 exactMatch: B
         priority: 1
         service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-b
   tests:
   - description: Test routing for query ABTest with A
     host: example.com
     path: /
     headers:
     - name: ABTest
       value: A
     service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-a
   - description: Test routing for query ABTest with B
     host: example.com
     path: /
     headers:
     - name: ABTest
       value: B
     service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/service-b
   

2. Convalida la mappa URL.

   gcloud compute url-maps validate --source /tmp/web-map-http.yaml
   

   Se i test vengono superati e il comando restituisce un messaggio di esito positivo, salva le modifiche nella mappa URL.

3. Aggiorna la mappa degli URL.

   gcloud compute url-maps import web-map-http \
      --source /tmp/web-map-http.yaml \
      --global
   

Test

Utilizzando l'indirizzo IPv4 del bilanciatore del carico associato, testa questa configurazione eseguendo:

curl http://IP_ADDRESS -H "ABTest: A"

curl http://IP_ADDRESS -H "ABTest: B"

Passaggi successivi

• Esegui la pulizia della configurazione del bilanciatore del carico.