Configurare il routing basato su parametri di query e intestazioni per il bilanciatore del carico delle applicazioni classico

Questa pagina include due esempi per il bilanciatore del carico delle applicazioni classico:

Per configurare la gestione del traffico per il bilanciatore del carico delle applicazioni esterno globale e il bilanciatore del carico delle applicazioni esterno regionale, consulta le seguenti pagine:

Prima di iniziare

Configurare il routing basato sui parametri di query

Questo esempio mostra come utilizzare parametri di ricerca per eseguire test A/B tramite la corrispondenza con la stringa di query.

Aggiungere 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 su cui è in esecuzione Apache e poi configurare il bilanciamento del carico.

I gruppi di istanze gestite forniscono VM che utilizzano 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 si trovano nella stessa regione. Se vuoi una configurazione multiregionale, devi avere un template di istanza configurato per la seconda regione.

Console

  1. Crea un template di istanza. Nella Google Cloud console, vai a la pagina Template di istanza.

    Vai a Modelli di istanza

    1. Fai clic su Crea template di 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 12 (bookworm). 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 il seguente script 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 Google Cloud console.

    Vai a Gruppi di istanze

    1. Fai clic su Crea gruppo di istanze.
    2. Seleziona Nuovo gruppo di istanze gestite (stateless). Per saperne di più, consulta MIG stateless o stateful.
    3. In Nome, inserisci first-example-ig.
    4. In Località, seleziona Zona singola.
    5. In Regione, seleziona la regione che preferisci. Questo esempio utilizza us-east1.
    6. In Zona, seleziona us-east1-b.
    7. In Template di istanza, seleziona il template 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. Assegna al secondo il nome second-example-ig e basalo sul template lb-backend-template.

gcloud

  1. Crea un template di istanza.

    gcloud compute instance-templates create lb-backend-template \
       --region=us-east1 \
       --network=default \
       --subnet=default \
       --tags=allow-health-check \
       --image-family=debian-12 \
       --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 in base al template.

    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 in base al template.

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

Configurare una regola firewall

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

Console

  1. Nella Google Cloud console, vai alla pagina Policy del firewall.
    Vai a Policy del firewall
  2. Fai clic su Crea regola firewall per creare la seconda regola firewall:
  3. Inserisci un Nome 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

Prenotare 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 Google Cloud console.
    Vai alla pagina Indirizzi IP esterni
  2. Fai clic su Prenota indirizzo statico per prenotare un indirizzo IPv4.
  3. Assegna il Nome 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 il 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 prenotato:

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

Configurare i backend del bilanciatore del carico

Console

La Google Cloud console non è attualmente supportata per la configurazione del routing basato su intestazioni e parametri. Utilizza invece 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à di gestione del traffico avanzate.
    • 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 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 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
        

Creare la mappa URL

Console

La Google Cloud console non è attualmente supportata per la configurazione del routing basato su intestazioni e parametri. Utilizza invece 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 vanno a buon fine e il comando restituisce un messaggio di successo, salva le modifiche alla mappa URL.

  3. Aggiorna la mappa URL.

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

Creare il proxy di destinazione e la regola di forwarding

Console

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

gcloud

  1. Crea un proxy HTTP di destinazione per indirizzare le richieste alla mappa URL.
        gcloud compute target-http-proxies create http-lb-proxy \
            --url-map web-map-http
        
  2. Crea una regola di forwarding globale per indirizzare 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à di gestione del traffico avanzate.
    • 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 prenotato:

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

Per testare questa configurazione, esegui:

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.

Configurare il routing basato sulle intestazioni HTTP

Questo esempio mostra come aggiungere e rimuovere le 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 VM in un gruppo di istanze.

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

Aggiornare la mappa URL

Console

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

gcloud

  1. Questo esempio mostra come utilizzare le intestazioni delle richieste HTTP per eseguire test A/B tramite la corrispondenza con 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 vanno a buon fine e il comando restituisce un messaggio di successo, salva le modifiche alla mappa URL.

  3. Aggiorna la mappa 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