Scalabilità di Cassandra

Attualmente stai visualizzando la versione 1.11 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per ulteriori informazioni, consulta Versioni supportate.

Version 1.11 

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Questo argomento spiega come scalare Cassandra orizzontalmente e verticalmente e come ridimensionarla.

Scalabilità orizzontale di Cassandra

Per scalare orizzontalmente Cassandra

1. Assicurati che il tuo pool di nodi apigee-data abbia capacità aggiuntiva, se necessario, prima di scalare Cassandra. Vedi anche Configurazione dei pool di nodi dedicati.
2. Imposta il valore della proprietà di configurazione cassandra.replicaCount nel file di override. Il valore di replicaCount deve essere un multiplo di 3. Per determinare il valore replicaCount che preferisci, considera quanto segue:
   • Stima le richieste di traffico per i tuoi proxy.
   • Esegui il test di carico e fai previsioni ragionevoli sull'utilizzo della CPU.
   • Puoi specificare valori replicaCount diversi in regioni diverse.
   • In futuro potrai espandere replicaCount nel file di override.

   Per informazioni su questa proprietà, consulta il riferimento per le proprietà di configurazione. Vedi anche Gestione dei componenti del piano di runtime.

   Nota:il fattore di replica predefinito per tutti gli spazi chiave è tre. Di conseguenza, ti consigliamo di scalare le repliche di un fattore di tre.
3. Applica le modifiche. Ad esempio:

   Helm

   helm upgrade datastore apigee-datastore/ \
     --namespace apigee \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

   Nota: se visualizzi un errore che indica Error: UPGRADE FAILED: "datastore" has no deployed releases, sostituisci upgrade con install e riprova a eseguire il comando.

   apigeectl

   $APIGEECTL_HOME/apigeectl apply --datastore -f OVERRIDES_FILE.yaml

Scalabilità verticale di Cassandra

Questa sezione spiega come scalare verticalmente i pod Cassandra per soddisfare requisiti di CPU e memoria più elevati.

Panoramica

Per un deployment di produzione ibrido di Apigee, ti consigliamo di creare almeno due pool di nodi separati: uno per i servizi stateful (Cassandra) e uno per i servizi stateless (runtime). Ad esempio, consulta i requisiti per i cluster di produzione GKE.

Per il pool di nodi Cassandra stateful, ti consigliamo di iniziare con 8 core CPU e 30 GB di memoria. Una volta eseguito il provisioning del pool di nodi, queste impostazioni non possono essere modificate. Vedi anche Configurazione di Cassandra per la produzione.

Se devi aumentare le dimensioni dei pod Cassandra per soddisfare requisiti di CPU e memoria più elevati, segui i passaggi descritti in questo argomento.

Scalabilità verticale dei pod di Cassandra

Segui questi passaggi per aumentare la CPU e la memoria per il pool di nodi stateful utilizzato per Cassandra:

1. Segui le istruzioni della tua piattaforma Kubernetes per aggiungere un nuovo pool di nodi al cluster. Le piattaforme supportate sono elencate nelle istruzioni di installazione.
2. Verifica che il nuovo pool di nodi sia pronto:

   kubectl get nodes -l NODE_POOL_LABEL_NAME=NODE_POOL_LABEL_VALUE

   Comando di esempio:

   kubectl get nodes -l cloud.google.com/gke-nodepool=apigee-data-new

   Output di esempio:

   NAME                                                STATUS   ROLES    AGE     VERSION
   gke-apigee-data-new-441387c2-2h5n   Ready    <none>   4m28s   v1.14.10-gke.17
   gke-apigee-data-new-441387c2-6941   Ready    <none>   4m28s   v1.14.10-gke.17
   gke-apigee-data-new-441387c2-nhgc   Ready    <none>   4m29s   v1.14.10-gke.17

3. Aggiorna il file di override in modo che utilizzi il nuovo pool di nodi per Cassandra e aggiorna le risorse del pod in modo che utilizzino il numero di CPU e le dimensioni della memoria aumentati che vuoi utilizzare. Ad esempio, per un cluster GKE, utilizza una configurazione simile alla seguente. Se utilizzi un'altra piattaforma Kubernetes, devi modificare il valore apigeeData.key di conseguenza:

   nodeSelector:
     requiredForScheduling: true
     apigeeData:
       key: "NODE_POOL_LABEL_NAME"
       value: "NODE_POOL_LABEL_VALUE"
   
   cassandra:
     resources:
       requests:
         cpu: NODE_POOL_CPU_NUMBER
         memory: NODE_POOL_MEMORY_SIZE

   Ad esempio:

   nodeSelector:
     requiredForScheduling: true
     apigeeData:
       key: "cloud.google.com/gke-nodepool"
       value: "apigee-data-new"
   
   cassandra:
     resources:
       requests:
         cpu: 14
         memory: 16Gi

4. Applica il file di override al cluster:

   Helm

   helm upgrade datastore apigee-datastore/ \
     --namespace apigee \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply --datastore -f OVERRIDES_FILE.yaml

Al termine di questi passaggi, i pod Cassandra inizieranno il rollover al nuovo pool di nodi.

Riduzione della scalabilità di Cassandra

ATTENZIONE: la riduzione dei cluster Cassandra è più invasiva rispetto all'aumento. Procedi con cautela durante la riduzione dello scale

Apigee hybrid utilizza un anello di nodi Cassandra come StatefulSet. Cassandra fornisce uno spazio di archiviazione persistente per determinate entità Apigee sul piano di runtime. Per maggiori informazioni su Cassandra, consulta Informazioni sul piano di runtime.

Cassandra è un servizio che richiede molte risorse e non deve essere implementato su un pod con altri servizi ibridi. A seconda del carico, potresti voler ridurre il numero di nodi Cassandra nell'anello del cluster.

La procedura generale per ridurre le dimensioni di un anello Cassandra è la seguente:

1. Assicurati che il cluster Cassandra sia integro e disponga di spazio di archiviazione sufficiente per supportare lo scale down.
2. Aggiorna la proprietà cassandra.replicaCount in overrides.yaml.
3. Applica l'aggiornamento della configurazione.
4. Elimina la richiesta di volume permanente o il volume, a seconda della configurazione del cluster.

Informazioni importanti

• Se un nodo diverso da quelli da ritirare non è integro, non continuare. Kubernetes non sarà in grado di ridurre le dimensioni dei pod del cluster.
• Esegui sempre fare lo scale down o lo scale up di un fattore di tre nodi.

Ridimensiona Cassandra

1. Verifica che il cluster sia integro e che tutti i nodi siano attivi e in esecuzione, come mostrato nell'esempio seguente:

    kubectl get pods -n yourNamespace -l app=apigee-cassandra
   NAME                 READY   STATUS    RESTARTS   AGE
   apigee-cassandra-default-0   1/1     Running   0          2h
   apigee-cassandra-default-1   1/1     Running   0          2h
   apigee-cassandra-default-2   1/1     Running   0          2h
   apigee-cassandra-default-3   1/1     Running   0          16m
   apigee-cassandra-default-4   1/1     Running   0          14m
   apigee-cassandra-default-5   1/1     Running   0          13m
   apigee-cassandra-default-6   1/1     Running   0          9m
   apigee-cassandra-default-7   1/1     Running   0          9m
   apigee-cassandra-default-8   1/1     Running   0          8m

   kubectl -n yourNamespace exec -it apigee-cassandra-default-0 nodetool status
   Datacenter: us-east1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
   UN  10.16.2.6    690.17 KiB  256          48.8%             b02089d1-0521-42e1-bbed-900656a58b68  ra-1
   UN  10.16.4.6    705.55 KiB  256          51.6%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1 to
   UN  10.16.11.11  674.36 KiB  256          48.3%             c7906366-6c98-4ff6-a4fd-17c596c33cf7  ra-1
   UN  10.16.1.11   697.03 KiB  256          49.8%             ddf221aa-80aa-497d-b73f-67e576ff1a23  ra-1
   UN  10.16.5.13   703.64 KiB  256          50.9%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
   UN  10.16.8.15   700.42 KiB  256          50.6%             a27f93af-f8a0-4c88-839f-2d653596efc2  ra-1
   UN  10.16.11.3   697.03 KiB  256          49.8%             dad221ff-dad1-de33-2cd3-f1.672367e6f  ra-1
   UN  10.16.14.16  704.04 KiB  256          50.9%             1feed042-a4b6-24ab-49a1-24d4cef95473  ra-1
   UN  10.16.16.1   699.82 KiB  256          50.6%             beef93af-fee0-8e9d-8bbf-efc22d653596  ra-1
   

   ATTENZIONE: se il cluster non è integro o almeno un nodo non è attivo e funzionante, non procedere con questa procedura.
2. Determina se il cluster Cassandra dispone di spazio di archiviazione sufficiente per supportare la riduzione del cluster. Dopo lo scale down, i nodi Cassandra non devono avere più del 75% dello spazio di archiviazione pieno.

   Ad esempio, se il cluster ha 6 nodi Cassandra e sono tutti pieni al 50% circa, la riduzione a tre nodi lascerebbe tutti e tre al 100%, il che non lascerebbe spazio per il funzionamento continuo.

   Se invece hai 9 nodi Cassandra, tutti pieni al 50% circa, la riduzione a 6 nodi lascerebbe ogni nodo rimanente pieno al 75% circa. Puoi ridurre la risoluzione.

   Nota: è prassi comune mantenere i nodi Cassandra in multipli di tre.
3. Aggiorna o aggiungi la proprietà cassandra.replicaCount nel file overrides.yaml. Ad esempio, se il conteggio dei nodi attuale è 9, modificalo in 6:

   cassandra:
     replicaCount: 6 # 

4. Applica la modifica della configurazione al tuo cluster:

   Helm

   helm upgrade datastore apigee-datastore/ \
     --namespace apigee \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply --datastore -f OVERRIDES_FILE.yaml

   namespace/apigee unchanged
   secret/ssl-cassandra unchanged
   storageclass.storage.k8s.io/apigee-gcepd unchanged
   service/apigee-cassandra unchanged
   statefulset.apps/apigee-cassandra configured

5. Verifica che tutti i nodi Cassandra rimanenti siano in esecuzione:

   kubectl get pods -n yourNamespace -l app=apigee-cassandra
   NAME                 READY   STATUS    RESTARTS   AGE
   apigee-cassandra-default-0   1/1     Running   0          3h
   apigee-cassandra-default-1   1/1     Running   0          3h
   apigee-cassandra-default-2   1/1     Running   0          2h
   apigee-cassandra-default-3   1/1     Running   0          25m
   apigee-cassandra-default-4   1/1     Running   0          24m
   apigee-cassandra-default-5   1/1     Running   0          23m
   
   

6. Verifica che il valore di cassandra.replicaCount sia uguale al numero di nodi restituiti dal comando nodetool status.

   Ad esempio, se hai ridotto il numero di nodi di Cassandra a sei:

   kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status
   Datacenter: us-east1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address      Load         Tokens       Owns (effective)  Host ID                               Rack
   UN  10.16.2.6    1009.17 KiB  256          73.8%             b02089d1-0521-42e1-bbed-900656a58b68  ra-1
   UN  10.16.4.6    1.65.55 KiB  256          75.6%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1 to
   UN  10.16.11.11  999.36 KiB   256          72.8%             c7906366-6c98-4ff6-a4fd-17c596c33cf7  ra-1
   UN  10.16.1.11   1017.03 KiB  256          74.2%             ddf221aa-80aa-497d-b73f-67e576ff1a23  ra-1
   UN  10.16.5.13   1061.64 KiB  256          75.9%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
   UN  10.16.8.15   1049.42 KiB  256          74.9%             a27f93af-f8a0-4c88-839f-2d653596efc2  ra-1
   
   

7. Dopo aver ridotto le dimensioni del cluster Cassandra, verifica che i PVC (PersistentVolumeClaim) corrispondano ai nodi Cassandra rimanenti.

   Recupera i nomi dei PVC:

   kubectl get pvc -n yourNamespace
   NAME                                STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
   cassandra-data-apigee-cassandra-default-0   Bound    pvc-f9c2a5b9-818c-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   7h
   cassandra-data-apigee-cassandra-default-1   Bound    pvc-2956cb78-818d-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   7h
   cassandra-data-apigee-cassandra-default-2   Bound    pvc-79de5407-8190-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   7h
   cassandra-data-apigee-cassandra-default-3   Bound    pvc-d29ba265-81a2-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   5h
   cassandra-data-apigee-cassandra-default-4   Bound    pvc-0675a0ff-81a3-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   5h
   cassandra-data-apigee-cassandra-default-5   Bound    pvc-354afa95-81a3-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   5h

   In questo esempio non dovresti vedere PVC corrispondenti ai tre nodi ridimensionati:

   • cassandra-data-apigee-cassandra-8
   • cassandra-data-apigee-cassandra-7
   • cassandra-data-apigee-cassandra-6