Gli ambienti Kubernetes ti consentono di scalare le risorse del database in modo dinamico in base alle variazioni delle esigenze dei workload. Utilizza queste procedure di scalabilità se hai eseguito il deployment di Spanner Omni utilizzando il grafico Helm.
Prima di iniziare
Prima di scalare il deployment di Kubernetes, devi:
Scarica e installa l'interfaccia a riga di comando Spanner Omni.
Installa Helm e crea una configurazione del grafico Helm.
Come best practice, ti consigliamo di fare lo scale up verticalmente fino ad almeno 32 GB di memoria per server prima di aggiungere altri server per fare lo scale out orizzontalmente.
Limitazioni
La scalabilità in Kubernetes presenta le seguenti limitazioni:
Solo server non root: la scalabilità orizzontale è supportata per le istanze non root. La scalabilità del server root non è supportata.
Vincoli di archiviazione di StatefulSet: poiché i
volumeClaimTemplatesdi Kubernetes sono immutabili, non puoi espandere i dischi dei pod utilizzando un singolo comandohelm upgrade. Invece, la scalabilità dello spazio di archiviazione richiede passaggi manuali di espansione del volume.
Scalabilità verticale
Per regolare le risorse di CPU o memoria per i tuoi server, aggiorna la configurazione utilizzando un upgrade di Helm:
helm upgrade spanner-omni HELM_CHART_PATH \
--version VERSION \
--reuse-values \
--set resources.cpu=CPU_CORES \
--set resources.memory=MEMORY_LIMIT \
-n NAMESPACE
Sostituisci quanto segue:
HELM_CHART_PATH: il percorso del grafico Helm, ad esempiooci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni.VERSION: la versione del grafico Helm, ad esempio1.1.0.CPU_CORES: il numero di core vCPU da assegnare a ogni pod del server, ad esempio8.MEMORY_LIMIT: il limite di RAM per ogni pod del server, ad esempio32Gi.NAMESPACE: lo spazio dei nomi Kubernetes del deployment, ad esempiospanner-ns.
Scalabilità orizzontale
Per scalare in orizzontale, aggiungi altri server al tuo deployment. La scalabilità orizzontale è supportata per i server non root.
Aggiungi server non root
Per aggiungere server non root, aumenta il numero di repliche nella configurazione del grafico Helm. Puoi scalare tutte le zone in modo uniforme o scalare una zona specifica.
Scala in modo uniforme
Per scalare ogni zona del deployment a 15 server, esegui questo comando:
helm upgrade spanner-omni HELM_CHART_PATH \
--version VERSION \
--reuse-values \
--set deployment.replicasPerZone=REPLICAS \
-n NAMESPACE
Sostituisci quanto segue:
HELM_CHART_PATH: il percorso del grafico Helm, ad esempiooci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni.VERSION: la versione del grafico Helm, ad esempio1.1.0.REPLICAS: il numero target di repliche del server per zona, ad esempio15.NAMESPACE: lo spazio dei nomi Kubernetes, ad esempiospanner-ns.
Scala una zona specifica
Se il deployment iniziale ha configurato un numero di server diverso per le singole zone, puoi scegliere come target una singola zona. Ad esempio, per aumentare a 15 le repliche della prima zona all'interno della prima località, esegui questo comando:
helm upgrade spanner-omni HELM_CHART_PATH \
--version VERSION \
--reuse-values \
--set locations[0].zones[0].replicas=REPLICAS \
-n NAMESPACE
Sostituisci REPLICAS con il numero di repliche della zona di destinazione, ad esempio 15.
Per verificare che i nuovi server siano stati aggiunti correttamente al deployment, esegui una query sull'interfaccia a riga di comando di Spanner Omni per elencare i server di deployment o visualizzare la dashboard di Grafana.
spanner deployment servers list \
--zone=ZONE \
--deployment-endpoint=ENDPOINT
Sostituisci quanto segue:
ZONE: la zona che vuoi elencare, ad esempious-central1-a.ENDPOINT: l'endpoint esterno del tuo deployment, ad esempio${ENDPOINT}:15000.
Rimuovi i server non root
Fare lo scale down dei server richiede passaggi aggiuntivi perché il sistema deve spostare in sicurezza le partizioni di dati dai server dismessi. Poiché gli StatefulSet di Kubernetes rimuovono i pod dall'indice più alto a quello più basso, devi scegliere come target per la rimozione prima i server non root con l'indice più alto.
Per fare lo scale down del numero di server, segui questi passaggi:
Elenca i server nella tua zona per identificare i candidati da rimuovere:
spanner deployment servers list \ --zone=ZONE \ --deployment-endpoint=ENDPOINTOutput di esempio:
NAME HOST PORT_BASE ROOT STATE zones/us-central1-a/servers/spanner-a-0.pod.spanner-ns:15000 spanner-a-0.pod.spanner-ns 15000 true - zones/us-central1-a/servers/spanner-a-1.pod.spanner-ns:15000 spanner-a-1.pod.spanner-ns 15000 - -Elimina il server non root ritirato con l'indice più alto (ad esempio
spanner-a-1.pod.spanner-ns:15000):spanner deployment servers delete SERVER_NAME \ --zone=ZONE \ --deployment-endpoint=ENDPOINTSostituisci
SERVER_NAMEcon l'identificatore del server, ad esempiospanner-a-1.pod.spanner-ns:15000.Controlla l'elenco dei server finché il server di destinazione non viene rimosso dall'elenco. Dopo l'eliminazione, il server passa a uno stato non integro nel sistema e viene rimosso dal percorso del servizio attivo.
Esegui lo scale down del deployment Helm eseguendo un comando di upgrade Helm in modo che corrisponda al numero di repliche target. Ad esempio, per ridurre le repliche per zona a
1pod, esegui questo comando:helm upgrade spanner-omni HELM_CHART_PATH \ --version VERSION \ --reuse-values \ --set deployment.replicasPerZone=REPLICAS \ -n NAMESPACESostituisci
REPLICAScon il conteggio delle repliche aggiornato, ad esempio1.Elimina le richieste di volumi permanenti (PVC) Kubernetes associate ai pod rimossi. Per evitare la perdita accidentale di dati, Helm e Kubernetes non eliminano automaticamente le PVC quando viene eseguito lo scale down di un StatefulSet. Elimina manualmente i PVC per recuperare completamente lo spazio di archiviazione:
kubectl delete pvc LOGS_PVC DATA_PVC -n NAMESPACEAd esempio, per eliminare i volumi di log e dati per
spanner-a-1nello spazio dei nomispanner-ns:kubectl delete pvc logs-volume-spanner-a-1 data-volume-spanner-a-1 -n spanner-ns
Aggiungi una zona
L'aggiunta di una nuova zona al deployment aumenta la disponibilità e protegge il database da interruzioni in una singola zona.
Ad esempio, il comando seguente inizializza un deployment in esecuzione in una singola zona su Google Kubernetes Engine (GKE) nella zona us-east1-b della regione us:
helm upgrade --install spanner-omni HELM_CHART_PATH \
--version VERSION \
--set resources.cpu=2 \
--set resources.memory=8Gi \
--set global.platform=gke \
--set-json 'locations=[{"name":"us","zones":[{"name":"us-east1-b","shortName":"east-b"}]}]' \
-n NAMESPACE
Aggiungi la zona us-east1-c a questa configurazione seguendo questi passaggi:
Avvia i pod nella nuova zona eseguendo il comando
helm upgradee passando un blocco JSON aggiornato che include la nuova zona di località:helm upgrade spanner-omni HELM_CHART_PATH \ --version VERSION \ --reuse-values \ --set-json 'locations=[{"name":"us","zones":[{"name":"us-east1-b","shortName":"east-b"},{"name":"us-east1-c","shortName":"east-c"}]}]' \ -n NAMESPACEAggiungi la nuova zona utilizzando l'interfaccia a riga di comando di Spanner Omni. Attendi che i pod del server root nella zona appena creata entrino nello stato
Runninge pronto. Poi, esegui il comando di creazione della zona:spanner deployment zones create NEW_ZONE \ --location=LOCATION \ --root-servers=ROOT_SERVERS_LIST \ --deployment-endpoint=ENDPOINTSostituisci quanto segue:
NEW_ZONE: l'identificatore della zona da aggiungere, ad esempious-east1-c.LOCATION: la località di deployment, ad esempious.ROOT_SERVERS_LIST: un elenco separato da virgole di endpoint del server root nella nuova zona, ad esempiospanner-east-c-0.pod.spanner-ns:15000,spanner-east-c-1.pod.spanner-ns:15000,spanner-east-c-2.pod.spanner-ns:15000.ENDPOINT: l'endpoint di deployment esterno, ad esempio${ENDPOINT}:15000.
Attendi il completamento della creazione della zona. La replica di schemi e tabelle di database esistenti in una nuova zona richiede tempo. Monitora l'avanzamento della sincronizzazione delle zone elencando le zone di deployment:
spanner deployment zones list --deployment-endpoint=ENDPOINT
Rimuovi una zona
Puoi dismettere una zona attiva dal deployment multizona per ridurre le risorse o allinearti alle modifiche della topologia.
Rimuovi la zona us-east1-c creata nella sezione precedente seguendo questi passaggi:
Elimina la zona e avvia la disattivazione della zona all'interno di Spanner Omni:
spanner deployment zones delete ZONE --deployment-endpoint=ENDPOINTSostituisci
ZONEcon la zona da rimuovere, ad esempious-east1-c.Verifica che la zona sia stata rimossa. Esegui un comando list e attendi finché la zona non viene più visualizzata nell'output:
spanner deployment zones list --deployment-endpoint=ENDPOINTRimuovi i server dal cluster Kubernetes eseguendo un comando helm upgrade e passando un blocco JSON di località aggiornato che esclude la zona rimossa:
helm upgrade spanner-omni HELM_CHART_PATH \ --version VERSION \ --reuse-values \ --set-json 'locations=[{"name":"us","zones":[{"name":"us-east1-b","shortName":"east-b"}]}]' \ -n NAMESPACE
Scala lo spazio di archiviazione
Poiché i volumeClaimTemplates di Kubernetes sono immutabili, non puoi fare lo scale up delle capacità di archiviazione dei pod utilizzando direttamente il comando helm upgrade. Devi invece eseguire un'espansione manuale del volume. Per saperne di più, consulta la
guida all'espansione del volume StatefulSet di GKE.
Per espandere lo spazio di archiviazione del disco, segui questi passaggi:
Definisci i parametri per l'espansione del volume come variabili di ambiente nel terminale:
NEW_SIZE="NEW_SIZE" NAMESPACE="NAMESPACE" RELEASE_NAME="spanner-omni" STATEFULSET_NAMES="STATEFULSET_NAME_1 STATEFULSET_NAME_2 STATEFULSET_NAME_3" HELM_CHART_PATH="HELM_CHART_PATH" VERSION="VERSION"Sostituisci quanto segue:
NEW_SIZE: la dimensione della capacità di archiviazione target, ad esempio200Gi.NAMESPACE: lo spazio dei nomi Kubernetes, ad esempiospanner-ns.STATEFULSET_NAME_1,STATEFULSET_NAME_2, …: i nomi degli StatefulSets nel tuo deployment, che in genere corrispondono ai nomi brevi delle zone (ad esempio,spanner-east-b spanner-east-c).HELM_CHART_PATH: il percorso del grafico Helm, ad esempiooci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni.VERSION: la versione del grafico Helm, ad esempio1.1.0.
Esegui i comandi per applicare patch alle PVC, eliminare gli StatefulSet (lasciando intatti i pod di backend) ed eseguire l'upgrade del deployment Helm:
# Patch all associated PVCs directly. for pvc in $(kubectl get pvc -n $NAMESPACE \ -l app.kubernetes.io/instance=$RELEASE_NAME \ -o name | grep "data-volume"); do kubectl patch $pvc -n $NAMESPACE -p "{\"spec\":{\"resources\":{\"requests\":{\"storage\":\"$NEW_SIZE\"}}}}" done # Delete the StatefulSet while leaving backend pods intact (orphan cascade). kubectl delete statefulset $STATEFULSET_NAMES -n $NAMESPACE --cascade=orphan # Run Helm upgrade to align the templates with the expanded size. helm upgrade $RELEASE_NAME $HELM_CHART_PATH \ --version $VERSION \ --reuse-values \ --set storage.data.size=$NEW_SIZE \ -n $NAMESPACE
Passaggi successivi
- Scopri come eseguire la manutenzione di un deployment.