Configurazione di NEG a livello di zona

Questo documento contiene le istruzioni per configurare i gruppi di endpoint di rete (NEG) a livello di zona. Prima di configurare i NEG zonali, leggi la panoramica dei gruppi di endpoint di rete.

Nota: questa pagina descrive come configurare un componente o una funzionalità specifica del bilanciatore del carico prima o dopo averlo già creato. L'utilizzo di componenti specifici è utile per le configurazioni avanzate e necessario per alcune opzioni di configurazione. Prima di utilizzare le informazioni in questa pagina, scopri il tipo di Google Cloud bilanciatore del carico di cui hai bisogno.

NEG a livello di zona con endpoint GCE_VM_IP

Questi possono essere utilizzati come backend per i servizi di backend nei bilanciatori del carico di rete passthrough interni e nei bilanciatori del carico di rete passthrough esterni. Per maggiori dettagli, consulta Panoramica dei NEG di zona: bilanciamento del carico.

Per esempi end-to-end, vedi quanto segue:

• Configura un bilanciatore del carico di rete passthrough interno con backend NEG di zona
• Configura un bilanciatore del carico di rete passthrough esterno con backend NEG di zona

NEG a livello di zona con endpoint GCE_VM_IP_PORT

Questi possono essere utilizzati come backend per i servizi di backend nei seguenti tipi di bilanciatori del carico:

• Bilanciatore del carico delle applicazioni esterno
• Bilanciatore del carico delle applicazioni interno
• Bilanciatore del carico di rete proxy esterno
• Bilanciatore del carico di rete proxy interno
  • Esempio end-to-end: configura un bilanciatore del carico di rete proxy interno regionale con backend NEG di zona.

Il caso d'uso principale dei NEG di zona GCE_VM_IP_PORT è il bilanciamento del carico nativo del container, in modo da poter distribuire il traffico tra i microservizi in esecuzione nei container sulle tue VM. Il bilanciamento del carico nativo del container consente ai bilanciatori del carico di indirizzare direttamente i pod e di prendere decisioni di distribuzione del carico a livello di pod anziché a livello di VM.

Esistono due modi per configurare il bilanciamento del carico nativo del container: utilizzare i NEG gestiti da GKE Ingress o utilizzare i NEG standalone.

Per istruzioni, vedi:

• Bilanciamento del carico nativo del container tramite Ingress
• Bilanciamento del carico nativo del container tramite NEG standalone a livello di zona

Configurazione di NEG a livello di zona

Il resto di questa pagina descrive come configurare i NEG zonali prima o dopo aver creato un bilanciatore del carico. Tieni presente che alcune di queste azioni non si applicano alle NEG zonali create e gestite da Ingress.

Crea un gruppo di endpoint di rete a livello di zona

Console

Per creare un gruppo di endpoint di rete a livello di zona:

1. Vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
   Vai alla pagina Gruppi di endpoint di rete
   
2. Fai clic su Crea gruppo di endpoint di rete.
3. Per Tipo di gruppo di endpoint di rete, seleziona Tipo di endpoint di rete: zonale.
4. Inserisci il nome del gruppo di endpoint di rete.
5. Per Tipo di endpoint di rete, seleziona Gruppo di endpoint di rete (a livello di zona).
6. Seleziona il Tipo di endpoint a seconda del tipo di bilanciatore del carico che stai utilizzando.
7. Seleziona la rete.
8. Seleziona la subnet.
9. Seleziona la zona.
10. Per i NEG di zona con solo endpoint GCE_VM_IP_PORT, inserisci una porta predefinita.
11. Fai clic su Crea.

gcloud

Crea un NEG di zona GCE_VM_IP_PORT

gcloud compute network-endpoint-groups create NEG_NAME \
    --zone=ZONE \
    --network=NETWORK
    [--subnet=SUBNET]
    [--default-port=DEFAULT_PORT]

In questo comando, i flag sono definiti come segue:

• NEG_NAME è il nome del nuovo gruppo di endpoint di rete. Il nome deve essere univoco all'interno della zona.
• ZONE è il nome della zona in cui viene creato il NEG.
• NETWORK è il nome della rete in cui viene creato il NEG. Se omesso, Google Cloud utilizza una rete denominata default.
• SUBNET è il nome della subnet a cui appartengono gli endpoint di rete. Questo flag è facoltativo se la rete è una rete VPC in modalità automatica. Se omesso, il NEG si trova nella subnet creata automaticamente della regione della zona selezionata. Il flag è obbligatorio se la rete è un VPC in modalità personalizzata o se devi specificare una subnet creata manualmente.
• DEFAULT_PORT è la porta predefinita associata al NEG. Questo flag è facoltativo. Se omesso, tutti gli endpoint devono essere specificati da IP:porta. Se inclusa, la parte port può essere omessa dalla specifica dell'endpoint e viene presunta la porta predefinita.

Crea un NEG di zona GCE_VM_IP

Per creare un gruppo di endpoint di rete zonale GCE_VM_IP devi specificare network-endpoint-type come mostrato di seguito: gcloud compute network-endpoint-groups create

gcloud compute network-endpoint-groups create NEG_NAME \
    --network-endpoint-type=gce-vm-ip \
    --zone=ZONE \
    --network=NETWORK
    --subnet=SUBNET

In questo comando, i flag sono definiti come segue:

• NEG_NAME è il nome del nuovo gruppo di endpoint di rete. Il nome deve essere univoco all'interno della zona.
• ZONE è il nome della zona in cui viene creato il NEG.
• NETWORK è il nome della rete in cui viene creato il NEG.
• SUBNET è il nome della subnet a cui appartengono gli endpoint di rete.

Aggiungi endpoint a un gruppo di endpoint di rete

Console

Per aggiungere endpoint a un gruppo di endpoint di rete:

1. Vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
   Vai alla pagina Gruppi di endpoint di rete
   
2. Fai clic sul Nome del gruppo di endpoint di rete a cui vuoi aggiungere endpoint. Viene visualizzata la pagina Dettagli gruppo di endpoint di rete.
3. Nella sezione Endpoint di rete in questo gruppo, fai clic su Aggiungi endpoint di rete. Viene visualizzata la pagina Aggiungi endpoint di rete.
4. Seleziona un'istanza VM per aggiungere i relativi indirizzi IP interni come endpoint di rete e fai clic su Aggiungi. Vengono visualizzati l'interfaccia di rete, la zona, la subnet e l'indirizzo IP interno dell'interfaccia VM assegnato all'endpoint.
5. Per i NEG di zona con solo endpoint GCE_VM_IP_PORT, segui questi passaggi:
   1. Inserisci l'indirizzo IP del nuovo endpoint di rete.
   2. Seleziona il Tipo di porta.
      • Se selezioni Predefinito, l'endpoint utilizza la porta predefinita per tutti gli endpoint nel gruppo di endpoint di rete.
      • Se selezioni Personalizzato, inserisci il Numero di porta per l'endpoint da utilizzare.
6. Per aggiungere altri endpoint, fai clic su Aggiungi endpoint di rete e ripeti i passaggi 5 e 6.
7. Dopo aver aggiunto tutti gli endpoint necessari, fai clic su Crea.

gcloud

Aggiungere endpoint a un NEG zonale GCE_VM_IP

Per aggiungere endpoint a un NEG zonale GCE_VM_IP, esegui il comando gcloud compute network-endpoint-groups update.

Aggiungi endpoint IPv4 al gruppo di endpoint di rete:

gcloud compute network-endpoint-groups update NEG_NAME \
    --zone=ZONE \
    --add-endpoint 'instance=INSTANCE_NAME,[ip=IPv4_ADDRESS]' \
    [--add-endpoint ...]

Sostituisci quanto segue:

• NEG_NAME: il nome del NEG
• ZONE: il nome della zona in cui si trova il NEG
• INSTANCE_NAME: il nome della VM a cui appartiene l'indirizzo IP.
• IPv4_ADDRESS: l'indirizzo IPv4 interno principale di un'interfaccia di rete

Se ometti l'indirizzo IP, questo viene selezionato in base all'interfaccia di rete che si trova nella subnet del NEG. Per saperne di più sull'indirizzo IP selezionato, consulta Specifiche dell'endpoint per i NEG di zona GCE_VM_IP.

Aggiungere endpoint a un NEG zonale GCE_VM_IP_PORT

Per aggiungere endpoint a un NEG zonale GCE_VM_IP_PORT, esegui il comando gcloud compute network-endpoint-groups update. Puoi aggiungere endpoint IPv4 ed endpoint dual-stack al NEG zonale GCE_VM_IP_PORT.

Aggiungi endpoint IPv4 al gruppo di endpoint di rete:

gcloud compute network-endpoint-groups update NEG_NAME \
    --zone=ZONE \
    --add-endpoint 'instance=INSTANCE_NAME,[ip=IPv4_ADDRESS],[port=PORT]' \
    [--add-endpoint ...]

Aggiungi endpoint dual-stack al gruppo di endpoint di rete:

gcloud compute network-endpoint-groups update NEG_NAME \
    --zone=ZONE \
    --add-endpoint 'instance=INSTANCE_NAME,[ip=IPv4_ADDRESS],[ipv6=IPv6_ADDRESS],[port=PORT]' \
    [--add-endpoint ...]

Nota: il campo --ip-address-selection-policy nel servizio di backend ti consente di specificare una preferenza per il tipo di traffico inviato dal servizio di backend ai tuoi backend. Per saperne di più, consulta Criterio di selezione degli indirizzi IP.

Sostituisci quanto segue:

• NEG_NAME: il nome del NEG
• ZONE: il nome della zona in cui si trova il NEG
• INSTANCE_NAME: il nome della VM a cui appartiene l'indirizzo IP
• IPv4_ADDRESS: l'indirizzo IPv4 interno principale di un'interfaccia di rete o un indirizzo IPv4 interno dell'intervallo di indirizzi IP alias assegnato a un'interfaccia di rete VM
• IPv6_ADDRESS: qualsiasi indirizzo IPv6 (/128) di un intervallo /96 assegnato a un'interfaccia di rete VM

• PORT: la porta dell'endpoint di rete da aggiungere. La porta è facoltativa se la porta predefinita è specificata nel NEG. Questo campo non è supportato per i NEG di zona con endpoint GCE_VM_IP.

  Se ometti l'indirizzo IP, questo viene selezionato in base all'interfaccia di rete che si trova nella subnet del NEG. Per saperne di più sull'indirizzo IP selezionato, consulta Specifiche dell'endpoint per i NEG di zona GCE_VM_IP_PORT.

Nell'esempio seguente, gli endpoint IPv4 vengono aggiunti a un NEG di zona GCE_VM_IP_PORT:

gcloud compute network-endpoint-groups update my-lb-neg \
    --zone=asia-southeast1-a \
    --add-endpoint 'instance=my-vm1,ip=10.1.1.1,port=80'

Per maggiori dettagli, consulta la panoramica dei gruppi di endpoint di rete zonali.

Aggiungere un NEG zonale a un servizio di backend

Console

Per aggiungere un gruppo di endpoint di rete a un servizio di backend:

1. Vai alla pagina Bilanciamento del carico nella console Google Cloud .
   Vai alla pagina Bilanciamento del carico
2. Fai clic sul nome del bilanciatore del carico di cui vuoi modificare il servizio di backend.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica .
4. Nella pagina Modifica bilanciatore del carico, fai clic su Configurazione backend.
5. Nella pagina Configurazione backend, fai clic su Modifica .
6. Fai clic su + Aggiungi backend.
7. Seleziona un gruppo di endpoint di rete a livello di zona e fai clic su Fine.
8. Fai clic su Aggiorna.

gcloud

Per aggiungere un NEG a un servizio di backend:

gcloud compute backend-services add-backend BACKEND_SERVICE \
     --network-endpoint-group=NETWORK_ENDPOINT_GROUP \
     --network-endpoint-group-zone=ZONE

Ad esempio, per aggiungere un NEG di zona GCE_VM_IP_PORT a un servizio di backend:

gcloud compute backend-services add-backend my-lb \
   --network-endpoint-group my-lb-neg \
   --network-endpoint-group-zone=asia-southeast1-a \
   --global \
   --balancing-mode=RATE \
   --max-rate-per-endpoint=5

Rimuovi un NEG da un servizio di backend

Console

1. Vai alla pagina Bilanciamento del carico nella console Google Cloud .
   Vai alla pagina Bilanciamento del carico
2. Fai clic sul nome del bilanciatore del carico di cui vuoi modificare il servizio di backend.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica .
4. Nella pagina Modifica bilanciatore del carico, fai clic su Configurazione backend.
5. Nella pagina Configurazione backend, fai clic su Modifica per il servizio di backend da cui stai rimuovendo il NEG.
6. Nella sezione Backend, individua il NEG che vuoi rimuovere e fai clic sull'icona del cestino corrispondente.
7. Fai clic su Aggiorna.

gcloud

Per rimuovere un NEG da un servizio di backend:

gcloud compute backend-services remove-backend BACKEND_SERVICE \
    --network-endpoint-group=NETWORK_ENDPOINT_GROUP \
    --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE

Ad esempio:

gcloud compute backend-services remove-backend my-lb \
    --network-endpoint-group=my-lb-neg \
    --network-endpoint-group-zone=asia-southeast1-a

Rimuovere endpoint da un gruppo di endpoint di rete

Quando un endpoint di rete viene rimosso da un NEG di bilanciamento del carico, viene attivato l'interruzione controllata della connessione in base ai parametri di interruzione specificati nel servizio di backend. Se più servizi di backend fanno riferimento allo stesso NEG, viene applicato l'intervallo di svuotamento massimo in tutti i servizi di backend.

Console

Per rimuovere gli endpoint da un gruppo di endpoint di rete:

1. Vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
   Vai alla pagina Gruppi di endpoint di rete
   
2. Fai clic sul nome del gruppo di endpoint di rete da cui vuoi eliminare gli endpoint. Viene visualizzata la pagina Dettagli gruppo di endpoint di rete.
3. Seleziona gli endpoint di rete che vuoi eliminare e fai clic su Rimuovi endpoint.

gcloud

Per rimuovere gli endpoint da un gruppo di endpoint di rete:

gcloud compute network-endpoint-groups update NEG_NAME \
--zone=ZONE \
--remove-endpoint 'instance=INSTANCE_NAME,[ip=IP],[port=PORT]' \
[--remove-endpoint ...]

Ad esempio, per rimuovere un endpoint da un NEG zonale GCE_VM_IP_PORT:

gcloud compute network-endpoint-groups update my-lb-neg \
     --remove-endpoint 'instance=my-vm1,ip=10.1.1.1,port=80' \
     --zone=asia-southeast1-a

Elenca gruppi di endpoint di rete

Console

Per visualizzare un elenco di gruppi di endpoint di rete, vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
Vai alla pagina Gruppi di endpoint di rete

gcloud

Per elencare i gruppi di endpoint di rete:

gcloud compute network-endpoint-groups list

Descrivi un gruppo di endpoint di rete specifico

Console

Per visualizzare i dettagli di un gruppo di endpoint di rete specifico:

1. Vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
   Vai alla pagina Gruppi di endpoint di rete
   
2. Fai clic sul nome del gruppo di endpoint di rete di cui vuoi visualizzare i dettagli.

gcloud

Per visualizzare i dettagli di un gruppo di endpoint di rete specifico:

gcloud compute network-endpoint-groups describe NEG_NAME \
    --zone=ZONE

Sostituisci quanto segue:

• NEG_NAME: il nome del gruppo di endpoint di rete
• ZONE: il nome facoltativo della zona in cui è stato creato il NEG.

Ad esempio, il seguente comando gcloud elenca le informazioni sul gruppo di endpoint di rete my-lb-neg.

gcloud compute network-endpoint-groups describe my-lb-neg \
    --zone=asia-southeast1-a

L'output del comando è il seguente:

    creationTimestamp: '2018-04-09T14:51:34.381-07:00'
    id: '5260475207627726473'
    kind: compute#networkEndpointGroup
    loadBalancer:
      defaultPort: 80
      network: https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/networks/default
      zone: https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/asia-southeast1-a

Rimuovi gruppi di endpoint di rete

Un gruppo di endpoint di rete non può essere eliminato se è collegato a un servizio di backend. Prima di eliminare un NEG, assicurati che sia scollegato dal servizio di backend.

L'eliminazione di una VM comporta immediatamente la rimozione di tutti gli endpoint di rete sulla VM dal NEG, chiudendo tutte le connessioni. L'eliminazione di un NEG dopo l'eliminazione di un servizio di backend rimuove anche tutti gli endpoint nel NEG senza svuotamento della connessione.

Console

Per rimuovere un gruppo di endpoint di rete da un servizio di backend:

1. Vai alla pagina Bilanciamento del carico nella console Google Cloud .
   Vai alla pagina Bilanciamento del carico
2. Fai clic sul nome del bilanciatore del carico di cui vuoi modificare il servizio di backend.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica .
4. Nella pagina Modifica bilanciatore del carico, fai clic su Configurazione backend.
5. Nella pagina Configurazione backend, fai clic su Modifica per il servizio di backend da cui stai rimuovendo il NEG.
6. Nella sezione Backend, individua il NEG che vuoi rimuovere e fai clic sull'icona del cestino corrispondente.
7. Fai clic su Aggiorna.

Per eliminare un gruppo di endpoint di rete:

1. Vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
   Vai alla pagina Gruppi di endpoint di rete
   
2. Individua il gruppo di endpoint di rete che vuoi eliminare.
3. Fai clic sull'icona del cestino nella riga.

gcloud

Per rimuovere un gruppo di endpoint di rete da un servizio di backend:

gcloud compute backend-services remove-backend BACKEND_SERVICE \
     --network-endpoint-group=NETWORK_ENDPOINT_GROUP \
     --network-endpoint-group-zone=ZONE

Per eliminare un gruppo di endpoint di rete:

gcloud compute network-endpoint-groups delete NEG_NAME \
    --zone=ZONE

Ad esempio:

gcloud compute backend-services remove-backend my-neg-backend \
    --network-endpoint-group=my-lb-neg \
    --network-endpoint-group-zone=southeast1-a

gcloud compute network-endpoint-groups delete my-lb-neg \
    --zone=asia-southeast1-a

Elenca gli endpoint in un gruppo di endpoint di rete

Console

Per visualizzare un elenco di endpoint in un gruppo di endpoint di rete:

1. Vai alla pagina Gruppi di endpoint di rete nella console Google Cloud .
   Vai alla pagina Gruppi di endpoint di rete
   
2. Fai clic sul nome del gruppo di endpoint di rete da cui vuoi eliminare gli endpoint. Viene visualizzata la pagina Dettagli gruppo di endpoint di rete, in cui sono elencati gli endpoint per il gruppo di endpoint.
3. Per filtrare gli endpoint, crea coppie chiave:valore nel campo di testo sotto Endpoint di rete in questo gruppo.

gcloud

Per elencare tutti gli endpoint di rete in un gruppo di endpoint di rete:

gcloud compute network-endpoint-groups list-network-endpoints NEG_NAME \
     --zone=ZONE

Filtro personalizzato quando elenchi gli endpoint in un gruppo di endpoint di rete

Puoi utilizzare un filtro personalizzato per limitare gli endpoint di un gruppo di endpoint di rete elencati. Il filtro personalizzato è abilitato solo per l'API REST. Non puoi utilizzare il filtro personalizzato dalla console Google Cloud o utilizzando l'interfaccia a riga di comando gcloud.

Per maggiori dettagli, consulta la documentazione relativa al metodo networkEndpointGroups.listNetworkEndpoints.

Controllo di integrità degli endpoint di rete

I servizi di backend con backend NEG di zona devono utilizzare un controllo di integrità la cui specifica della porta è:

• una porta fissa (numerata) (--port)
• configurato per utilizzare la porta di gestione dell'endpoint di rete (--use-serving-port)

L'esempio seguente crea un controllo di integrità HTTP che utilizza la porta di pubblicazione dell'endpoint di rete con il flag --use-serving-port. Tieni presente che il flag --use-serving-port è implementato con gcloud compute health-checks create, ma non con gcloud compute health-checks update.

gcloud compute health-checks create http HTTP_HEALTH_CHECK_NAME
    --use-serving-port

Non puoi utilizzare un controllo di integrità legacy con un backend NEG di zona. Per saperne di più, consulta Concetti dei controlli di integrità.