Configura il bilanciamento del carico manuale

Il bilanciamento manuale del carico ti consente di configurare le tue soluzioni di bilanciamento del carico per il traffico del control plane e del piano dati in Google Distributed Cloud. A differenza del bilanciamento del carico integrato, in cui Google Distributed Cloud esegue il deployment dei bilanciatori del carico sui nodi del cluster, il bilanciamento del carico manuale richiede la configurazione e la gestione di queste soluzioni in autonomia.

Prima di creare un cluster bare metal, devi configurare un bilanciatore del carico esterno per il control plane. Questo bilanciatore del carico può anche gestire il traffico del piano dati oppure puoi utilizzare un bilanciatore del carico separato per il piano dati, ad esempio un deployment MetalLB in-cluster. Poiché Google Distributed Cloud non esegue il provisioning dei bilanciatori del carico in questa modalità, i servizi LoadBalancer non funzionano finché non configuri il bilanciamento del carico. Questo documento descrive i requisiti di bilanciamento del carico e include un esempio di configurazione che utilizza F5 BIG-IP.

Prerequisiti

Le sezioni seguenti descrivono i prerequisiti per la configurazione del bilanciamento del carico manuale.

Indirizzo IP obbligatorio

Devi pianificare i VIP prima di creare un cluster. Tutti i cluster devono avere un VIP per il control plane. Tutti i cluster utente richiedono un secondo VIP per il servizio in entrata.

Questi VIP possono trovarsi in qualsiasi subnet IPv4 instradabile dal bilanciatore del carico. Il VIP del control plane deve essere raggiungibile da tutti i nodi del cluster e dalla workstation di amministrazione su cui esegui bmctl.

Quando crei il cluster, viene eseguito il deployment del servizio in entrata utilizzando l'indirizzo VIP specificato nel file di configurazione del cluster. Puoi configurare il bilanciamento del carico per questo indirizzo IP dopo la creazione del cluster.

Devi conoscere gli indirizzi IP che utilizzerai per i nodi che verranno utilizzati come nodi del control plane.

Requisiti del bilanciatore del carico del control plane esterno

Il bilanciatore del carico del control plane deve essere configurato prima di creare il cluster. Il bilanciatore del carico del control plane deve soddisfare i seguenti requisiti:

  • Un servizio virtuale (frontend) per il VIP del control plane. La porta di ascolto predefinita del control plane è 443. Tuttavia, se specifichi una porta diversa nel campo loadBalancer.ports.controlPlaneLBPort del file di configurazione del cluster, utilizza quella porta per il servizio virtuale.
  • Un gruppo di backend contenente tutti gli indirizzi IP dei nodi del control plane del cluster. La porta di backend su cui il control plane rimane in ascolto è 6444.
  • Un controllo di integrità che monitora i nodi di backend. Il controllo di integrità deve utilizzare HTTPS e controllare l'endpoint /readyz sulla porta 6444. Il controllo di integrità deve verificare che questo endpoint restituisca il codice di stato 200 per considerare il nodo integro.

Se il bilanciatore del carico esterno non è configurato correttamente, è probabile che il bootstrap del cluster non vada a buon fine. Un controllo preflight verifica che il bilanciatore del carico esterno sia configurato correttamente, incluso il controllo di integrità dell'endpoint /readyz da parte del bilanciatore del carico.

Reimposta le connessioni ai nodi con errori (consigliato)

Oltre ai requisiti precedenti, ti consigliamo di configurare il bilanciatore del carico in modo che reimposti le connessioni client quando rileva un errore del nodo di backend. Senza questa configurazione, i client del server API Kubernetes possono smettere di rispondere per diversi minuti quando un'istanza del server non è disponibile, il che può causare instabilità nel control plane di Kubernetes.

  • Con F5 BIG-IP, questa impostazione è denominata Action On Service Down nella pagina di configurazione del pool di backend.
  • Con HAProxy, questa impostazione è denominata on-marked-down shutdown-sessions nella configurazione del server di backend.
  • Se utilizzi un bilanciatore del carico diverso, consulta la documentazione per trovare l'impostazione equivalente.

Configura il cluster

Prima di creare un cluster Google Distributed Cloud, devi creare un file di configurazione del cluster con bmctl. Modifica questo file per abilitare il bilanciamento manuale del carico nel cluster:

  1. Imposta il campo loadBalancer.mode su manual.
  2. Imposta il campo loadBalancer.vips.controlPlaneVIP sul VIP che hai configurato sul bilanciatore del carico.
  3. Rimuovi o commenta la sezione loadBalancer.addressPools.

Dopo aver modificato il file di configurazione, inclusi i campi non correlati al bilanciamento del carico, verifica che il VIP del control plane sia configurato correttamente sul bilanciatore del carico eseguendo i controlli preflight:

bmctl check preflight -c CLUSTER_NAME

Sostituisci CLUSTER_NAME con il nome del cluster.

Supporta i servizi LoadBalancer nei cluster utente

Devi configurare il bilanciamento del carico per supportare i servizi LoadBalancer di Kubernetes. In modalità di bilanciamento manuale del carico, Google Distributed Cloud non esegue automaticamente il provisioning dei bilanciatori del carico, quindi i servizi LoadBalancer non funzionano a meno che non esegui il provisioning e la configurazione dei bilanciatori del carico in modo che puntino ai servizi.

Inoltre, Google Distributed Cloud esegue automaticamente il deployment di un servizio Ingress in tutti i cluster utente utilizzando un servizio LoadBalancer. Per essere accessibile dall'esterno, questo servizio LoadBalancer richiede un bilanciatore del carico configurato in modo da puntare al servizio.

Le opzioni per supportare i servizi LoadBalancer includono:

  • Configurare manualmente il bilanciatore del carico per ogni servizio LoadBalancer nel cluster. Per un esempio di utilizzo di F5 BIG-IP, consulta Configura il supporto per i servizi LoadBalancer.
  • Installa un controller del bilanciatore del carico nel cluster che configura il bilanciatore del carico esterno quando vengono creati i servizi LoadBalancer.
  • Installa una soluzione di bilanciamento del carico in-cluster come MetalLB.

Bilanciamento manuale del carico con F5 BIG-IP

Questa sezione descrive come configurare il bilanciamento manuale del carico con F5 BIG-IP come bilanciatore del carico esterno. Se utilizzi un bilanciatore del carico diverso, consulta la documentazione relativa a quel bilanciatore del carico e utilizza questi passaggi come modello.

Configura il bilanciatore del carico del control plane

Devi configurare il bilanciatore del carico del control plane prima di creare un cluster. Dopo aver eseguito questi passaggi, puoi configurare il cluster e crearlo.

Crea una partizione per il cluster

Ogni cluster deve avere la propria partizione. Utilizza l'utilità di configurazione BIG-IP per creare una partizione:

  1. Vai a System (Sistema) > Users (Utenti) > Partition List (Elenco partizioni).
  2. Fai clic su Crea.
  3. Inserisci un nome per la partizione.
  4. Fai clic su Fine.

Nei passaggi successivi creerai oggetti in questa partizione. Assicurati che questa partizione sia selezionata nel menu a discesa nell'angolo in alto a destra della UI per ciascuna delle seguenti attività, in modo che ogni oggetto venga creato in questa partizione.

Crea un monitoraggio

Crea un monitor per eseguire i controlli di integrità sui nodi del control plane:

  1. Vai a Local Traffic > Monitors (Traffico locale > Monitor).
  2. Fai clic su Crea.
  3. Inserisci un nome per il monitor (ad esempio, https_readyz).
  4. Imposta il Tipo su HTTPS.
  5. In Stringa di invio, inserisci GET /readyz HTTP/1.1\r\nHost: \r\nConnection: close.
  6. In Stringa di ricezione, inserisci HTTP/1.1 200.
  7. Fai clic su Fine.

Crea nodi

Crea un nodo che punti ai nodi del control plane. Se il tuo cluster ha un control plane ad alta affidabilità (HA) con più nodi del control plane, crea un oggetto Node per ogni nodo del control plane.

  1. Vai a Local Traffic > Nodes > Node List (Traffico locale > Nodi > Elenco nodi).
  2. Fai clic su Crea.
  3. Inserisci un nome per il nodo.
  4. Inserisci l'indirizzo IP del nodo nel campo Indirizzo.
  5. Fai clic su Fine.

Crea un pool di backend

Crea un pool per i nodi del control plane:

  1. Vai a Local Traffic > Pools > Pool List (Traffico locale > Pool > Elenco pool).
  2. Fai clic su Crea.
  3. Seleziona Avanzate nel menu a discesa Configurazione.
  4. Inserisci un nome per il pool.
  5. Seleziona il monitoraggio di integrità creato in precedenza.
  6. Imposta Action On Service Down su Reject (consulta la discussione su questa impostazione nella sezione Reimpostazione delle connessioni ai nodi con errori).
  7. Aggiungi il nodo del control plane al pool. Se il cluster ha più nodi del control plane, ripeti questi passaggi per ogni nodo:
    1. Nella sezione Nuovi membri, fai clic su Elenco nodi e seleziona il nodo del control plane creato in precedenza.
    2. Nel campo Porta di servizio, inserisci 6444.
    3. Fai clic su Aggiungi.

Crea un server virtuale

Crea un server virtuale per il control plane:

  1. Vai a Local Traffic > Virtual Servers > Virtual Server List (Traffico locale > Server virtuali > Elenco server virtuali).
  2. Fai clic su Crea.
  3. Inserisci un nome per il server virtuale.
  4. Imposta Tipo su Standard.
  5. Inserisci 0.0.0.0/0 nel campo Indirizzo di origine per consentire il traffico da qualsiasi origine.
  6. Inserisci il VIP del control plane come Indirizzo di destinazione.
  7. Inserisci la porta del control plane come Porta di servizio. Per impostazione predefinita, è 443, ma è configurabile e deve corrispondere a quanto impostato nella configurazione del cluster per loadBalancer.ports.controlPlaneLBPort.
  8. Nel campo Source Address Translation, seleziona Auto Map.
  9. In Pool predefinito, seleziona il pool creato in precedenza nel menu a discesa.
  10. Fai clic su Fine.

Configura il supporto per i servizi LoadBalancer

In modalità di bilanciamento del carico manuale, Google Distributed Cloud non esegue automaticamente il provisioning dei bilanciatori del carico per supportare i servizi LoadBalancer. Per saperne di più, consulta Supporto dei servizi LoadBalancer nei cluster utente.

Questa sezione mostra come configurare manualmente un bilanciatore del carico F5 BIG-IP per un servizio LoadBalancer. Ripeti questi passaggi per ogni servizio LoadBalancer che vuoi esporre.

Prerequisiti

Per configurare un servizio LoadBalancer, devi conoscere il VIP che vuoi esporre tramite il bilanciatore del carico, la porta su cui vuoi esporlo e il NodePort utilizzato dal servizio LoadBalancer in Kubernetes.

Dopo aver eseguito il deployment di un servizio LoadBalancer nel cluster, determina il NodePort utilizzato per il servizio LoadBalancer. Il seguente comando mostrerà le porte del servizio:

kubectl --kubeconfig KUBECONFIG get service SERVICE_NAME -oyaml

Sostituisci quanto segue:

  • KUBECONFIG con il percorso del file kubeconfig da utilizzare.
  • SERVICE_NAME con il nome del servizio LoadBalancer.

L'output di kubctl get service include una sezione ports. Ogni voce della porta mostra il valore nodePort esposto per la porta sul servizio. Questo valore nodePort è quello che configuri per il backend del bilanciatore del carico. L'output di esempio seguente mostra la struttura della sezione ports:

spec:
  clusterIP: 172.26.232.107
  externalTrafficPolicy: Cluster
  loadBalancerIP: 21.0.101.77
  ports:
  - name: status-port
    nodePort: 30281
    port: 15021
    protocol: TCP
    targetPort: 15021
  - name: http
    nodePort: 30124
    port: 80
    protocol: TCP
    targetPort: 80
  - name: https
    nodePort: 31858
    port: 443
    protocol: TCP
    targetPort: 443

Esistono porte per il traffico HTTP e HTTPS. Puoi esporre una o entrambe queste porte tramite il bilanciatore del carico.

Se esponi il servizio di ingresso di cui viene eseguito automaticamente il deployment in tutti i cluster, il servizio LoadBalancer è denominato istio-ingress e si trova nello spazio dei nomi gke-system. Trova le sue porte con questo comando:

kubectl --kubeconfig KUBECONFIG -n gke-system get service istio-ingress -oyaml

Il servizio in entrata è configurato con un loadBalancerIP, ovvero l'IP fornito nel campo loadBalancer.vips.ingressVIP nella configurazione iniziale del cluster. Devi esporre questo VIP per esporre il servizio Ingress sul bilanciatore del carico esterno.

Crea un pool di backend

  1. Vai a Local Traffic > Pools > Pool List (Traffico locale > Pool > Elenco pool).
  2. Fai clic su Crea.
  3. Inserisci un nome per il pool.
  4. Seleziona tcp come monitoraggio di integrità.
  5. Aggiungi nodi worker al pool di nodi. Ripeti questi passaggi per ogni nodo. Puoi aggiungere control plane e nodi worker, poiché i NodePort di Kubernetes sono accessibili su qualsiasi nodo del cluster.
    1. Nella sezione Nuovi membri, fai clic su Elenco nodi e seleziona uno dei nodi creati in precedenza.
    2. Nel campo Porta di servizio, inserisci il valore NodePort per il servizio.
    3. Fai clic su Aggiungi.

Crea un server virtuale

  1. Vai a Local Traffic > Virtual Servers > Virtual Server List (Traffico locale > Server virtuali > Elenco server virtuali).
  2. Fai clic su Crea.
  3. Inserisci un nome per il server virtuale.
  4. Imposta Tipo su Standard.
  5. Inserisci 0.0.0.0/0 nel campo Indirizzo di origine per consentire il traffico da qualsiasi origine.
  6. Inserisci il VIP del servizio del bilanciatore del carico come Indirizzo di destinazione.
  7. Inserisci la porta esposta per il servizio di bilanciamento del carico come Porta di servizio.
  8. Nel campo Source Address Translation, seleziona Auto Map.
  9. In Pool predefinito, seleziona il pool creato in precedenza nel menu a discesa.
  10. Fai clic su Fine.