Scale down di Cassandra

Al momento stai visualizzando la versione 1.4 della documentazione di Apigee hybrid. Questa versione è terminata. Dovresti eseguire l'upgrade a una versione più recente. Per maggiori informazioni, consulta la pagina Versioni supportate.

ATTENZIONE: lo scale down dei cluster cassandra è più invasivo rispetto allo scale up. Procedi con cautela durante lo scale down

Apigee hybrid utilizza un anello di nodi Cassandra come StatefulSet. Cassandra fornisce archiviazione permanente per alcune entità Apigee sul piano di runtime. Per maggiori informazioni su Cassandra, consulta la sezione Informazioni sul piano di runtime.

Cassandra è un servizio ad alta intensità di risorse e non deve essere eseguito il deployment su un pod con altri servizi ibridi. A seconda del carico, potresti scalare il numero di nodi Cassandra nell'anello verso il basso del cluster.

Il processo generale per lo scale down di un anello di Cassandra è:

1. Rimuovi un nodo Cassandra.
2. Aggiorna la proprietà cassandra.replicaCount in overrides.yaml.
3. Applica l'aggiornamento della configurazione.
4. Ripeti questi passaggi per ciascun nodo che vuoi rimuovere.
5. Elimina la rivendicazione o il volume permanente del volume, a seconda della configurazione del cluster.

Cosa è importante sapere

• Esegui questa attività su un nodo alla volta prima di passare al nodo successivo.
• Se un nodo diverso da quello da ritirare non è integro, non procedere. Kubernetes non sarà in grado di fare lo scale down dei pod dal cluster.
• Eseguire sempre lo scale down o lo scale down di un fattore di tre nodi.

Prerequisiti

Prima di fare lo scale down del numero di nodi Cassandra nell'anello, verifica se il cluster è in stato integro e tutti i nodi sono attivi e in esecuzione, come mostra l'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

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    700.55 KiB  256          51.6%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1 to
UN  10.16.11.11  144.36 KiB  256          48.3%             c7906366-6c98-4ff6-a4fd-17c596c33cf7  ra-1
UN  10.16.1.11   767.03 KiB  256          49.8%             ddf221aa-80aa-497d-b73f-67e576ff1a23  ra-1
UN  10.16.5.13   193.64 KiB  256          50.9%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
UN  10.16.8.15   132.42 KiB  256          50.6%             a27f93af-f8a0-4c88-839f-2d653596efc2  ra-1

ATTENZIONE: se il cluster non è integro o almeno un nodo non è in esecuzione, non continuare con questa procedura.

Spegnere i nodi di Cassandra

1. Ritira i nodi Cassandra dal cluster utilizzando il comando nodetool.
   Rimuovi prima i nodi con numeri più alti nel nome del pod. Ad esempio in un cluster a 6 nodi, inizia con il nodo Cassandra Apigee-cassandra-5.

   kubectl -n yourNamespace exec -it nodeName nodetool decommission

   Ad esempio, questo comando disattiva apigee-cassandra-5, il nodo con il valore del numero più alto nel nome:

   kubectl -n apigee exec -it apigee-cassandra-5 nodetool decommission

2. Attendi il completamento del ritiro e verifica che il cluster ora abbia un nodo in meno. Ad esempio:

   kubectl -n yourNamespace exec -it nodeName 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   710.37 KiB  256          59.0%             b02089d1-0521-42e1-bbed-900656a58b68  ra-1
   UN  10.16.4.6   720.97 KiB  256          61.3%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1
   UN  10.16.1.11  777.11 KiB  256          58.9%             ddf221aa-80aa-497d-b73f-67e576ff1a23  ra-1
   UN  10.16.5.13  209.23 KiB  256          62.2%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
   UN  10.16.8.15  143.23 KiB  256          58.6%             a27f93af-f8a0-4c88-839f-2d653596efc2  ra-1
   

3. Aggiorna o aggiungi la proprietà cassandra.replicaCount nel file overrides.yaml. Ad esempio, se il numero dei nodi corrente è 6, modificalo su 5:

   cassandra:
     replicaCount: 5 # (n-1 5 in this example)

4. Applica la modifica della configurazione al tuo cluster:

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

   Nota: devi aggiornare e applicare la proprietà cassandra.replicaCount a n-1 dopo aver ritirato ogni nodo. Ad esempio, se stai eseguendo lo scale down da sei nodi a tre, dovrai modificare e applicare cassandra.replicaCount tre volte.
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
   
   

6. Ripeti i passaggi da 1 a 5 per ogni nodo che vuoi ritirare.
7. Al termine del ritiro dei nodi, verifica che il valore cassandra.replicaCount corrisponda al numero di nodi restituiti dal comando nodetool status.

   Ad esempio, se hai scalato Cassandra fino a tre nodi:

   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   710.37 KiB  256          59.0%             b02089d1-0521-42e1-bbed-900656a58b68  ra-1
   UN  10.16.4.6   720.97 KiB  256          61.3%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1
   UN  10.16.5.13  209.23 KiB  256          62.2%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
   
   

8. Dopo aver ridotto le dimensioni del cluster Cassandra, assicurati di eliminare l'oggetto pvc (PersistentVolumeClaim) per assicurarti che l'evento di scale up successivo non utilizzi lo stesso volume permanente e i dati creati in precedenza.

   Recupera i nomi delle 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, i seguenti pvc corrispondono ai tre nodi abbandonati:

   • cassandra-data-apigee-cassandra-5
   • cassandra-data-apigee-cassandra-4
   • cassandra-data-apigee-cassandra-3
9. Elimina le PVC:

   kubectl -n yourNamespace delete pvc cassandra-data-apigee-cassandra-5
   persistentvolumeclaim "cassandra-data-apigee-cassandra-5" deleted
   kubectl -n yourNamespace delete pvc cassandra-data-apigee-cassandra-4
   persistentvolumeclaim "cassandra-data-apigee-cassandra-4" deleted
   kubectl -n yourNamespace delete pvc cassandra-data-apigee-cassandra-3
   persistentvolumeclaim "cassandra-data-apigee-cassandra-3" deleted

10. Verifica che il pvc sia stato eliminato:

    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

11. Se utilizzi l'installazione di Anthos, elimina il volume permanente dal cluster Anthos Kubernetes utilizzando la stessa sequenza.

    Ottieni i nomi dei volumi permanenti:

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

    In questo esempio i seguenti volumi corrispondono ai tre nodi privi di documenti:

    • 5: pvc-354afa95-81a3-11e9-8862-42010a8e014a
    • 4: pvc-0675a0ff-81a3-11e9-8862-42010a8e014a
    • 3: pvc-d29ba265-81a2-11e9-8862-42010a8e014a
12. Elimina i volumi permanenti:

    kubectl -n yourNamespace delete pv pvc-354afa95-81a3-11e9-8862-42010a8e014a
    kubectl -n yourNamespace delete pv pvc-0675a0ff-81a3-11e9-8862-42010a8e014a
    kubectl -n yourNamespace delete pv pvc-d29ba265-81a2-11e9-8862-42010a8e014a

13. Verifica che i volumi permanenti siano stati eliminati:

    kubectl get pv -n youNamespace
    NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                                      STORAGECLASS   REASON   AGE
    pvc-2956cb78-818d-11e9-8862-42010a8e014a   100Gi      RWO            Delete           Bound    apigee/cassandra-data-apigee-cassandra-default-1   apigee-gcepd            7h
    pvc-79de5407-8190-11e9-8862-42010a8e014a   100Gi      RWO            Delete           Bound    apigee/cassandra-data-apigee-cassandra-default-2   apigee-gcepd            7h
    pvc-f9c2a5b9-818c-11e9-8862-42010a8e014a   100Gi      RWO            Delete           Bound    apigee/cassandra-data-apigee-cassandra-default-0   apigee-gcepd            7h