Configura il bilanciamento del carico manuale

Questa pagina illustra i requisiti di bilanciamento del carico quando si utilizza il bilanciamento del carico manuale. A differenza del bilanciamento del carico in bundle in cui Google Distributed Cloud esegue il deployment di bilanciatori del carico nei nodi cluster per il traffico del piano di controllo e del piano dati, con il bilanciamento del carico manuale configuri le tue soluzioni di bilanciamento del carico per il traffico del piano di controllo e del piano dati.

Prima di creare un cluster bare metal, devi configurare un bilanciatore del carico esterno per il piano di controllo. Il bilanciatore del carico del piano di controllo esterno può essere utilizzato anche per il traffico del piano dati oppure puoi configurare un bilanciatore del carico separato per il piano dati. Ad esempio, puoi utilizzare un bilanciatore del carico nel cluster come MetalLB per il traffico del piano dati.

Oltre a spiegare i requisiti di bilanciamento del carico, in questa pagina viene descritto come configurare il bilanciamento del carico manuale utilizzando F5 BIG-IP.

Prerequisiti

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

Indirizzo IP richiesto

Devi pianificare i VIP prima di creare un cluster. Tutti i cluster richiedono un VIP per il piano di controllo. Tutti i cluster utente richiedono un secondo VIP per il servizio in entrata.

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

Quando crei il cluster, il deployment del servizio in entrata viene eseguito utilizzando il 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 piano di controllo.

Requisiti del bilanciatore del carico del piano di controllo esterno

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

  • Un servizio virtuale (frontend) per il VIP del piano di controllo. La porta di ascolto predefinita del piano di controllo è 443. Tuttavia, se specifichi una porta diversa, il campo loadBalancer.ports.controlPlaneLBPort del file di configurazione del cluster utilizzerà quella porta per il servizio virtuale.
  • Un gruppo di backend contenente tutti gli indirizzi IP dei nodi del piano di controllo del cluster. La porta di backend su cui il piano di controllo 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 bootstrapping del cluster non vada a buon fine. Un controllo preflight verifica che il bilanciatore del carico esterno sia configurato correttamente e verifica che il bilanciatore del carico esegua il controllo di integrità dell'endpoint /readyz.

Reimposta le connessioni sui nodi con errori (consigliato)

Oltre ai requisiti precedenti, ti consigliamo di configurare il bilanciatore del carico in modo da reimpostare 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, causando instabilità nel piano di controllo Kubernetes.

  • Con F5 BIG-IP, questa impostazione è denominata Azione in caso di inattività del servizio nella pagina di configurazione del pool di backend.
  • Con HAProxy, questa impostazione viene chiamata sessione di chiusura "on-marked-down" (arresto segnato) 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, crea un file di configurazione del cluster con bmctl. Modifica questo file per abilitare il bilanciamento del carico manuale 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 completato la modifica del file di configurazione, inclusi i campi non correlati al bilanciamento del carico, verifica che il VIP del piano di controllo 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 In modalità di bilanciamento del carico manuale, Google Distributed Cloud non esegue automaticamente il provisioning dei bilanciatori del carico, pertanto i servizi LoadBalancer non funzionano finché non esegui il provisioning e la configurazione dei bilanciatori del carico in modo che puntino i servizi.

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

Le opzioni per supportare i servizi LoadBalancer includono:

  • Configura manualmente il bilanciatore del carico per ogni servizio LoadBalancer nel cluster. Vedi Configurazione del supporto per i servizi LoadBalancer per un esempio di utilizzo di F5 BIG-IP.
  • Installare 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 nel cluster come MetalLB.

Bilanciamento del carico manuale con F5 BIG-IP

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

configura il bilanciatore del carico del piano di controllo

Prima di creare un cluster, devi configurare il bilanciatore del carico del piano di controllo. Dopo aver eseguito questi passaggi, puoi configurare il cluster e crearlo.

Crea una partizione per il cluster

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

  1. Vai a Sistema > Utenti > 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 ciascun oggetto venga creato in questa partizione.

Crea un monitoraggio

Crea un monitoraggio per eseguire i controlli di integrità sui nodi del piano di controllo:

  1. Vai a 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. Per Send String (Invia stringa), 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 piano di controllo. Se il cluster ha un piano di controllo ad alta disponibilità con più nodi, crea un oggetto nodo per ciascun nodo del piano di controllo.

  1. Vai a 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 piano di controllo:

  1. Vai a Traffico locale > Pool > Elenco pool.
  2. Fai clic su Crea.
  3. Seleziona Avanzate dall'elenco a discesa Configurazione.
  4. Inserisci un nome per il pool.
  5. Seleziona il monitoraggio di integrità creato in precedenza.
  6. Imposta Azione in caso di mancato funzionamento del servizio su Rifiuta (consulta la discussione su questa impostazione nella sezione Reimpostazione delle connessioni ai nodi con errori).
  7. Aggiungi il nodo del piano di controllo al pool. Se il cluster ha più nodi del piano di controllo, ripeti questi passaggi per ciascun nodo:
    1. Nella sezione Nuovi membri, fai clic su Elenco nodi e seleziona il nodo del piano di controllo creato in precedenza.
    2. Nel campo Porta servizio, inserisci 6444.
    3. Fai clic su Aggiungi.

Crea un server virtuale

Crea un server virtuale per il piano di controllo:

  1. Vai a 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 piano di controllo come Indirizzo di destinazione.
  7. Inserisci Porta di servizio come porta del piano di controllo. Il valore predefinito è 443, ma è configurabile e deve corrispondere a quanto configurato nella configurazione del cluster per loadBalancer.ports.controlPlaneLBPort.
  8. Nel campo Source Address Translation, seleziona Auto Map (Mappa automatica).
  9. In Pool predefinito, seleziona il pool creato in precedenza dal 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 ulteriori informazioni, consulta Supporto dei servizi LoadBalancer nei cluster utente.

Questa sezione mostra come configurare manualmente un bilanciatore del carico BIG-IP F5 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 che utilizza il servizio LoadBalancer in Kubernetes.

Dopo aver eseguito il deployment di un servizio LoadBalancer nel cluster, determina il valore 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 di porta mostra la porta nodePort esposta per la porta sul servizio, che è la porta a cui configuri il backend del bilanciatore del carico. Il seguente output di esempio 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

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

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

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

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

Crea un pool di backend

  1. Vai a 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 ciascun nodo. Puoi aggiungere piani di controllo e nodi worker poiché i NodePort Kubernetes sono accessibili su qualsiasi nodo nel cluster.
    1. Nella sezione Nuovi membri, fai clic su Elenco nodi, quindi seleziona uno dei nodi creati in precedenza.
    2. Nel campo Porta servizio, inserisci il valore NodePort per il servizio.
    3. Fai clic su Aggiungi.

Crea un server virtuale

  1. Vai a 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 come Porta di servizio la porta esposta per il servizio del bilanciatore del carico.
  8. Nel campo Source Address Translation, seleziona Auto Map (Mappa automatica).
  9. In Pool predefinito, seleziona il pool creato in precedenza dal menu a discesa.
  10. Fai clic su Fine.