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 dei bilanciatori del carico nei nodi del cluster per il traffico del piano di controllo e del piano dati, con il bilanciamento del carico manuale puoi configurare 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 obbligatorio

Devi pianificare i VIP prima di creare un cluster. Tutti i cluster hanno bisogno di 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 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 lo stato integro del nodo.

Se il bilanciatore del carico esterno non è configurato correttamente, è probabile che l'operazione di bootstrap del cluster non vada a buon fine. Un controllo preflight verifica che il bilanciatore del carico esterno sia configurato correttamente, inclusa la verifica che il bilanciatore del carico stia eseguendo il controllo di integrità dell'endpoint /readyz.

Reimposta le connessioni sui nodi non riusciti (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 si arresta, causando instabilità nel piano di controllo Kubernetes.

  • Con BIG-IP di F5, questa impostazione è denominata Azione in caso di inattività nella pagina di configurazione del pool di backend.
  • Con HAProxy, questa impostazione viene chiamata sessioni di chiusura on-marked-down 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 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 nel 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 di bilanciamento del carico Kubernetes In modalità di bilanciamento del carico manuale, Google Distributed Cloud non esegue automaticamente il provisioning dei bilanciatori del carico per cui i servizi di LoadBalancer non funzionano a meno che non esegui il provisioning e configuri i bilanciatori del carico per indirizzare 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 in modo da puntare al servizio.

Le opzioni a tua disposizione per il supporto dei servizi LoadBalancer includono:

  • Configura manualmente il bilanciatore del carico per ogni servizio LoadBalancer nel cluster. Per un esempio utilizzando F5 BIG-IP, consulta Configurazione del supporto per i servizi LoadBalancer.
  • 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 utilizzi un bilanciatore del carico diverso, consulta la documentazione del bilanciatore del carico e utilizza questi passaggi come modello.

Configura il bilanciatore del carico del piano di controllo

Devi configurare il bilanciatore del carico del piano di controllo 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 Sistema > Utenti > Elenco di partizioni.
  2. Fai clic su Crea.
  3. Inserisci un nome per la partizione.
  4. Fai clic su Fine.

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

Crea un monitoraggio

Crea un monitoraggio per eseguire 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 monitoraggio (ad esempio, https_readyz).
  4. Imposta il Tipo su HTTPS.
  5. In Invia stringa, inserisci GET /readyz HTTP/1.1\r\nHost: \r\nConnection: close.
  6. In Ricevi stringa, inserisci HTTP/1.1 200.
  7. Fai clic su Fine.

Crea nodi

Crea un nodo che punta ai nodi del piano di controllo. Se il cluster ha un piano di controllo ad alta disponibilità con più nodi del piano di controllo, 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 nel menu 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 inattività del servizio su Rifiuta (consulta la discussione su questa impostazione nella sezione Reimpostazione delle connessioni ai nodi non riusciti).
  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 di nodi e seleziona il nodo del piano di controllo 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 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 proveniente da qualsiasi sorgente.
  6. Inserisci il VIP del piano di controllo come Indirizzo di destinazione.
  7. Inserisci la porta del piano di controllo come Porta di servizio. Per impostazione predefinita, il valore è 443, ma è configurabile e deve corrispondere a quanto configurato nella configurazione del cluster per loadBalancer.ports.controlPlaneLBPort.
  8. Nel campo Traduzione dell'indirizzo di origine, seleziona Mappa automatica.
  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 ulteriori informazioni, consulta Supporto dei servizi LoadBalancer nei cluster utente.

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

Dopo aver eseguito il deployment di un servizio LoadBalancer nel cluster, determina il nodo 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 e questa è l'elemento a cui configuri il backend del bilanciatore del carico su cui punta. 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

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

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

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

Il servizio in entrata è configurato con un bilanciatore del caricoBalancerIP, cioè 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 man mano che le NodePort di Kubernetes sono accessibili su qualsiasi nodo del cluster.
    1. Nella sezione Nuovi membri, fai clic su Elenco di nodi e 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 proveniente da qualsiasi sorgente.
  6. Inserisci il VIP del servizio del bilanciatore del carico come Indirizzo di destinazione.
  7. Inserisci la porta esposta per il servizio del bilanciatore del carico come Porta del servizio.
  8. Nel campo Traduzione dell'indirizzo di origine, seleziona Mappa automatica.
  9. In Pool predefinito, seleziona il pool creato in precedenza nel menu a discesa.
  10. Fai clic su Fine.