本主題將說明如何水平和垂直擴充 Cassandra，以及如何縮減 Cassandra。
水平擴充 Cassandra
如何水平擴充 Cassandra
- 請務必先確認
apigee-data節點集區有額外的容量，再擴充 Cassandra。另請參閱「設定專屬節點集區」。 - 在覆寫檔案中設定
cassandra.replicaCount設定屬性的值。如要瞭解這項屬性，請參閱設定屬性參考資料。另請參閱「管理執行階段層元件」。 - 請套用變更，例如：
$APIGEE_HOME/apigeectl apply --datastore -f overrides/overrides.yaml
垂直調度 Cassandra
本節將說明如何垂直擴充 Cassandra pod，以因應更高的 CPU 和記憶體需求。
總覽
針對 Apigee 混合型實際工作環境部署作業，建議您至少建立兩個獨立的節點集區：一個用於有狀態服務 (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
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
停用 Cassandra 節點
-
使用 nodetool 指令，從叢集中停用 Cassandra 節點。
kubectl -n yourNamespace exec -it nodeName nodetool decommission
舉例來說，這個指令會停用
apigee-cassandra-5，也就是名稱中數值最高的節點：kubectl -n apigee exec -it apigee-cassandra-5 nodetool decommission
- 等待停用作業完成，並確認叢集現在少了一個節點。例如：
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
- 在
overrides.yaml檔案中更新或新增cassandra.replicaCount屬性。舉例來說，如果目前的節點數為 6，請將其改為 5：cassandra: replicaCount: 5 # (n-1 5 in this example)
- 將設定變更套用至叢集：
./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
- 確認所有剩餘的 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
- 針對要停用的每個節點重複執行步驟 1 到 5。
- 停用節點後，請確認
cassandra.replicaCount值等於nodetool status指令傳回的節點數量。舉例來說，如果您將 Cassandra 縮減為三個節點：
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
- 縮減 Cassandra 叢集後，請務必刪除 PVC (PersistentVolumeClaim)，確保下次縮放事件不會使用相同的永久磁碟區和先前建立的資料。
取得 PV 名稱：
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
在本範例中，下列 pvcs 對應至三個已停用的節點：
cassandra-data-apigee-cassandra-5cassandra-data-apigee-cassandra-4cassandra-data-apigee-cassandra-3
-
刪除 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" deletedkubectl -n yourNamespace delete pvc cassandra-data-apigee-cassandra-3 persistentvolumeclaim "cassandra-data-apigee-cassandra-3" deleted -
確認已刪除 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
- 如果您使用的是 Anthos 安裝程序，請按照相同的順序從 Anthos Kubernetes 叢集中刪除永久性磁碟。
取得永久磁碟區的名稱：
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
在本範例中，下列磁碟區對應於三個已停用的節點：
- 5：
pvc-354afa95-81a3-11e9-8862-42010a8e014a - 4：
pvc-0675a0ff-81a3-11e9-8862-42010a8e014a - 3：
pvc-d29ba265-81a2-11e9-8862-42010a8e014a
- 5：
-
刪除永久磁碟區：
kubectl -n yourNamespace delete pv pvc-354afa95-81a3-11e9-8862-42010a8e014a
kubectl -n yourNamespace delete pv pvc-0675a0ff-81a3-11e9-8862-42010a8e014akubectl -n yourNamespace delete pv pvc-d29ba265-81a2-11e9-8862-42010a8e014a -
確認已刪除永久磁碟：
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