本主題說明在 GKE、GKE On-Prem、Microsoft® Azure Kubernetes Service (AKS)、Amazon Elastic Kubernetes Service (EKS) 和 RedHat OpenShift 上,為 Apigee hybrid 進行多區域部署。在必要條件和程序中選取平台。
多地區部署的拓撲包括:
- Active-Active:如果您在多個地理位置部署應用程式,且需要低延遲的 API 回應,您可以選擇在距離客戶最近的多個地理區域部署混合式雲端。例如:美國西岸、美國東岸、歐洲、亞太/澳洲/紐西蘭。
- 主動-被動:當您有主要區域和容錯或災難復原區域時。
多區域混合式部署中的區域會透過 Cassandra 進行通訊,如下圖所示:
必要條件
為多個區域設定混合式連線之前,您必須完成下列先決條件:
GKE
- 在不同網路 (例如不同雲端服務供應商、不同虛擬私有雲網路、雲端和地端) 之間安裝多區域 Apigee 部署項目時,您必須在這些獨立網路之間提供內部連線,讓 Cassandra 可用於節點間的通訊。這可以透過 VPN 或雲端專屬連線解決方案完成。
- 在多個區域中設定具有不同 CIDR 區塊的 Kubernetes 叢集
- 確認每個叢集都已安裝 cert-manager
- 確認已安裝 ASM
- 設定跨區域通訊
- Cassandra 多區域規定:
- 請確認 Pod 網路命名空間在各區域之間具有連線能力,包括防火牆、VPN、VPC 對等互連和 vNet 對等互連。大多數 GKE 安裝作業都是如此。
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行),請為 Apigee 混合式多地區安裝的所有區域,在覆寫檔案中設定
cassandra.hostNetwork: true
,啟用 KuberneteshostNetwork
功能。如要瞭解 Kubernetes
hostNetwork
功能,請參閱 Kubernetes 說明文件中的「主機命名空間」。 - 請先在現有叢集上啟用
hostNetwork
,再將多區域設定擴展至新區域。 - 啟用
hostNetwork
時,請確認 worker 節點可執行反向 DNS 查詢。Apigee cassandra 會同時使用正向和反向 DNS 查詢,在啟動時取得主機 IP。 - 在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
詳情請參閱 Kubernetes 說明文件。
GKE On-Prem
- 在不同網路 (例如不同雲端服務供應商、不同虛擬私有雲網路、雲端和地端) 之間安裝多區域 Apigee 部署項目時,您必須在這些獨立網路之間提供內部連線,讓 Cassandra 可用於節點間的通訊。這可以透過 VPN 或雲端專屬連線解決方案完成。
- 在多個區域中設定具有不同 CIDR 區塊的 Kubernetes 叢集
- 確認每個叢集都已安裝 cert-manager
- 確認已安裝 ASM
- 設定跨區域通訊
- Cassandra 多區域規定:
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行,這是 GKE 在內部安裝的預設情況),請在 Apigee 混合多區安裝的所有區域中,在覆寫檔案中設定
cassandra.hostNetwork: true
,啟用 KuberneteshostNetwork
功能。如要瞭解 Kubernetes
hostNetwork
功能,請參閱 Kubernetes 說明文件中的「主機命名空間」。 - 請先在現有叢集上啟用
hostNetwork
,再將多區域設定擴展至新區域。 - 啟用
hostNetwork
時,請確認 worker 節點可執行反向 DNS 查詢。Apigee cassandra 會同時使用正向和反向 DNS 查詢,在啟動時取得主機 IP。 - 在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行,這是 GKE 在內部安裝的預設情況),請在 Apigee 混合多區安裝的所有區域中,在覆寫檔案中設定
詳情請參閱 Kubernetes 說明文件。
AKS
- 在不同網路 (例如不同雲端服務供應商、不同虛擬私有雲網路、雲端和地端) 之間安裝多區域 Apigee 部署項目時,您必須在這些獨立網路之間提供內部連線,讓 Cassandra 可用於節點間的通訊。這可以透過 VPN 或雲端專屬連線解決方案完成。
- 請按照混合式安裝指南的說明,完成 Google Cloud 和機構設定等先決條件,再繼續進行叢集設定步驟。
- 確認每個叢集都已安裝 cert-manager
- 確認已安裝 ASM
- Cassandra 多區域規定:
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行,這是 AKS 安裝作業的預設情況),請在 Apigee 混合多區安裝作業的所有區域中,在覆寫檔案中設定
cassandra.hostNetwork: true
,以便啟用 KuberneteshostNetwork
功能。如要瞭解 Kubernetes
hostNetwork
功能,請參閱 Kubernetes 說明文件中的「主機命名空間」。 - 請先在現有叢集上啟用
hostNetwork
,再將多區域設定擴展至新區域。 - 啟用
hostNetwork
時,請確認 worker 節點可執行反向 DNS 查詢。Apigee cassandra 會同時使用正向和反向 DNS 查詢,在啟動時取得主機 IP。 - 在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行,這是 AKS 安裝作業的預設情況),請在 Apigee 混合多區安裝作業的所有區域中,在覆寫檔案中設定
詳情請參閱 Kubernetes 說明文件。
EKS
- 在不同網路 (例如不同雲端服務供應商、不同虛擬私有雲網路、雲端和地端) 之間安裝多區域 Apigee 部署項目時,您必須在這些獨立網路之間提供內部連線,讓 Cassandra 可用於節點間的通訊。這可以透過 VPN 或雲端專屬連線解決方案完成。
- 請按照混合式安裝指南的說明,完成 Google Cloud 和機構設定等先決條件,再繼續進行叢集設定步驟。
- 確認每個叢集都已安裝 cert-manager
- 確認已安裝 ASM
- Cassandra 多區域規定:
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行),請在 Apigee 混合式多區域安裝的所有區域中,在覆寫檔案中設定
cassandra.hostNetwork: true
,以便啟用 KuberneteshostNetwork
功能。Amazon EKS 預設使用 完全整合的架構。如要瞭解 Kubernetes
hostNetwork
功能,請參閱 Kubernetes 說明文件中的「主機命名空間」。 - 請先在現有叢集上啟用
hostNetwork
,再將多區域設定擴展至新區域。 - 啟用
hostNetwork
時,請確認 worker 節點可執行反向 DNS 查詢。Apigee cassandra 會同時使用正向和反向 DNS 查詢,在啟動時取得主機 IP。 - 在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行),請在 Apigee 混合式多區域安裝的所有區域中,在覆寫檔案中設定
詳情請參閱 Kubernetes 說明文件。
OpenShift
- 在不同網路 (例如不同雲端服務供應商、不同虛擬私有雲網路、雲端和地端) 之間安裝多區域 Apigee 部署項目時,您必須在這些獨立網路之間提供內部連線,讓 Cassandra 可用於節點間的通訊。這可以透過 VPN 或雲端專屬連線解決方案完成。
- 請按照混合式安裝指南的說明,完成 Google Cloud 和機構設定等先決條件,再繼續進行叢集設定步驟。
- 確認每個叢集都已安裝 cert-manager
- 確認已安裝 ASM
- Cassandra 多區域規定:
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行,這是 OpenShift 安裝作業的預設情況),請在 Apigee 混合式多區安裝作業的所有區域中,在覆寫檔案中設定
cassandra.hostNetwork: true
,以便啟用 KuberneteshostNetwork
功能。如要瞭解 Kubernetes
hostNetwork
功能,請參閱 Kubernetes 說明文件中的「主機命名空間」。 - 請先在現有叢集上啟用
hostNetwork
,再將多區域設定擴展至新區域。 - 啟用
hostNetwork
時,請確認 worker 節點可執行反向 DNS 查詢。Apigee cassandra 會同時使用正向和反向 DNS 查詢,在啟動時取得主機 IP。 - 在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
- 如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行,這是 OpenShift 安裝作業的預設情況),請在 Apigee 混合式多區安裝作業的所有區域中,在覆寫檔案中設定
詳情請參閱 Kubernetes 說明文件。
為多區域設定 Apigee Hybrid
本節說明如何為多區域設定 Apigee Hybrid。
GKE
設定多區域種子主機
本節說明如何將現有的 Cassandra 叢集擴展至新區域。這項設定可讓新區域啟動叢集,並加入現有的資料中心。如果沒有這項設定,多區域 Kubernetes 叢集就不會彼此互通。
- 擷取種子名稱前,請先將 kubectl 結構定義設為原始叢集:
kubectl config use-context original-cluster-name
執行下列
kubectl
指令,找出目前區域中 Cassandra 的種子主機位址。種子主機位址可讓新的區域執行個體在首次啟動時找到原始叢集,以便瞭解叢集的拓樸。種子主機位址會指定為叢集中的聯絡點。
kubectl get pods -o wide -n apigee
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE apigee-cassandra-default-0 1/1 Running 0 5d 10.0.0.11 gke-k8s-dc-1-default-pool-a2206492-p55d apigee-cassandra-default-1 1/1 Running 0 5d 10.0.2.4 gke-k8s-dc-1-default-pool-e9daaab3-tjmz apigee-cassandra-default-2 1/1 Running 0 5d 10.0.3.5 gke-k8s-dc-1-default-pool-e589awq3-kjch
- 決定先前指令傳回的哪些 IP 將成為多區域種子主機。
- 在資料中心 2 中,請在「管理執行階段層元件」中設定
cassandra.multiRegionSeedHost
和cassandra.datacenter
,其中multiRegionSeedHost
是先前指令傳回的 IP 之一:cassandra: multiRegionSeedHost: seed_host_IP datacenter: data_center_name rack: rack_name hostNetwork: false
例如:
cassandra: multiRegionSeedHost: 10.0.0.11 datacenter: "dc-1" rack: "ra-1" hostNetwork: false
- 在新資料中心/區域中,在安裝混合型服務前,請在
overrides.yaml
中設定與第一個區域相同的 TLS 憑證和憑證。
設定新區域
設定種子主機後,您就可以設定新的區域。
如要設定新的區域,請按照下列步驟操作:
- 將憑證從現有叢集複製到新叢集。Cassandra 和其他混合式元件會使用新的 CA 根來進行 mTLS。因此,叢集中的憑證必須一致。
- 將內容設定為原始命名空間:
kubectl config use-context original-cluster-name
- 將目前的命名空間設定匯出至檔案:
kubectl get namespace namespace -o yaml > apigee-namespace.yaml
- 將
apigee-ca
密鑰匯出至檔案:kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
- 將結構定義設為新區域的叢集名稱:
kubectl config use-context new-cluster-name
- 將命名空間設定匯入新叢集。如果您在新區域中使用其他命名空間,請務必更新檔案中的「命名空間」:
kubectl apply -f apigee-namespace.yaml
將 Secret 匯入新叢集:
kubectl -n cert-manager apply -f apigee-ca.yaml
- 將內容設定為原始命名空間:
- 在新區域中安裝混合式。請確認
overrides-DC_name.yaml
檔案包含與第一個區域相同的 TLS 憑證,如前一個部分所述。執行下列兩個指令,即可在新區域中安裝混合型:
apigeectl init -f overrides/overrides-DC_name.yaml
apigeectl apply -f overrides/overrides-DC_name.yaml
- 執行下列指令,確認混合式安裝作業是否成功:
apigeectl check-ready -f overrides_DC_name.yaml
- 請執行下列指令,驗證 Cassandra 叢集設定。輸出內容應同時顯示現有和新資料中心。
kubectl exec apigee-cassandra-default-0 -n apigee \ -- nodetool -u JMX_user -pw JMX_password status
設定成功的示例:
Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.87.93 68.07 GiB 256 ? fb51465c-167a-42f7-98c9-b6eba1de34de c UN 10.132.84.94 69.9 GiB 256 ? f621a5ac-e7ee-48a9-9a14-73d69477c642 b UN 10.132.84.105 76.95 GiB 256 ? 0561086f-e95b-4232-ba6c-ad519ff30336 d Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.0.8 71.61 GiB 256 ? 8894a98b-8406-45de-99e2-f404ab10b5d6 c UN 10.132.9.204 75.1 GiB 256 ? afa0ffa3-630b-4f1e-b46f-fc3df988092e a UN 10.132.3.133 68.08 GiB 256 ? 25ae39ab-b39e-4d4f-9cb7-de095ab873db b
- 在新資料中心的所有 pod 上設定 Cassandra。
- 使用下列指令從叢集中取得
apigeeorg
:kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
例如:
Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name "rg-hybrid-b7d3b9c"
- 建立 Cassandra 資料複製自訂資源 (
YAML
) 檔案。檔案名稱不限。在以下範例中,檔案名稱為datareplication.yaml
。檔案必須包含下列內容:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: REGION_EXPANSION namespace: NAMESPACE spec: organizationRef: APIGEEORG_VALUE force: false source: region: SOURCE_REGION
其中:
- REGION_EXPANSION 是您要為此中繼資料指定的名稱。您可以使用任何名稱。
- NAMESPACE 與
overrides.yaml
提供的命名空間相同。通常是「apigee
」。 - APIGEEORG_VALUE 是上一個步驟中
kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
指令的輸出值。例如:rg-hybrid-b7d3b9c
- SOURCE_REGION 是來源地區中的資料中心名稱。這是
overrides.yaml
中為cassandra:datacenter:
設定的值。
例如:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: rg-hybrid-b7d3b9c force: false source: region: "dc-1"
- 使用下列指令套用
CassandraDataReplication
:kubectl apply -f datareplication.yaml
- 使用下列指令確認重建狀態。
kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication
結果應如下所示:
{ "rebuildDetails": { "apigee-cassandra-default-0": { "state": "complete", "updated": 1623105760 }, "apigee-cassandra-default-1": { "state": "complete", "updated": 1623105765 }, "apigee-cassandra-default-2": { "state": "complete", "updated": 1623105770 } }, "state": "complete", "updated": 1623105770 }
- 使用下列指令從叢集中取得
- 請透過記錄檔確認重建程序。此外,請使用
nodetool status
指令驗證資料大小:kubectl logs apigee-cassandra-default-0 -f -n apigee
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status
以下範例顯示記錄項目:
INFO 01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens) INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB) INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed
- 更新種子主機。從
overrides-DC_name.yaml
中移除multiRegionSeedHost: 10.0.0.11
,然後重新套用。apigeectl apply -f overrides/overrides-DC_name.yaml
檢查 Cassandra 叢集狀態
下列指令可用於查看叢集設定是否在兩個資料中心中成功。這個指令會檢查兩個區域的 nodetool 狀態。
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.12.1.45 112.09 KiB 256 100.0% 3c98c816-3f4d-48f0-9717-03d0c998637f ra-1 UN 10.12.4.36 95.27 KiB 256 100.0% 0a36383d-1d9e-41e2-924c-7b62be12d6cc ra-1 UN 10.12.5.22 88.7 KiB 256 100.0% 3561f4fa-af3d-4ea4-93b2-79ac7e938201 ra-1 Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.0.4.33 78.69 KiB 256 0.0% a200217d-260b-45cd-b83c-182b27ff4c99 ra-1 UN 10.0.0.21 78.68 KiB 256 0.0% 9f3364b9-a7a1-409c-9356-b7d1d312e52b ra-1 UN 10.0.1.26 15.46 KiB 256 0.0% 1666df0f-702e-4c5b-8b6e-086d0f2e47fa ra-1
GKE On-Prem
設定多區域種子主機
本節說明如何將現有的 Cassandra 叢集擴展至新區域。這項設定可讓新區域啟動叢集,並加入現有的資料中心。如果沒有這項設定,多區域 Kubernetes 叢集就不會彼此互通。
- 在原始叢集的
overrides.yaml
檔案中,確認cassandra:hostNetwork
已設為true
。例如:cassandra: hostNetwork: true
如要進一步瞭解設定
hostNetwork: true
的時機,請參閱「先決條件」一節。 - 如果
cassandra:hostNetwork
未設為true
,請執行下列操作:-
將
cassandra.hostNetwork
變更為true
。 -
使用以下指令套用
overrides.yaml
設定檔:apigeectl apply -f overrides.yaml --datastore
- 等待 Cassandra Pod 完成逐步重新啟動。
-
使用下列指令確認 Cassandra 叢集是否正常運作:
kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD status
請確認輸出內容中的所有 Cassandra 節點均處於 UN (正常運作) 狀態:
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD describecluster
確認輸出結果中沒有無法到達的節點。
-
將
- 擷取種子名稱前,請先將 kubectl 結構定義設為原始叢集:
kubectl config use-context original-cluster-name
執行下列
kubectl
指令,找出目前區域中 Cassandra 的種子主機位址。種子主機位址可讓新的區域執行個體在首次啟動時找到原始叢集,以便瞭解叢集的拓樸。種子主機位址會指定為叢集中的聯絡點。
kubectl get pods -o wide -n apigee
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE apigee-cassandra-default-0 1/1 Running 0 5d 10.0.0.11 gke-k8s-dc-1-default-pool-a2206492-p55d apigee-cassandra-default-1 1/1 Running 0 5d 10.0.2.4 gke-k8s-dc-1-default-pool-e9daaab3-tjmz apigee-cassandra-default-2 1/1 Running 0 5d 10.0.3.5 gke-k8s-dc-1-default-pool-e589awq3-kjch
- 決定先前指令傳回的哪些 IP 將成為多區域種子主機。
-
在資料中心 2 中,在覆寫檔案中設定
cassandra.multiRegionSeedHost
,其中multiRegionSeedHost
是先前指令傳回的 IP 之一:cassandra: hostNetwork: true multiRegionSeedHost: seed_host_IP datacenter: data_center_name
例如:
cassandra: hostNetwork: true multiRegionSeedHost: 10.0.0.11 datacenter: "dc-1"
- 在新資料中心/區域中,在安裝混合型服務前,請在
overrides.yaml
中設定與第一個區域相同的 TLS 憑證和憑證。
設定新區域
設定種子主機後,您就可以設定新的區域。
如要設定新的區域,請按照下列步驟操作:
- 將憑證從現有叢集複製到新叢集。Cassandra 和其他混合式元件會使用新的 CA 根來進行 mTLS。因此,叢集中的憑證必須一致。
- 將內容設定為原始命名空間:
kubectl config use-context original-cluster-name
- 將目前的命名空間設定匯出至檔案:
kubectl get namespace namespace -o yaml > apigee-namespace.yaml
- 將
apigee-ca
密鑰匯出至檔案:kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
- 將結構定義設為新區域的叢集名稱:
kubectl config use-context new-cluster-name
- 將命名空間設定匯入新叢集。如果您在新區域中使用其他命名空間,請務必更新檔案中的「命名空間」:
kubectl apply -f apigee-namespace.yaml
將 Secret 匯入新叢集:
kubectl -n cert-manager apply -f apigee-ca.yaml
- 將內容設定為原始命名空間:
- 在新區域中安裝混合式。請確認
overrides-DC_name.yaml
檔案包含與第一個區域相同的 TLS 憑證,如前一個部分所述。執行下列兩個指令,即可在新區域中安裝混合型:
apigeectl init -f overrides/overrides-DC_name.yaml
apigeectl apply -f overrides/overrides-DC_name.yaml
- 執行下列指令,確認混合式安裝作業是否成功:
apigeectl check-ready -f overrides_DC_name.yaml
- 請執行下列指令,驗證 Cassandra 叢集設定。輸出內容應同時顯示現有和新資料中心。
kubectl exec apigee-cassandra-default-0 -n apigee \ -- nodetool -u JMX_user -pw JMX_password status
設定成功的示例:
Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.87.93 68.07 GiB 256 ? fb51465c-167a-42f7-98c9-b6eba1de34de c UN 10.132.84.94 69.9 GiB 256 ? f621a5ac-e7ee-48a9-9a14-73d69477c642 b UN 10.132.84.105 76.95 GiB 256 ? 0561086f-e95b-4232-ba6c-ad519ff30336 d Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.0.8 71.61 GiB 256 ? 8894a98b-8406-45de-99e2-f404ab10b5d6 c UN 10.132.9.204 75.1 GiB 256 ? afa0ffa3-630b-4f1e-b46f-fc3df988092e a UN 10.132.3.133 68.08 GiB 256 ? 25ae39ab-b39e-4d4f-9cb7-de095ab873db b
- 在新資料中心的所有 pod 上設定 Cassandra。
- 使用下列指令從叢集中取得
apigeeorg
:kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
例如:
Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name "rg-hybrid-b7d3b9c"
- 建立 Cassandra 資料複製自訂資源 (
YAML
) 檔案。檔案名稱不限。在以下範例中,檔案名稱為datareplication.yaml
。檔案必須包含下列內容:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: REGION_EXPANSION namespace: NAMESPACE spec: organizationRef: APIGEEORG_VALUE force: false source: region: SOURCE_REGION
其中:
- REGION_EXPANSION 是您要為此中繼資料指定的名稱。您可以使用任何名稱。
- NAMESPACE 與
overrides.yaml
提供的命名空間相同。通常是「apigee
」。 - APIGEEORG_VALUE 是上一個步驟中
kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
指令的輸出值。例如:rg-hybrid-b7d3b9c
- SOURCE_REGION 是來源地區中的資料中心名稱。這是
overrides.yaml
中為cassandra:datacenter:
設定的值。
例如:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: rg-hybrid-b7d3b9c force: false source: region: "dc-1"
- 使用下列指令套用
CassandraDataReplication
:kubectl apply -f datareplication.yaml
- 使用下列指令確認重建狀態。
kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication
結果應如下所示:
{ "rebuildDetails": { "apigee-cassandra-default-0": { "state": "complete", "updated": 1623105760 }, "apigee-cassandra-default-1": { "state": "complete", "updated": 1623105765 }, "apigee-cassandra-default-2": { "state": "complete", "updated": 1623105770 } }, "state": "complete", "updated": 1623105770 }
- 使用下列指令從叢集中取得
- 請透過記錄檔確認重建程序。此外,請使用
nodetool status
指令驗證資料大小:kubectl logs apigee-cassandra-default-0 -f -n apigee
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status
以下範例顯示記錄項目:
INFO 01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens) INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB) INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed
- 更新種子主機。從
overrides-DC_name.yaml
中移除multiRegionSeedHost: 10.0.0.11
,然後重新套用。apigeectl apply -f overrides/overrides-DC_name.yaml
檢查 Cassandra 叢集狀態
下列指令可用於查看叢集設定是否在兩個資料中心中成功。這個指令會檢查兩個區域的 nodetool 狀態。
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.12.1.45 112.09 KiB 256 100.0% 3c98c816-3f4d-48f0-9717-03d0c998637f ra-1 UN 10.12.4.36 95.27 KiB 256 100.0% 0a36383d-1d9e-41e2-924c-7b62be12d6cc ra-1 UN 10.12.5.22 88.7 KiB 256 100.0% 3561f4fa-af3d-4ea4-93b2-79ac7e938201 ra-1 Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.0.4.33 78.69 KiB 256 0.0% a200217d-260b-45cd-b83c-182b27ff4c99 ra-1 UN 10.0.0.21 78.68 KiB 256 0.0% 9f3364b9-a7a1-409c-9356-b7d1d312e52b ra-1 UN 10.0.1.26 15.46 KiB 256 0.0% 1666df0f-702e-4c5b-8b6e-086d0f2e47fa ra-1
AKS
在各個區域中建立虛擬網路
請按照 Azure 建議的跨區域通訊方式,如VNet 對 VNet:連結 Azure 中位於不同區域的虛擬網路。
建立多區域叢集
在具有不同 CIDR 區塊的多個區域中設定 Kubernetes 叢集。另請參閱「步驟 1:建立叢集」。使用先前建立的位置和虛擬網路名稱。
在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
設定多區域種子主機
本節說明如何將現有的 Cassandra 叢集擴展至新區域。這項設定可讓新區域啟動叢集,並加入現有的資料中心。如果沒有這項設定,多區域 Kubernetes 叢集就不會彼此互通。
- 在原始叢集的
overrides.yaml
檔案中,確認cassandra:hostNetwork
已設為true
。例如:cassandra: hostNetwork: true
如要進一步瞭解設定
hostNetwork: true
的時機,請參閱「先決條件」一節。 - 如果
cassandra:hostNetwork
未設為true
,請執行下列操作:-
將
cassandra.hostNetwork
變更為true
。 -
使用以下指令套用
overrides.yaml
設定檔:apigeectl apply -f overrides.yaml --datastore
- 等待 Cassandra Pod 完成逐步重新啟動。
-
使用下列指令確認 Cassandra 叢集是否正常運作:
kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD status
請確認輸出內容中的所有 Cassandra 節點均處於 UN (正常運作) 狀態:
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD describecluster
確認輸出結果中沒有無法到達的節點。
-
將
- 擷取種子名稱前,請先將 kubectl 結構定義設為原始叢集:
kubectl config use-context original-cluster-name
執行下列
kubectl
指令,找出目前區域中 Cassandra 的種子主機位址。種子主機位址可讓新的區域執行個體在首次啟動時找到原始叢集,以便瞭解叢集的拓樸。種子主機位址會指定為叢集中的聯絡點。
kubectl get pods -o wide -n apigee | grep apigee-cassandra
apigee-cassandra-default-0 1/1 Running 0 4d17h 120.38.1.9 aks-agentpool-21207753-vmss000000
-
決定先前指令傳回的哪些 IP 將成為多區域種子主機。在本例中,只有單一節點 Cassandra 叢集在執行,因此種子主機為
120.38.1.9
。 - 在資料中心 2 中,將覆寫檔案複製到名稱包含叢集名稱的新檔案中。例如:
overrides_your_cluster_name.yaml
。 - 在資料中心 2 中,在
overrides_your_cluster_name.yaml
中設定cassandra.multiRegionSeedHost
和cassandra.datacenter
,其中multiRegionSeedHost
是先前指令傳回的 IP 之一:cassandra: multiRegionSeedHost: seed_host_IP datacenter: data_center_name rack: rack_name hostNetwork: true
例如:
cassandra: multiRegionSeedHost: 120.38.1.9 datacenter: "dc-1" rack: "ra-1" hostNetwork: true
- 在新資料中心/區域中,在安裝混合型服務前,請在
overrides_your_cluster_name.yaml
中設定與第一個區域相同的 TLS 憑證和憑證。
設定新區域
設定種子主機後,您就可以設定新的區域。
如要設定新的區域,請按照下列步驟操作:
- 將憑證從現有叢集複製到新叢集。Cassandra 和其他混合式元件會使用新的 CA 根來進行 mTLS。因此,叢集中的憑證必須一致。
- 將內容設定為原始命名空間:
kubectl config use-context original-cluster-name
- 將目前的命名空間設定匯出至檔案:
kubectl get namespace namespace -o yaml > apigee-namespace.yaml
- 將
apigee-ca
密鑰匯出至檔案:kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
- 將結構定義設為新區域的叢集名稱:
kubectl config use-context new-cluster-name
- 將命名空間設定匯入新叢集。如果您在新區域中使用其他命名空間,請務必更新檔案中的「命名空間」:
kubectl apply -f apigee-namespace.yaml
將 Secret 匯入新叢集:
kubectl -n cert-manager apply -f apigee-ca.yaml
- 將內容設定為原始命名空間:
- 在新區域中安裝混合式。請確認
overrides_your_cluster_name.yaml
檔案包含與第一個區域相同的 TLS 憑證,如前一個部分所述。執行下列兩個指令,即可在新區域中安裝混合型:
apigeectl init -f overrides_your_cluster_name.yaml
apigeectl apply -f overrides_your_cluster_name.yaml
- 執行下列指令,確認混合式安裝作業是否成功:
apigeectl check-ready -f overrides_your_cluster_name.yaml
- 請執行下列指令,驗證 Cassandra 叢集設定。輸出內容應同時顯示現有和新資料中心。
kubectl exec apigee-cassandra-default-0 -n apigee \ -- nodetool -u JMX_user -pw JMX_password status
設定成功的示例:
Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.87.93 68.07 GiB 256 ? fb51465c-167a-42f7-98c9-b6eba1de34de c UN 10.132.84.94 69.9 GiB 256 ? f621a5ac-e7ee-48a9-9a14-73d69477c642 b UN 10.132.84.105 76.95 GiB 256 ? 0561086f-e95b-4232-ba6c-ad519ff30336 d Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.0.8 71.61 GiB 256 ? 8894a98b-8406-45de-99e2-f404ab10b5d6 c UN 10.132.9.204 75.1 GiB 256 ? afa0ffa3-630b-4f1e-b46f-fc3df988092e a UN 10.132.3.133 68.08 GiB 256 ? 25ae39ab-b39e-4d4f-9cb7-de095ab873db b
- 在新資料中心的所有 pod 上設定 Cassandra。
- 使用下列指令從叢集中取得
apigeeorg
:kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
例如:
Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name "rg-hybrid-b7d3b9c"
- 建立 Cassandra 資料複製自訂資源 (
YAML
) 檔案。檔案名稱不限。在以下範例中,檔案名稱為datareplication.yaml
。檔案必須包含下列內容:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: REGION_EXPANSION namespace: NAMESPACE spec: organizationRef: APIGEEORG_VALUE force: false source: region: SOURCE_REGION
其中:
- REGION_EXPANSION 是您要為此中繼資料指定的名稱。您可以使用任何名稱。
- NAMESPACE 與
overrides.yaml
提供的命名空間相同。通常是「apigee
」。 - APIGEEORG_VALUE 是上一個步驟中
kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
指令的輸出值。例如:rg-hybrid-b7d3b9c
- SOURCE_REGION 是來源地區中的資料中心名稱。這是
overrides.yaml
中為cassandra:datacenter:
設定的值。
例如:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: rg-hybrid-b7d3b9c force: false source: region: "dc-1"
- 使用下列指令套用
CassandraDataReplication
:kubectl apply -f datareplication.yaml
- 使用下列指令確認重建狀態。
kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication
結果應如下所示:
{ "rebuildDetails": { "apigee-cassandra-default-0": { "state": "complete", "updated": 1623105760 }, "apigee-cassandra-default-1": { "state": "complete", "updated": 1623105765 }, "apigee-cassandra-default-2": { "state": "complete", "updated": 1623105770 } }, "state": "complete", "updated": 1623105770 }
- 使用下列指令從叢集中取得
- 請透過記錄檔確認重建程序。此外,請使用
nodetool status
指令驗證資料大小:kubectl logs apigee-cassandra-default-0 -f -n apigee
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status
以下範例顯示記錄項目:
INFO 01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens) INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB) INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed
- 更新種子主機。從
overrides-DC_name.yaml
中移除multiRegionSeedHost: 10.0.0.11
,然後重新套用。apigeectl apply -f overrides/overrides-DC_name.yaml
檢查 Cassandra 叢集狀態
下列指令可用於查看叢集設定是否在兩個資料中心中成功。這個指令會檢查兩個區域的 nodetool 狀態。
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.12.1.45 112.09 KiB 256 100.0% 3c98c816-3f4d-48f0-9717-03d0c998637f ra-1 UN 10.12.4.36 95.27 KiB 256 100.0% 0a36383d-1d9e-41e2-924c-7b62be12d6cc ra-1 UN 10.12.5.22 88.7 KiB 256 100.0% 3561f4fa-af3d-4ea4-93b2-79ac7e938201 ra-1 Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.0.4.33 78.69 KiB 256 0.0% a200217d-260b-45cd-b83c-182b27ff4c99 ra-1 UN 10.0.0.21 78.68 KiB 256 0.0% 9f3364b9-a7a1-409c-9356-b7d1d312e52b ra-1 UN 10.0.1.26 15.46 KiB 256 0.0% 1666df0f-702e-4c5b-8b6e-086d0f2e47fa ra-1
EKS
在各個區域中建立虛擬網路
請按照「 什麼是 VPC 互連?」一文所述的 AWS 建議,建立跨區域通訊。AWS 使用不同區域的術語是「跨區域 VPC 對等互連」。
建立多區域叢集
在具有不同 CIDR 區塊的多個區域中設定 Kubernetes 叢集。另請參閱「步驟 1:建立叢集」。使用先前建立的位置和虛擬網路名稱。
在所有區域的 Kubernetes 叢集之間開啟 Cassandra 連接埠,讓各區域和資料中心的工作站節點能夠通訊。如要瞭解 Cassandra 通訊埠編號,請參閱「設定通訊埠」。
設定多區域種子主機
本節說明如何將現有的 Cassandra 叢集擴展至新區域。這項設定可讓新區域啟動叢集,並加入現有的資料中心。如果沒有這項設定,多區域 Kubernetes 叢集就不會彼此互通。
- 在原始叢集的
overrides.yaml
檔案中,確認cassandra:hostNetwork
已設為true
。例如:cassandra: hostNetwork: true
如要進一步瞭解設定
hostNetwork: true
的時機,請參閱「先決條件」一節。 - 如果
cassandra:hostNetwork
未設為true
,請執行下列操作:-
將
cassandra.hostNetwork
變更為true
。 -
使用以下指令套用
overrides.yaml
設定檔:apigeectl apply -f overrides.yaml --datastore
- 等待 Cassandra Pod 完成逐步重新啟動。
-
使用下列指令確認 Cassandra 叢集是否正常運作:
kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD status
請確認輸出內容中的所有 Cassandra 節點均處於 UN (正常運作) 狀態:
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD describecluster
確認輸出結果中沒有無法到達的節點。
-
將
- 擷取種子名稱前,請先將 kubectl 結構定義設為原始叢集:
kubectl config use-context original-cluster-name
執行下列
kubectl
指令,找出目前區域中 Cassandra 的種子主機位址。種子主機位址可讓新的區域執行個體在首次啟動時找到原始叢集,以便瞭解叢集的拓樸。種子主機位址會指定為叢集中的聯絡點。
kubectl get pods -o wide -n apigee | grep apigee-cassandra
apigee-cassandra-default-0 1/1 Running 0 4d17h 120.38.1.9 aks-agentpool-21207753-vmss000000
-
決定先前指令傳回的哪些 IP 將成為多區域種子主機。在本例中,只有單一節點 Cassandra 叢集在執行,因此種子主機為
120.38.1.9
。 - 在資料中心 2 中,將覆寫檔案複製到名稱包含叢集名稱的新檔案中。例如:
overrides_your_cluster_name.yaml
。 - 在資料中心 2 中,在
overrides_your_cluster_name.yaml
中設定cassandra.multiRegionSeedHost
和cassandra.datacenter
,其中multiRegionSeedHost
是先前指令傳回的 IP 之一:cassandra: multiRegionSeedHost: seed_host_IP datacenter: data_center_name rack: rack_name hostNetwork: true
例如:
cassandra: multiRegionSeedHost: 120.38.1.9 datacenter: "dc-1" rack: "ra-1" hostNetwork: true
- 在新資料中心/區域中,在安裝混合型服務前,請在
overrides_your_cluster_name.yaml
中設定與第一個區域相同的 TLS 憑證和憑證。
設定新區域
設定種子主機後,您就可以設定新的區域。
如要設定新的區域,請按照下列步驟操作:
- 將憑證從現有叢集複製到新叢集。Cassandra 和其他混合式元件會使用新的 CA 根來進行 mTLS。因此,叢集中的憑證必須一致。
- 將內容設定為原始命名空間:
kubectl config use-context original-cluster-name
- 將目前的命名空間設定匯出至檔案:
kubectl get namespace namespace -o yaml > apigee-namespace.yaml
- 將
apigee-ca
密鑰匯出至檔案:kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
- 將結構定義設為新區域的叢集名稱:
kubectl config use-context new-cluster-name
- 將命名空間設定匯入新叢集。如果您在新區域中使用其他命名空間,請務必更新檔案中的「命名空間」:
kubectl apply -f apigee-namespace.yaml
將 Secret 匯入新叢集:
kubectl -n cert-manager apply -f apigee-ca.yaml
- 將內容設定為原始命名空間:
- 在新區域中安裝混合式。請確認
overrides_your_cluster_name.yaml
檔案包含與第一個區域相同的 TLS 憑證,如前一個部分所述。執行下列兩個指令,即可在新區域中安裝混合型:
apigeectl init -f overrides_your_cluster_name.yaml
apigeectl apply -f overrides_your_cluster_name.yaml
- 執行下列指令,確認混合式安裝作業是否成功:
apigeectl check-ready -f overrides_your_cluster_name.yaml
- 請執行下列指令,驗證 Cassandra 叢集設定。輸出內容應同時顯示現有和新資料中心。
kubectl exec apigee-cassandra-default-0 -n apigee \ -- nodetool -u JMX_user -pw JMX_password status
設定成功的示例:
Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.87.93 68.07 GiB 256 ? fb51465c-167a-42f7-98c9-b6eba1de34de c UN 10.132.84.94 69.9 GiB 256 ? f621a5ac-e7ee-48a9-9a14-73d69477c642 b UN 10.132.84.105 76.95 GiB 256 ? 0561086f-e95b-4232-ba6c-ad519ff30336 d Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.0.8 71.61 GiB 256 ? 8894a98b-8406-45de-99e2-f404ab10b5d6 c UN 10.132.9.204 75.1 GiB 256 ? afa0ffa3-630b-4f1e-b46f-fc3df988092e a UN 10.132.3.133 68.08 GiB 256 ? 25ae39ab-b39e-4d4f-9cb7-de095ab873db b
- 在新資料中心的所有 pod 上設定 Cassandra。
- 使用下列指令從叢集中取得
apigeeorg
:kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
例如:
Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name "rg-hybrid-b7d3b9c"
- 建立 Cassandra 資料複製自訂資源 (
YAML
) 檔案。檔案名稱不限。在以下範例中,檔案名稱為datareplication.yaml
。檔案必須包含下列內容:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: REGION_EXPANSION namespace: NAMESPACE spec: organizationRef: APIGEEORG_VALUE force: false source: region: SOURCE_REGION
其中:
- REGION_EXPANSION 是您要為此中繼資料指定的名稱。您可以使用任何名稱。
- NAMESPACE 與
overrides.yaml
提供的命名空間相同。通常是「apigee
」。 - APIGEEORG_VALUE 是上一個步驟中
kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
指令的輸出值。例如:rg-hybrid-b7d3b9c
- SOURCE_REGION 是來源地區中的資料中心名稱。這是
overrides.yaml
中為cassandra:datacenter:
設定的值。
例如:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: rg-hybrid-b7d3b9c force: false source: region: "dc-1"
- 使用下列指令套用
CassandraDataReplication
:kubectl apply -f datareplication.yaml
- 使用下列指令確認重建狀態。
kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication
結果應如下所示:
{ "rebuildDetails": { "apigee-cassandra-default-0": { "state": "complete", "updated": 1623105760 }, "apigee-cassandra-default-1": { "state": "complete", "updated": 1623105765 }, "apigee-cassandra-default-2": { "state": "complete", "updated": 1623105770 } }, "state": "complete", "updated": 1623105770 }
- 使用下列指令從叢集中取得
- 請透過記錄檔確認重建程序。此外,請使用
nodetool status
指令驗證資料大小:kubectl logs apigee-cassandra-default-0 -f -n apigee
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status
以下範例顯示記錄項目:
INFO 01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens) INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB) INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed
- 更新種子主機。從
overrides-DC_name.yaml
中移除multiRegionSeedHost: 10.0.0.11
,然後重新套用。apigeectl apply -f overrides/overrides-DC_name.yaml
檢查 Cassandra 叢集狀態
下列指令可用於查看叢集設定是否在兩個資料中心中成功。這個指令會檢查兩個區域的 nodetool 狀態。
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.12.1.45 112.09 KiB 256 100.0% 3c98c816-3f4d-48f0-9717-03d0c998637f ra-1 UN 10.12.4.36 95.27 KiB 256 100.0% 0a36383d-1d9e-41e2-924c-7b62be12d6cc ra-1 UN 10.12.5.22 88.7 KiB 256 100.0% 3561f4fa-af3d-4ea4-93b2-79ac7e938201 ra-1 Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.0.4.33 78.69 KiB 256 0.0% a200217d-260b-45cd-b83c-182b27ff4c99 ra-1 UN 10.0.0.21 78.68 KiB 256 0.0% 9f3364b9-a7a1-409c-9356-b7d1d312e52b ra-1 UN 10.0.1.26 15.46 KiB 256 0.0% 1666df0f-702e-4c5b-8b6e-086d0f2e47fa ra-1
OpenShift
設定多區域種子主機
本節說明如何將現有的 Cassandra 叢集擴展至新區域。這項設定可讓新區域啟動叢集,並加入現有的資料中心。如果沒有這項設定,多區域 Kubernetes 叢集就不會彼此互通。
- 在原始叢集的
overrides.yaml
檔案中,確認cassandra:hostNetwork
已設為true
。例如:cassandra: hostNetwork: true
如要進一步瞭解設定
hostNetwork: true
的時機,請參閱「先決條件」一節。 - 如果
cassandra:hostNetwork
未設為true
,請執行下列操作:-
將
cassandra.hostNetwork
變更為true
。 -
使用以下指令套用
overrides.yaml
設定檔:apigeectl apply -f overrides.yaml --datastore
- 等待 Cassandra Pod 完成逐步重新啟動。
-
使用下列指令確認 Cassandra 叢集是否正常運作:
kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD status
請確認輸出內容中的所有 Cassandra 節點均處於 UN (正常運作) 狀態:
nodetool -u $APIGEE_JMX_USER -pw $APIGEE_JMX_PASSWORD describecluster
確認輸出結果中沒有無法到達的節點。
-
將
- 擷取種子名稱前,請先將 kubectl 結構定義設為原始叢集:
kubectl config use-context original-cluster-name
執行下列
kubectl
指令,找出目前區域中 Cassandra 的種子主機位址。種子主機位址可讓新的區域執行個體在首次啟動時找到原始叢集,以便瞭解叢集的拓樸。種子主機位址會指定為叢集中的聯絡點。
kubectl get pods -o wide -n apigee
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE apigee-cassandra-default-0 1/1 Running 0 5d 10.0.0.11 gke-k8s-dc-1-default-pool-a2206492-p55d apigee-cassandra-default-1 1/1 Running 0 5d 10.0.2.4 gke-k8s-dc-1-default-pool-e9daaab3-tjmz apigee-cassandra-default-2 1/1 Running 0 5d 10.0.3.5 gke-k8s-dc-1-default-pool-e589awq3-kjch
-
選取來源 Cassandra 主機的 IP 位址,做為多區域種子主機。在這個範例中,這是正在執行的
apigee-cassandra-default-0
叢集,種子主機為10.0.0.11
。 - 在資料中心 2 中,將覆寫檔案複製到名稱包含叢集名稱的新檔案中。例如:
overrides_your_cluster_name.yaml
。 - 在資料中心 2 中,在
overrides_your_cluster_name.yaml
中設定cassandra.multiRegionSeedHost
和cassandra.datacenter
,其中multiRegionSeedHost
是先前指令傳回的 IP 之一:cassandra: hostNetwork: true multiRegionSeedHost: seed_host_IP # Cassandra pod IP address from the source region. datacenter: data_center_name
例如:
cassandra: hostNetwork: true multiRegionSeedHost: 10.0.0.11 datacenter: "dc-1"
- 在新資料中心/區域中,在安裝混合型服務前,請在
overrides_your_cluster_name.yaml
中設定與第一個區域相同的 TLS 憑證和憑證。
設定新區域
設定種子主機後,您就可以設定新的區域。
如要設定新的區域,請按照下列步驟操作:
- 將憑證從現有叢集複製到新叢集。Cassandra 和其他混合式元件會使用新的 CA 根來進行 mTLS。因此,叢集中的憑證必須一致。
- 將內容設定為原始命名空間:
kubectl config use-context original-cluster-name
- 將目前的命名空間設定匯出至檔案:
kubectl get namespace namespace -o yaml > apigee-namespace.yaml
- 將
apigee-ca
密鑰匯出至檔案:kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
- 將結構定義設為新區域的叢集名稱:
kubectl config use-context new-cluster-name
- 將命名空間設定匯入新叢集。如果您在新區域中使用其他命名空間,請務必更新檔案中的「命名空間」:
kubectl apply -f apigee-namespace.yaml
將 Secret 匯入新叢集:
kubectl -n cert-manager apply -f apigee-ca.yaml
- 將內容設定為原始命名空間:
- 在新區域中安裝混合式。請確認
overrides_your_cluster_name.yaml
檔案包含與第一個區域相同的 TLS 憑證,如前一個部分所述。執行下列兩個指令,即可在新區域中安裝混合型:
apigeectl init -f overrides_your_cluster_name.yaml
apigeectl apply -f overrides_your_cluster_name.yaml
- 執行下列指令,確認混合式安裝作業是否成功:
apigeectl check-ready -f overrides_your_cluster_name.yaml
- 請執行下列指令,驗證 Cassandra 叢集設定。輸出內容應同時顯示現有和新資料中心。
kubectl exec apigee-cassandra-default-0 -n apigee \ -- nodetool -u JMX_user -pw JMX_password status
設定成功的示例:
Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.87.93 68.07 GiB 256 ? fb51465c-167a-42f7-98c9-b6eba1de34de c UN 10.132.84.94 69.9 GiB 256 ? f621a5ac-e7ee-48a9-9a14-73d69477c642 b UN 10.132.84.105 76.95 GiB 256 ? 0561086f-e95b-4232-ba6c-ad519ff30336 d Datacenter: dc-1 ==================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 10.132.0.8 71.61 GiB 256 ? 8894a98b-8406-45de-99e2-f404ab10b5d6 c UN 10.132.9.204 75.1 GiB 256 ? afa0ffa3-630b-4f1e-b46f-fc3df988092e a UN 10.132.3.133 68.08 GiB 256 ? 25ae39ab-b39e-4d4f-9cb7-de095ab873db b
- 在新資料中心的所有 pod 上設定 Cassandra。
- 使用下列指令從叢集中取得
apigeeorg
:kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
例如:
Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name "rg-hybrid-b7d3b9c"
- 建立 Cassandra 資料複製自訂資源 (
YAML
) 檔案。檔案名稱不限。在以下範例中,檔案名稱為datareplication.yaml
。檔案必須包含下列內容:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: REGION_EXPANSION namespace: NAMESPACE spec: organizationRef: APIGEEORG_VALUE force: false source: region: SOURCE_REGION
其中:
- REGION_EXPANSION 是您要為此中繼資料指定的名稱。您可以使用任何名稱。
- NAMESPACE 與
overrides.yaml
提供的命名空間相同。通常是「apigee
」。 - APIGEEORG_VALUE 是上一個步驟中
kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
指令的輸出值。例如:rg-hybrid-b7d3b9c
- SOURCE_REGION 是來源地區中的資料中心名稱。這是
overrides.yaml
中為cassandra:datacenter:
設定的值。
例如:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: rg-hybrid-b7d3b9c force: false source: region: "dc-1"
- 使用下列指令套用
CassandraDataReplication
:kubectl apply -f datareplication.yaml
- 使用下列指令確認重建狀態。
kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication
結果應如下所示:
{ "rebuildDetails": { "apigee-cassandra-default-0": { "state": "complete", "updated": 1623105760 }, "apigee-cassandra-default-1": { "state": "complete", "updated": 1623105765 }, "apigee-cassandra-default-2": { "state": "complete", "updated": 1623105770 } }, "state": "complete", "updated": 1623105770 }
- 使用下列指令從叢集中取得
- 請透過記錄檔確認重建程序。此外,請使用
nodetool status
指令驗證資料大小:kubectl logs apigee-cassandra-default-0 -f -n apigee
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status
以下範例顯示記錄項目:
INFO 01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens) INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild INFO 01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB) INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36 INFO 01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22 INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB) INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete INFO 01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed
- 更新種子主機。從
overrides-DC_name.yaml
中移除multiRegionSeedHost: 10.0.0.11
,然後重新套用。apigeectl apply -f overrides/overrides-DC_name.yaml
檢查 Cassandra 叢集狀態
下列指令可用於查看叢集設定是否在兩個資料中心中成功。這個指令會檢查兩個區域的 nodetool 狀態。
kubectl exec apigee-cassandra-default-0 -n apigee -- nodetool -u JMX_user -pw JMX_password status Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.12.1.45 112.09 KiB 256 100.0% 3c98c816-3f4d-48f0-9717-03d0c998637f ra-1 UN 10.12.4.36 95.27 KiB 256 100.0% 0a36383d-1d9e-41e2-924c-7b62be12d6cc ra-1 UN 10.12.5.22 88.7 KiB 256 100.0% 3561f4fa-af3d-4ea4-93b2-79ac7e938201 ra-1 Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.0.4.33 78.69 KiB 256 0.0% a200217d-260b-45cd-b83c-182b27ff4c99 ra-1 UN 10.0.0.21 78.68 KiB 256 0.0% 9f3364b9-a7a1-409c-9356-b7d1d312e52b ra-1 UN 10.0.1.26 15.46 KiB 256 0.0% 1666df0f-702e-4c5b-8b6e-086d0f2e47fa ra-1
疑難排解
請參閱「Cassandra 資料複製作業失敗」。