Configurazione di NEG a livello di zona

Questo documento contiene le istruzioni per la configurazione dei gruppi di endpoint di rete (NEG) a livello di zona. Prima di configurare i NEG a livello di zona, 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. Lavorare con 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 regionali. Per i dettagli, consulta Panoramica dei NEG a livello di zona: bilanciamento del carico.

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

• Configura un bilanciatore del carico di rete passthrough interno con backend di NEG a livello di zona
• Configura un bilanciatore del carico di rete passthrough esterno regionale con backend di NEG a livello 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 di NEG a livello di zona.

Il caso d'uso principale per i NEG a livello 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 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 le istruzioni, consulta:

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

Configurazione dei NEG a livello di zona

Il resto di questa pagina descrive come configurare i NEG a livello di zona prima o dopo aver già creato un bilanciatore del carico. Tieni presente che alcune di queste azioni non si applicano ai NEG a livello di zona creati e gestiti 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 Google Cloud console.
   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: a livello di zona.
4. Inserisci il Nome del gruppo di endpoint di rete.
5. In 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. Solo per i NEG a livello di zona con endpoint GCE_VM_IP_PORT, inserisci una Porta predefinita.
11. Fai clic su Crea.

gcloud

Crea un NEG a livello 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 viene utilizzata 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 è una rete 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 incluso, la parte port può essere omessa dalla specifica dell'endpoint e viene presupposta la porta predefinita.

Crea un NEG a livello di zona GCE_VM_IP

Per creare un gruppo di endpoint di rete a livello di zona GCE_VM_IP, devi specificare il network-endpoint-type come mostrato qui: 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 Google Cloud console.
   Vai alla pagina Gruppi di endpoint di rete
   
2. Fai clic sul Nome del gruppo di endpoint di rete a cui vuoi aggiungere gli 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 assegnata all' endpoint.
5. Solo per i NEG a livello di zona con 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 da utilizzare per l'endpoint.
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

Aggiungi endpoint a un NEG a livello di zona GCE_VM_IP

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

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 presente nella subnet del NEG. Per saperne di più sull'indirizzo IP selezionato, consulta Specifiche degli endpoint per i NEG a livello di zonaGCE_VM_IP.

Aggiungi endpoint a un GCE_VM_IP_PORT NEG a livello di zona

Per aggiungere endpoint a un GCE_VM_IP_PORT NEG a livello di zona, esegui il gcloud compute network-endpoint-groups update comando. Puoi aggiungere endpoint IPv4 ed endpoint dual-stack al NEG a livello di zona 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 consente di specificare una preferenza per il tipo di traffico inviato dal servizio di backend ai backend. Per saperne di più, consulta Policy di selezione dell'indirizzo 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 dall'intervallo di indirizzi IP alias assegnato a un'interfaccia di rete VM
• IPv6_ADDRESS: qualsiasi indirizzo IPv6 (/128) da un intervallo /96 assegnato a un'interfaccia di rete VM

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

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

Nell'esempio seguente, gli endpoint IPv4 vengono aggiunti a un NEG a livello 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 Panoramica dei gruppi di endpoint di rete a livello di zona.

Aggiungi un NEG a livello di zona a un servizio di backend

Console

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

1. Nella Google Cloud console, vai alla pagina Bilanciamento del carico.
   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 a livello 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. Nella Google Cloud console, vai alla pagina Bilanciamento del carico.
   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 per quel NEG.
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

Rimuovi endpoint da un gruppo di endpoint di rete

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

Console

Per rimuovere endpoint da un gruppo di endpoint di rete:

1. Vai alla pagina Gruppi di endpoint di rete nella Google Cloud console.
   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 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 a livello di zona 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 Google Cloud console.
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 Google Cloud console.
   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

Non è possibile eliminare un gruppo di endpoint di rete 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 e la chiusura di tutte le connessioni. L'eliminazione di un NEG dopo l'eliminazione di un servizio di backend comporta anche la rimozione di tutti gli endpoint nel NEG senza lo svuotamento della connessione.

Console

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

1. Nella Google Cloud console, vai alla pagina Bilanciamento del carico.
   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 per quel NEG.
7. Fai clic su Aggiorna.

Per eliminare un gruppo di endpoint di rete:

1. Vai alla pagina Gruppi di endpoint di rete nella Google Cloud console.
   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 Google Cloud console.
   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 elencati in un gruppo di endpoint di rete. Il filtro personalizzato è abilitato solo per l'API REST. Non puoi utilizzare il filtro personalizzato dalla Google Cloud console o utilizzando l'interfaccia a riga di gcloud comando.

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

Controlli di integrità degli endpoint di rete

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

• una porta fissa (numerata) (--port)
• configurata 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 gestione dell'endpoint di rete con il flag --use-serving-port. Tieni presente che il --use-serving-port flag viene 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 di NEG a livello di zona. Per saperne di più, consulta Concetti dei controlli di integrità.