本主題將說明如何水平和垂直擴充 Cassandra,以及如何縮減 Cassandra。
水平擴充 Cassandra
如要水平擴充 Cassandra
- 擴充 Cassandra 前,請視需要確認
apigee-data節點集區有額外容量。另請參閱設定專屬節點集區。 - 在覆寫檔案中設定
cassandra.replicaCount設定屬性的值。如要瞭解這項屬性,請參閱設定屬性參考資料。另請參閱「管理執行階段層元件」。 - 請套用變更,例如:
$APIGEE_HOME/apigeectl apply --datastore -f overrides/overrides.yaml
垂直調度 Cassandra 資源
本節說明如何垂直調度 Cassandra Pod 的資源,以因應更高的 CPU 和記憶體需求。
總覽
對於 Apigee Hybrid 實際工作環境部署作業,建議您至少建立兩個獨立的節點集區:一個用於有狀態服務 (Cassandra),另一個用於無狀態 (執行階段) 服務。例如,請參閱 GKE 實際工作環境叢集需求。
對於具備狀態的 Cassandra 節點集區,建議先從 8 個 CPU 核心和 30 GB 的記憶體開始。節點集區佈建完成後,即無法變更這些設定。 另請參閱「為實際工作環境設定 Cassandra」。
如要擴充 Cassandra Pod,以因應更高的 CPU 和記憶體需求,請按照本主題所述步驟操作。
調度 Cassandra pod 的資源
如要增加 Cassandra 使用的有狀態節點集區的 CPU 和記憶體,請按照下列步驟操作:
- 按照 Kubernetes 平台的說明,在叢集中新增節點集區。支援的平台列於安裝操作說明。
- 確認新節點集區已準備就緒:
kubectl get nodes -l NODE_POOL_LABEL_NAME=NODE_POOL_LABEL_VALUE
範例指令:
kubectl get nodes -l cloud.google.com/gke-nodepool=apigee-data-new
輸出範例:
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
- 更新覆寫檔案,將新的節點集區用於 Cassandra,並將 Pod 資源更新為您想使用的 CPU 數量和記憶體大小。舉例來說,如果是 GKE 叢集,請使用類似下列的設定。
如果您使用其他 Kubernetes 平台,請視情況調整
apigeeData.key值: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
例如:
nodeSelector: requiredForScheduling: true apigeeData: key: "cloud.google.com/gke-nodepool" value: "apigee-data-new" cassandra: resources: requests: cpu: 14 memory: 16Gi
- 將覆寫檔案套用至叢集:
$APIGEECTL_HOME/apigeectl apply -f ./overrides/overrides.yaml --datastore
完成這些步驟後,Cassandra Pod 就會開始轉移至新的節點集區。
縮減 Cassandra 規模
Apigee Hybrid 會使用一組 Cassandra 節點做為 StatefulSet。Cassandra 會在執行階段層為特定 Apigee 實體提供永久儲存空間。如要進一步瞭解 Cassandra,請參閱「關於執行階段平面」。
Cassandra 是耗用大量資源的服務,不應部署在含有任何其他混合式服務的 Pod 上。視負載而定,您可能需要縮減叢集中的環狀 Cassandra 節點數量。
縮減 Cassandra 環的一般程序如下:
- 確認 Cassandra 叢集運作正常,且有足夠的儲存空間可支援縮減作業。
- 更新
overrides.yaml中的cassandra.replicaCount屬性。 - 套用設定更新。
- 視叢集設定而定,刪除永久磁碟區要求或磁碟區。
注意事項
- 如果除了要停用的節點以外,還有其他節點狀況不佳,請勿繼續操作。Kubernetes 將無法縮減叢集中的 Pod。
- 請務必以三節點為單位縮減或擴增。
縮減 Cassandra
- 驗證叢集是否正常運作,以及所有節點是否都已啟動並執行中,如下列範例所示:
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
- 判斷 Cassandra 叢集是否有足夠的儲存空間可支援縮減。縮減規模後,Cassandra 節點的儲存空間使用率應不超過 75%。
舉例來說,如果叢集有 6 個 Cassandra 節點,且所有節點都已使用約 50% 的容量,縮減為 3 個節點會導致所有節點的容量使用率達到 100%,無法繼續運作。
不過,如果您有 9 個 Cassandra 節點,且所有節點都已填滿約 50%,縮減至 6 個節點後,每個剩餘節點就會填滿約 75%。你可以縮小。
- 在
overrides.yaml檔案中更新或新增cassandra.replicaCount屬性。舉例來說,如果目前的節點數為 9,請將其變更為 6:cassandra: replicaCount: 6 #
- 將設定變更套用至叢集:
./apigeectl apply --datastore -f overrides/override.yaml
namespace/apigee unchanged secret/ssl-cassandra unchanged storageclass.storage.k8s.io/apigee-gcepd unchanged service/apigee-cassandra unchanged statefulset.apps/apigee-cassandra configured
- 確認所有其餘 Cassandra 節點正在執行:
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
- 確認
cassandra.replicaCount值等於nodetool status指令傳回的節點數。舉例來說,如果將 Cassandra 縮減為六個節點:
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
- 縮減 Cassandra 叢集後,請確認 PVC (PersistentVolumeClaim) 對應至其餘 Cassandra 節點。
取得 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
在本範例中,您不應看到與三個縮減節點對應的 PVC:
cassandra-data-apigee-cassandra-8cassandra-data-apigee-cassandra-7cassandra-data-apigee-cassandra-6