Un pool di destinazione è un gruppo di istanze di backend che ricevono traffico in entrata dai bilanciatori del carico di rete passthrough esterni. Tutte le istanze di backend di un pool di destinazione devono trovarsi nella stessa regione Google Cloud. I bilanciatori del carico di rete passthrough esterni possono utilizzare un servizio di backend o un pool di destinazione per definire il gruppo di istanze di backend. Se stai creando nuovi bilanciatori del carico di rete passthrough esterni, ti consigliamo di utilizzare i servizi di backend.
In questa pagina vengono descritte le opzioni di configurazione per i backend del pool di destinazione. Quando la regola di forwarding di un bilanciatore del carico di rete passthrough esterno indirizza il traffico a un pool di destinazione, il bilanciatore del carico sceglie un'istanza dal pool di destinazione in base a un hash dell'indirizzo IP di origine, della porta di origine, dell'indirizzo IP di destinazione e della porta di destinazione.
Se vuoi che il pool di destinazione contenga una singola macchina virtuale (VM), valuta la possibilità di utilizzare la funzionalità di inoltro del protocollo anziché il bilanciamento del carico.
Proprietà del pool di destinazione
I pool di destinazione funzionano con le regole di forwarding che gestiscono il traffico TCP
e UDP
. Devi creare un pool di destinazione prima di poterlo utilizzare con una regola di forwarding.
I pool di destinazione utilizzano i controlli di integrità HTTP legacy.
Un pool di destinazione è costituito dalle seguenti proprietà:
name
- Il nome di questo pool di destinazione. Il nome deve essere univoco in questo progetto, deve avere una lunghezza compresa tra 1 e 63 caratteri e corrispondere all'espressione regolare:
[a-z]([-a-z0-9]*[a-z0-9])?
, il che significa che il primo carattere deve essere una lettera minuscola e tutti i caratteri successivi devono essere trattini, lettere minuscole o cifre, tranne l'ultimo, che non può essere un trattino. description
- Facoltativo. Una descrizione definita dall'utente di questo pool di destinazione.
region
L'URL completo della regione del pool di destinazione. La regione deve essere la stessa in cui si trovano le istanze di backend. Ad esempio:
"region" : "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION"
healthChecks[ ]
Facoltativo. Un elenco facoltativo di controlli di integrità per questo pool di destinazione. È possibile collegare un solo controllo di integrità a un determinato pool di destinazione. Per ulteriori informazioni, consulta Controllo di integrità.
instances[ ]
Un elenco di URL di istanza che devono gestire il traffico per questo pool di destinazione. Tutte le istanze devono trovarsi nella stessa regione del pool di destinazione, ma le istanze possono appartenere a zone diverse all'interno di una singola regione. Ad esempio:
"instances" : [ "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE", "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE-2" ]
sessionAffinity
Facoltativo. Controlla il metodo utilizzato per selezionare un'istanza di macchina virtuale backend. Puoi impostare questo valore solo durante la creazione del pool di destinazione. Una volta impostato, non puoi modificare questo valore. Il metodo di hash seleziona un backend in base a un sottoinsieme dei seguenti 5 valori:
- IP di origine / destinazione
- Porta di origine / destinazione
- Protocollo di livello 4 (TCP, UDP)
Gli hash possibili sono:
NONE
(ovvero nessun hash specificato) (impostazione predefinita)- Hashing a 5 tuple, che utilizza gli IP di origine e di destinazione, le porte di origine e di destinazione e il protocollo. Ogni nuova connessione può finire su qualsiasi istanza, ma tutto il traffico per una determinata connessione rimarrà nella stessa istanza, se quest'ultima rimane integro.
CLIENT_IP_PROTO
- Hashing a tre tuple, che utilizza gli IP di origine e di destinazione e il protocollo. Tutte le connessioni da un client finiranno sulla stessa istanza, purché utilizzino lo stesso protocollo e l'istanza rimanga integra.
CLIENT_IP
- Hashing a due tuple, che utilizza gli IP di origine e di destinazione. Tutte le connessioni da un client finiranno nella stessa istanza, indipendentemente dal protocollo, purché l'istanza rimanga integro.
L'hashing a 5 tuple fornisce una buona distribuzione del traffico su molte macchine virtuali. Tuttavia, una seconda sessione dello stesso client potrebbe arrivare su un'istanza diversa perché la porta di origine potrebbe cambiare. Se vuoi che tutte le sessioni dello stesso client raggiungano lo stesso backend, purché rimanga integro, puoi specificare le opzioni
CLIENT_IP_PROTO
oCLIENT_IP
.In generale, se selezioni un metodo a 3 o 2 tuple, questo fornirà una migliore affinità sessione rispetto al metodo predefinito a 5 tuple, ma il traffico complessivo potrebbe non essere distribuito uniformemente.
Pacchetti UDP frammentati: se devi bilanciare il carico del traffico UDP che è probabile sia frammentato, imposta l'affinità sessione su
CLIENT_IP_PROTO
oCLIENT_IP
. Non utilizzareNONE
(hashing a 5 tuple). Questo perché i frammenti UDP diversi dal primo non includono il numero di porta e il bilanciatore del carico potrebbe eliminare i frammenti senza la porta. Per ulteriori informazioni, consulta Bilanciamento del carico e pacchetti UDP frammentati.backupPool
Facoltativo. Un URL completo a un'altra risorsa del pool di destinazione. Un pool di backup è un pool di destinazione a cui fa riferimento un altro pool di destinazione. Per utilizzare questa funzionalità, devi anche definire
failoverRatio
. Se il rapporto di macchine virtuali integre nel pool di destinazione è inferiore afailoverRatio
, il bilanciatore del carico di rete passthrough esterno invia il traffico al pool di backup. Puoi fornire un solo pool di backup per pool di destinazione. Il pool di backup deve trovarsi nella stessa regione del pool di destinazione. Se il rapporto di istanze integre nel pool di destinazione è inferiore al rapporto di failover configurato, il bilanciatore del carico di rete passthrough esterno utilizza le seguenti regole per instradare il traffico:- Se il rapporto tra istanze integre e istanze totali nel pool di destinazione è inferiore al rapporto di failover, il traffico viene inviato alle istanze integre nel pool di backup.
- Se il rapporto tra istanze integre e istanze totali nel pool di destinazione è inferiore al rapporto di failover, ma nel pool di backup non sono presenti istanze integre rimanenti, il traffico viene inviato alle istanze integre rimanenti nel pool di destinazione.
- Se il pool di destinazione non è vuoto e se tutte le istanze nel pool di destinazione e in quello di backup non superano i controlli di integrità, il traffico viene inviato a tutte le istanze nel pool di destinazione, come ultima risorsa.
- Se il pool di destinazione è vuoto e se tutte le istanze nel pool di backup non superano i controlli di integrità, il traffico viene inviato a tutte le istanze del pool di backup, come ultima risorsa.
È supportato un solo livello di failover. Ad esempio, se il pool di destinazione A ha il pool di backup B e il pool di backup B ha il pool di backup C, il traffico destinato al pool di destinazione A può essere indirizzato solo al pool di backup B e non al pool di backup C.
failoverRatio
Facoltativo. Un numero in virgola mobile tra
0.0
e1.0
, che determina quando questo pool di destinazione viene dichiarato non integro. Ad esempio, se questo valore è impostato su0.1
, questo pool di destinazione viene dichiarato non integro se il numero di istanze integre è inferiore a0.1
(10%). Se il rapporto di failover è0.0
, almeno un backend deve essere integro affinché il pool sia considerato integro. Se il rapporto di failover è impostato su1.0
, tutte le istanze devono essere in stato integro affinché il pool sia considerato integro. Devi definire questo campo se definisci il campobackupPool
.
Condizioni di failover
Condizioni | Le nuove connessioni vanno a |
---|---|
Rapporto di failover !=0, VM integre nel pool di destinazione >= FR | pool di destinazione |
Rapporto di failover =0, VM integre nel pool di destinazione > 0 | pool di destinazione |
Rapporto di failover !=0, VM integre nel pool di destinazione < FR e almeno una VM nel pool di backup è integro | pool di backup |
Rapporto di failover =0, VM integre nel pool di destinazione = 0 e almeno una VM nel pool di backup è integro | pool di backup |
Almeno una VM si trova nel pool di destinazione, tutte le VM nel pool di destinazione sono in stato non integro e tutte le VM nel pool di backup sono in stato non integro | pool di destinazione (ultima risorsa) |
Nessuna VM si trova nel pool di destinazione e tutte le VM nel pool di backup sono in stato non integro | pool di backup (ultima risorsa) |
Nessuna VM si trova nel pool di destinazione e nessuna VM si trova nel pool di backup | Il traffico è diminuito |
Creare un pool di destinazione
Console
Non è possibile creare pool di destinazione nella console Google Cloud. Puoi creare un pool di destinazione utilizzando Google Cloud CLI o l'API.
Per scoprire come creare un bilanciatore del carico di rete passthrough esterno basato su pool di destinazione utilizzando Google Cloud CLI, consulta Configurare un bilanciatore del carico di rete passthrough esterno con un pool di destinazione.
gcloud
Per utilizzare gcloud compute
per creare un pool di destinazione, usa il comando target-pools
create
:
gcloud compute target-pools create TARGET_POOL \ [--backup-pool=BACKUP_POOL] \ [--description=DESCRIPTION] \ [--failover-ratio=FAILOVER_RATIO] \ [--http-health-check=HEALTH_CHECK] \ [--region=REGION] [--session-affinity=SESSION_AFFINITY; default="NONE"]
Sostituisci quanto segue:
TARGET_POOL
: un nome per il pool di destinazioneBACKUP_POOL
: un nome per il pool di destinazione di backupDESCRIPTION
: una descrizione del pool di destinazioneFAILOVER_RATIO
: un valore compreso tra 0,0 e 1,0, che determina quando il pool di destinazione viene dichiarato non integroHEALTH_CHECK
: un controllo di integrità per questo pool di destinazioneREGION
: una regione del pool di destinazioneSESSION_AFFINITY
: il metodo utilizzato per selezionare un'istanza di macchina virtuale backend
API
Per creare un pool di destinazione nell'API, effettua una richiesta HTTP POST
al seguente URI:
https://www.googleapis.com/v1/compute/projects/PROJECT_ID/regions/REGION/targetPools { "name": name, "instances": [ "https://www.googleapis.com/v1/compute/project/PROJECT_ID/zones/ZONE/instances/INSTANCE", "https://www.googleapis.com/v1/compute/project/PROJECT_ID/zones/ZONE/instances/INSTANCE-2", ] }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudZONE
: la zona in cui si trovano le istanze del pool di destinazioneINSTANCE
,INSTANCE-2
: le istanze da aggiungere al pool di destinazione
Aggiungi o rimuovi un'istanza da un pool di destinazione
Console
I pool di destinazione non possono essere modificati nella console Google Cloud. Puoi modificare un pool di destinazione utilizzando Google Cloud CLI o l'API.
gcloud
Per utilizzare gcloud compute
per aggiungere istanze a un pool di destinazione, usa il comando target-pools add-instances
:
gcloud compute target-pools add-instances TARGET_POOL \ --instances=INSTANCE,[INSTANCE-2,...]
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazioneINSTANCE
,INSTANCE-2
: il nome dell'istanza (o delle istanze) da aggiungere al pool di destinazione
Per rimuovere le istanze, utilizza il comando target-pools remove-instances
:
gcloud compute target-pools remove-instances TARGET_POOL \ --instances=INSTANCE,[INSTANCE-2,...]
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazioneINSTANCE
,INSTANCE-2
: il nome dell'istanza (o delle istanze) da rimuovere dal pool di destinazione
API
Nell'API, invia una richiesta POST ai seguenti URI:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/removeInstance https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/addInstance
Il corpo della richiesta deve includere gli URI completi delle istanze che vuoi aggiungere o rimuovere:
{ "instances": [ {"instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE"}, {"instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE-2"} ] }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudTARGET_POOL
: il nome del pool di destinazione da aggiornareREGION
: la regione in cui si trova il pool di destinazioneZONE
: la zona in cui si trovano le istanze aggiornateINSTANCE
,INSTANCE-2
: le istanze da aggiungere al pool di destinazione
Per saperne di più, consulta la documentazione di riferimento dell'API per i metodi targetPools.addInstance
e targetPools.removeInstance
.
Elenca pool di destinazione
Console
Per visualizzare un elenco dei pool di destinazione, utilizza il menu avanzato del bilanciamento del carico.
Nella pagina Bilanciamento del carico avanzato, vai alla scheda Pool di destinazione.
Vai a Pool di destinazione
La pagina mostra un elenco di pool di destinazione.
gcloud
Per utilizzare gcloud compute
per elencare i pool di destinazione esistenti, utilizza il
comando target-pools list
:
gcloud compute target-pools list
Per un output più dettagliato, utilizza il comando describe
e specifica un nome per il pool.
API
Nell'API, invia una richiesta GET al seguente URI:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudREGION
: la regione in cui si trova il pool di destinazione
Descrizione di un pool di destinazione
Console
Per ottenere informazioni su un pool di destinazione, utilizza il menu avanzato del bilanciamento del carico.
- Nella pagina Bilanciamento del carico avanzato, vai alla scheda Pool di destinazione.
Vai a Pool di destinazione - Per visualizzare informazioni dettagliate, fai clic sul nome del pool di destinazione.
gcloud
Per utilizzare gcloud compute
al fine di ottenere informazioni su un singolo pool di destinazione, utilizza il comando target-pools describe
:
gcloud compute target-pools describe TARGET_POOL
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazione
API
Nell'API, invia una richiesta GET vuota al seguente URI:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudTARGET_POOL
: il nome del pool di destinazione da aggiornareREGION
: la regione in cui si trova il pool di destinazione
Ottieni lo stato di integrità delle istanze
Console
Per ottenere lo stato di integrità delle istanze in un pool di destinazione, utilizza il menu avanzato del bilanciamento del carico.
- Nella pagina Bilanciamento del carico avanzato, vai alla scheda Pool di destinazione.
Vai a Pool di destinazione - Fai clic sul nome del pool di destinazione.
- La pagina Dettagli pool di destinazione elenca tutte le istanze e il relativo stato di integrità.
gcloud
Per utilizzare gcloud compute
al fine di controllare lo stato di integrità attuale di un'istanza
nel pool di destinazione o di tutte le istanze nel pool di destinazione, puoi utilizzare il
comando gcloud compute target-pools get-health
:
gcloud compute target-pools get-health TARGET_POOL
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazione
Il comando restituisce lo stato di integrità determinato dal controllo di integritàà configurato (in stato integro o non integro).
API
Nell'API, effettua una richiesta POST HTTP al seguente URI con l'istanza specificata nel corpo della richiesta:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/getHealth { "instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE" }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudTARGET_POOL
: il nome del pool di destinazione da aggiornareREGION
: la regione in cui si trova il pool di destinazioneZONE
: la zona in cui si trova l'istanzaINSTANCE
: l'istanza di cui stai controllando lo stato del controllo di integrità
Elimina un pool di destinazione
Per eliminare un pool di destinazione, devi prima assicurarti che le regole di forwarding non facciano riferimento al pool di destinazione. Se una regola di forwarding fa riferimento a un pool di destinazione, devi eliminare la regola per rimuovere il riferimento.
Console
Per utilizzare la console Google Cloud al fine di eliminare un pool di destinazione, utilizza il menu avanzato Bilanciamento del carico.
- Nella pagina Bilanciamento del carico avanzato, vai alla scheda Pool di destinazione.
Vai a Pool di destinazione - Fai clic sul nome del pool di destinazione.
- Fai clic su Elimina.
- Nella finestra Elimina un pool di destinazione, fai clic su Elimina.
gcloud
Per utilizzare gcloud compute
al fine di eliminare un pool di destinazione, utilizza il comando target-pools delete
:
gcloud compute target-pools delete TARGET_POOL
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazione da eliminare
API
Nell'API, invia una richiesta DELETE vuota al seguente URI:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudTARGET_POOL
: il nome del pool di destinazione da aggiornareREGION
: la regione in cui si trova il pool di destinazione
Aggiungi o rimuovi un controllo di integrità da un pool di destinazione
Gli oggetti del controllo di integrità sono risorseglobali autonome che possono essere associate o dissociate da qualsiasi pool di destinazione.
Se a un pool di destinazione non è associato alcun controllo di integrità, il bilanciatore del carico di rete passthrough esterno tratterà tutte le istanze come integre e invierà il traffico a tutte le istanze nel pool di destinazione. Tuttavia, se esegui una query sullo stato di integrità di un pool di destinazione
senza un controllo di integrità, lo stato verrà restituito come unhealthy
per indicare che
il pool di destinazione non dispone di un controllo di integrità. Consigliamo che ai pool di destinazione siano associati controlli di integrità per gestire le istanze.
I bilanciatori del carico di rete passthrough esterni utilizzano i controlli di integrità HTTP legacy per determinare l'integrità delle istanze nel pool di destinazione. Un bilanciatore del carico di rete passthrough esterno può utilizzare solo un controllo di integrità HTTP legacy, non un controllo di integrità HTTPS legacy.
Console
Quando utilizzi la console Google Cloud, puoi creare un controllo di integrità HTTP legacy durante la creazione di un bilanciatore del carico di rete passthrough esterno con un backend del pool di destinazione.
Non puoi utilizzare la pagina Controlli di integrità della console Google Cloud per creare un controllo di integrità legacy autonomo.
gcloud
Per utilizzare gcloud compute
al fine di aggiungere un controllo di integrità a un pool di destinazione, usa il comando target-pools add-health-checks
:
gcloud compute target-pools add-health-checks TARGET_POOL \ --http-health-check=HEALTH_CHECK
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazioneHEALTH_CHECK
: il controllo di integrità HTTP legacy da usare con questo pool di destinazione
Per rimuovere un controllo di integrità, utilizza il comando target-pools remove-health-checks
:
gcloud compute target-pools remove-health-checks TARGET_POOL \ --http-health-check=HEALTH_CHECK
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazioneHEALTH_CHECK
: il controllo di integrità HTTP precedente da rimuovere da questo pool di destinazione
API
Per associare o annullare l'associazione di un controllo di integrità utilizzando l'API, effettua una richiesta HTTP POST
agli URI appropriati:
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/removeHealthCheck https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/addHealthCheck
Il corpo della richiesta deve contenere il controllo di integrità da associare o annullare l'associazione:
{ "healthCheck": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/httpHealthChecks/HEALTH_CHECK" }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudTARGET_POOL
: il nome del pool di destinazione da aggiornareREGION
: la regione in cui si trova il pool di destinazioneHEALTH_CHECK
: il controllo di integrità HTTP precedente da associare o non associare al pool di destinazione.
Per saperne di più, consulta la documentazione di riferimento delle API per targetPools.addHealthCheck
e targetPools.removeHealthCheck
.
Aggiungi o rimuovi un pool di destinazione di backup
Quando crei per la prima volta un pool di destinazione, puoi scegliere di applicare un pool di destinazione di backup che riceve traffico se il pool di destinazione non è integro.
Se non hai mai configurato un pool di destinazione di backup, devi configurare anche i controlli di integrità affinché la funzionalità funzioni correttamente.
Console
I pool di destinazione non possono essere modificati nella console Google Cloud. Puoi modificare un proxy di destinazione utilizzando Google Cloud CLI o l'API.
gcloud
Per utilizzare gcloud compute
per aggiornare la risorsa del pool di backup, usa il comando target-pools set-backup
:
gcloud compute target-pools set-backup TARGET_POOL \ --backup-pool=BACKUP_POOL \ --failover-ratio=FAILOVER_RATIO
Sostituisci quanto segue:
TARGET_POOL
: il nome del pool di destinazioneBACKUP_POOL
: un nome per il pool di destinazione di backupFAILOVER_RATIO
: un valore compreso tra 0,0 e 1,0, che determina quando il pool di destinazione viene dichiarato non integro
API
Per effettuare una richiesta di aggiornamento o rimozione di un pool di backup tramite l'API, invia una richiesta POST al seguente URI:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/setBackup?failoverRatio=FAILOVER_RATIO { "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/BACKUP_POOL" }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google CloudTARGET_POOL
: il nome del pool di destinazione da aggiornareREGION
: la regione in cui si trova il pool di destinazioneBACKUP_POOL
: il nome del pool di backup da associare al pool di destinazioneFAILOVER_RATIO
: il rapporto di failover
Se definisci una destinazione vuota o non definisci un rapporto di failover, il comportamento del pool di backup viene disabilitato per questo pool di destinazione.
Passaggi successivi
- Per saperne di più sui pool di destinazione, consulta la documentazione di riferimento delle API per
targetPools.setBackup
. - Per saperne di più sulle regole di forwarding, consulta Panoramica delle regole di forwarding.