Configura un backend esterno con un NEG internet

Questa guida utilizza un esempio per descrivere le nozioni di base dell'utilizzo di un backend esterno (a volte chiamato origine personalizzata) in un bilanciatore del carico delle applicazioni esterno. Un backend esterno è un endpoint esterno a Google Cloud. Quando utilizzi un backend esterno con un Application Load Balancer esterno, puoi migliorare le prestazioni utilizzando la memorizzazione nella cache di Cloud CDN.

La guida illustra come configurare un bilanciatore del carico delle applicazioni esterno globale con un servizio di backend abilitato per Cloud CDN che effettui il proxy a un server di backend esterno all'indirizzo backend.example.com.

Nell'esempio, il bilanciatore del carico accetta le richieste HTTPS dai client e ne esegue il proxy come HTTPS al backend esterno. In questo esempio si presume che il backend esterno supporti HTTPS.

Altre opzioni prevedono la configurazione di un bilanciatore del carico per accettare richieste HTTP o HTTPS e l'utilizzo di HTTPS durante il proxy delle richieste al backend esterno.

Questa guida presuppone che tu abbia già configurato un bilanciatore del carico e che tu stia aggiungendo un nuovo backend esterno. Per maggiori informazioni, consulta Configurare un bilanciatore del carico delle applicazioni classico con il backend di un gruppo di istanze gestite.

La figura 1 mostra un'architettura di esempio.

Figura 1. Caso d'uso tipico per i backend esterni.

Nel diagramma, www.example.com ha un frontend del bilanciatore del carico con l'indirizzo IP 120.1.1.1. In caso di fallimento della cache, le richieste degli utenti per /cart/id/1223515 vengono recuperate dal backend esterno tramite HTTPS. Tutto il resto del traffico in entrata viene indirizzato al servizio di backend Google Cloud con le VM di Compute Engine o al bucket di backend, in base alla mappa URL.

Prima di iniziare

Prima di seguire questa guida, acquisisci familiarità con quanto segue:

• Panoramica dei gruppi di endpoint di rete internet, che include le limitazioni.

• Backend esterni specificati tramite NEG internet

Autorizzazioni

Per seguire questa guida, devi creare un gruppo di endpoint della rete internet (NEG) e creare o modificare un bilanciatore del carico delle applicazioni esterno in un progetto. Devi essere un proprietario o un editor del progetto oppure dovresti avere entrambi i seguenti ruoli IAM di Compute Engine.

Attività	Ruolo richiesto
Creazione e modifica dei componenti del bilanciatore del carico	Amministratore rete
Creare e modificare NEG	Amministratore istanze Compute

Configura un bilanciatore del carico con un backend esterno

Questa sezione mostra come configurare e testare un NEG internet.

Panoramica della configurazione

La configurazione di un NEG internet prevede le seguenti operazioni:

• Definizione dell'endpoint internet in un NEG internet.
• Aggiunta di un NEG internet come backend per un servizio di backend.
• Definisci il traffico degli utenti da mappare a questo servizio di backend configurando la mappa URL del bilanciatore del carico delle applicazioni esterno.
• Inserire gli intervalli IP necessari nella lista consentita.

In questo esempio vengono create le risorse seguenti:

• Una regola di forwarding con l'indirizzo IP 120.1.1.1 indirizza le richieste in entrata a un proxy di destinazione.
• Il valore networkTier della regola di forwarding deve essere PREMIUM.
• Il proxy di destinazione controlla ogni richiesta in base alla mappa URL per determinare il servizio di backend appropriato per la richiesta.
• Per i backend esterni, il proxy di destinazione deve essere TargetHttpProxy o TargetHttpsProxy. In questo esempio viene utilizzato TargetHttpsProxy.
• Cloud CDN abilitato (facoltativo) sul servizio di backend consente la memorizzazione nella cache e la gestione delle risposte dalle cache di Cloud CDN.
• Questo esempio include un'intestazione personalizzata, necessaria quando il backend esterno prevede un valore specifico per l'intestazione Host della richiesta HTTP.

La configurazione è la seguente.

Figura 2. Cloud CDN con un backend on-premise.

Crea il NEG e l'endpoint internet

Console

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

   Vai a Gruppi di endpoint di rete

2. Fai clic su Crea gruppo di endpoint di rete.
3. Inserisci il nome del gruppo di endpoint di rete: example-fqdn-neg.
4. In Tipo di gruppo di endpoint di rete, seleziona Gruppo di endpoint di rete (Internet).
5. In Porta predefinita, inserisci 443.
6. In Nuovo endpoint di rete, seleziona Porta e nome di dominio completi.
7. Per il nome di dominio completo, inserisci backend.example.com.
8. In Tipo di porta, seleziona Predefinito e verifica che Numero porta sia 443.
9. Fai clic su Crea.

gcloud

1. Crea un NEG internet e imposta --network-endpoint-type su internet-fqdn-port (il nome host e la porta dove è possibile raggiungere il backend esterno):

   gcloud compute network-endpoint-groups create example-fqdn-neg \
       --network-endpoint-type="internet-fqdn-port" --global
   

2. Aggiungi l'endpoint al NEG. Se non viene specificata alcuna porta, per impostazione predefinita viene selezionata la porta 80 (HTTP) o 443 (HTTPS; HTTP/2), a seconda del protocollo configurato nel servizio di backend. Assicurati di includere il flag --global:

   gcloud compute network-endpoint-groups update example-fqdn-neg \
       --add-endpoint="fqdn=backend.example.com,port=443" \
       --global
   

3. Elenca il NEG internet creato:

   gcloud compute network-endpoint-groups list --global
   

   Output:

   NAME                LOCATION   ENDPOINT_TYPE        SIZE
   example-fqdn-neg    global     INTERNET_FQDN_PORT   1
   

4. Elenca l'endpoint in quel NEG:

   gcloud compute network-endpoint-groups list-network-endpoints example-fqdn-neg \
       --global
   

   Output:

   INSTANCE   IP_ADDRESS   PORT   FQDN
                                  backend.example.com
   

Aggiungi un backend esterno a un bilanciatore del carico

L'esempio seguente aggiorna un bilanciatore del carico esistente.

Nel bilanciatore del carico esistente, il servizio predefinito è un servizio Google Cloud. L'esempio modifica la mappa URL esistente aggiungendo un matcher percorso che invia tutte le richieste per cart/id/1223515 al servizio di backend images, che è associato al NEG internet.

Console

Crea il servizio di backend e aggiungi il NEG internet

1. Nella console Google Cloud, vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Per aggiungere il servizio di backend a un bilanciatore del carico esistente, seleziona l'Application Load Balancer classico, fai clic su Menu, quindi seleziona Modifica.
3. Fai clic su Configurazione backend.
4. Nel menu Servizi e bucket di backend, seleziona Crea un servizio di backend.
5. Imposta il nome del servizio di backend su images.
6. In Tipo di backend, seleziona Gruppo di endpoint di rete internet.
7. Seleziona il protocollo che intendi utilizzare dal bilanciatore del carico al NEG internet. Per questo esempio, seleziona HTTPS.
8. In Nuovo backend > Gruppo di endpoint di rete internet, seleziona example-fqdn-neg e fai clic su Fine.
9. Seleziona Abilita Cloud CDN.
10. (Facoltativo) Modifica le impostazioni di modalità cache e TTL.
11. In Configurazioni avanzate, in Intestazioni delle richieste personalizzate, fai clic su Aggiungi intestazione.
    1. In Nome intestazione, inserisci Host.
    2. In Valore intestazione, inserisci backend.example.com.
12. Fai clic su Crea.
13. Tieni la finestra aperta per continuare.

Collega il servizio di backend a una mappa URL esistente

1. Fai clic su Regole host e percorso.
2. La prima riga o le prime righe contengono i servizi Google Cloud nella colonna di destra e una di queste contiene già la regola predefinita Any unmatched (default) per Host e Percorsi.
3. Assicurati che sia presente una riga con images selezionata nella colonna di destra. Se non esiste, fai clic su Aggiungi regola host e percorso e seleziona images. Compila gli altri campi come segue:
   1. In Host, inserisci *.
   2. In Percorsi, inserisci /cart/id/1223515.

Esamina e finalizza

1. Fai clic su Esamina e finalizza.
2. Confronta le tue impostazioni con ciò che volevi creare.
3. Se è tutto a posto, fai clic su Aggiorna.

gcloud

1. Crea un nuovo servizio di backend per il NEG:

   gcloud compute backend-services create images \
      --global \
      --enable-cdn \
      --cache-mode=CACHE_MODE \
      --protocol=HTTP2
   

   Imposta la modalità cache sostituendo CACHE_MODE con uno dei seguenti valori:

   • CACHE_ALL_STATIC: memorizza automaticamente nella cache i contenuti statici

   • USE_ORIGIN_HEADERS (impostazione predefinita): richiede che l'origine imposti intestazioni di memorizzazione nella cache valide per memorizzare i contenuti nella cache

   • FORCE_CACHE_ALL: memorizza nella cache tutti i contenuti, ignorando eventuali istruzioni private, no-store o no-cache nelle intestazioni della risposta Cache-Control

2. Configura il servizio di backend per aggiungere l'intestazione della richiesta personalizzata Host: backend.example.com alla richiesta:

   gcloud compute backend-services update images \
      --custom-request-header "Host: backend.example.com" --global
   

3. Usa il comando backend-services add-backend per aggiungere il NEG internet al servizio di backend:

   gcloud compute backend-services add-backend images \
     --network-endpoint-group "example-fqdn-neg" \
     --global-network-endpoint-group \
     --global
   

4. Associa il nuovo servizio di backend alla mappa URL del bilanciatore del carico creando una nuova regola di corrispondenza per indirizzare le richieste al backend:

   gcloud compute url-maps add-path-matcher EXAMPLE_URL_MAP \
     --default-service=GCP_SERVICE_EXAMPLE \
     --path-matcher-name=CUSTOM_ORIGIN_PATH_MATCHER_EXAMPLE \
     --backend-service-path-rules=/CART/ID/1223515=IMAGES
   

   Sostituisci quanto segue:

   • EXAMPLE_URL_MAP: il nome della mappa URL esistente
   • GCP_SERVICE_EXAMPLE: il nome di un servizio di backend predefinito esistente
   • CUSTOM_ORIGIN_PATH_MATCHER_EXAMPLE: il nome della nuova regola del percorso
   • /CART/ID/1223515: il percorso
   • IMAGES: il nome del nuovo servizio di backend con il NEG internet collegato

Inserisci gli intervalli IP necessari nella lista consentita

Per consentire a un bilanciatore del carico delle applicazioni esterno di inviare richieste al tuo NEG internet, devi eseguire una query sul record TXT DNS _cloud-eoips.googleusercontent.com utilizzando uno strumento come dig o nslookup.

Ad esempio, esegui il comando dig seguente:

dig TXT _cloud-eoips.googleusercontent.com | grep -Eo 'ip4:[^ ]+' | cut -d':' -f2

L'output contiene due intervalli IP, come segue:

34.96.0.0/20
34.127.192.0/18

Attenzione: questi intervalli IP sono soggetti a modifica.

Prendi nota degli intervalli IP e assicurati che siano consentiti dal firewall o dall'elenco di controllo dell'accesso (ACL) del cloud.

Per maggiori informazioni, consulta Autenticazione delle richieste.

Connetti il tuo dominio al bilanciatore del carico

Dopo aver creato il bilanciatore del carico, prendi nota dell'indirizzo IP associato al bilanciatore del carico, ad esempio 30.90.80.100. Per puntare il tuo dominio al bilanciatore del carico, crea un record A utilizzando il servizio di registrazione del dominio. Se hai aggiunto più domini al certificato SSL, devi aggiungere un record A per ciascuno, tutti puntati all'indirizzo IP del bilanciatore del carico. Ad esempio, per creare i record A per www.example.com e example.com, utilizza quanto segue:

NAME                  TYPE     DATA
www                   A        30.90.80.100
@                     A        30.90.80.100

Se utilizzi Cloud DNS come provider DNS, consulta Aggiungere, modificare ed eliminare record.

Testa il bilanciatore del carico delle applicazioni esterno

Nota: la propagazione della configurazione del bilanciatore del carico a livello globale potrebbe richiedere alcuni minuti dopo il primo deployment.

Ora che hai configurato il bilanciatore del carico, puoi iniziare a inviare traffico all'indirizzo IP del bilanciatore del carico. Se hai configurato un dominio, puoi inviare traffico anche al nome di dominio. Tuttavia, il completamento della propagazione DNS può richiedere del tempo, quindi puoi iniziare utilizzando l'indirizzo IP per i test.

1. Nella console Google Cloud, vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul bilanciatore del carico che hai appena creato.

3. Prendi nota dell'indirizzo IP del bilanciatore del carico.

4. Se hai creato un bilanciatore del carico HTTP, puoi testarlo utilizzando un browser web all'indirizzo http://IP_ADDRESS. Sostituisci IP_ADDRESS con l'indirizzo IP del bilanciatore del carico. Il sistema ti reindirizzerà alla home page del servizio helloworld.

   Se hai creato un bilanciatore del carico HTTPS, puoi testarlo utilizzando un browser web all'indirizzo https://IP_ADDRESS. Sostituisci IP_ADDRESS con l'indirizzo IP del bilanciatore del carico. Il sistema ti reindirizzerà alla home page del servizio helloworld.

   Se non funziona e stai utilizzando un certificato gestito da Google, verifica che lo stato della risorsa di certificato sia ATTIVO. Per ulteriori informazioni, vedi Stato delle risorse del certificato SSL gestito da Google.

   In alternativa, puoi utilizzare curl dalla riga di comando della macchina locale. Sostituisci IP_ADDRESS con l'indirizzo IPv4 del bilanciatore del carico.

   Se utilizzi un certificato gestito da Google, verifica il dominio che punta all'indirizzo IP del bilanciatore del carico. Ad esempio:

   curl -s 'https://www.example.com:443' --resolve www.example.com:443:IP_ADDRESS
   

5. (Facoltativo) Se utilizzi un dominio personalizzato, potresti dover attendere la propagazione delle impostazioni DNS aggiornate. Quindi, verifica il tuo dominio (ad esempio, backend.example.com) nel browser web.

   Per assistenza con la risoluzione dei problemi, consulta Risolvere i problemi relativi a backend esterno e NEG internet.

Disabilita Cloud CDN

Console

1. Nella console Google Cloud, vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico.

2. Fai clic sul nome del bilanciatore del carico da modificare.

3. Fai clic su Modifica.

4. Fai clic su Configurazione backend.

5. Per il servizio di backend con il backend NEG internet, fai clic su Modifica.

6. Deseleziona la casella di controllo Abilita Cloud CDN.

7. Per esaminare le modifiche, fai clic su Rivedi e finalizza e poi su Aggiorna.

gcloud

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --no-enable-cdn

La disattivazione di Cloud CDN non invalida né elimina definitivamente le cache. Se disattivi e riattivi Cloud CDN, la maggior parte o tutti i contenuti memorizzati nella cache potrebbero comunque essere memorizzati nella cache. Per impedire l'utilizzo dei contenuti nelle cache, devi relativarli.

Passaggi successivi

• Per verificare se Cloud CDN sta fornendo risposte dalla cache, consulta Log e metriche per la memorizzazione nella cache.
• Per informazioni sui contenuti che è possibile memorizzare nella cache o meno, consulta Panoramica della memorizzazione nella cache.
• Per trovare i punti di presenza dei GFE, consulta Località della cache.