本頁面由 Cloud Translation API 翻譯而成。

將 Apigee Hybrid 升級至 1.12 版

本程序涵蓋從 Apigee Hybrid 1.11.x 升級至 Apigee Hybrid 1.12.4，以及從 Hybrid 1.12.x 先前版本升級至 1.12.4 的程序。

針對次要版本升級 (例如從 1.11 升級至 1.12) 和修補程式版本升級 (例如從 1.12.0 升級至 1.12.4)，請使用相同的程序。

如果您要從 Apigee Hybrid 1.10 以下版本升級，必須先升級至 Hybrid 1.11 版本，再升級至 1.12.4 版本。請參閱升級 Apigee Hybrid 至 1.11 版的操作說明。

Apigee Hybrid 1.11 的變更

Apigee Hybrid 1.12 版本引進了以下會影響升級程序的變更。如需 1.12 版的完整功能清單，請參閱混合型 1.12.0 版本資訊。

Cassandra 4.x：從 1.12 版起，Apigee hybrid 會使用 Cassandra 4 以上版本。
重要事項：由於資料庫已變更，您無法回復已升級的 apigee-datastore 元件。因此，請務必在升級前備份 Cassandra 資料庫和混合式安裝作業。如果您需要復原升級，請考慮下列情境：
- Cassandra 尚未升級：您可以還原所有變更。
- Cassandra 已升級，且所有 Cassandra pod 都正常運作：您可以還原 apigee-datastore 以外的所有元件變更。您的 v1.11.x 安裝作業將繼續搭配執行 Cassandra v4 的 apigee-datastore v1.12 執行個體運作。
- Cassandra 已升級，且 Cassandra 容器處於不健康狀態：您必須解除安裝混合型 v1.12，並從備份還原 v.11 安裝。
apigeectl 淘汰：從 1.12 版起，Apigee Hybrid 僅支援 Helm，用於安裝及管理混合式安裝作業。
注意：apigeectl 已於 2024 年 4 月 17 日淘汰。Apigee hybrid v1.12 不支援 apigeectl 工具。我們將於 2025 年 4 月 17 日停止支援 Apigee hybrid v1.10 和 v1.11 的 apigeectl。詳情請參閱apigeectl 淘汰公告。
重要事項：如果您使用 apigeectl 管理 v1.11，則必須先將 v1.11 安裝作業遷移至使用 Helm，才能升級至 1.12 版。請按照從 apigeectl 將 Apigee hybrid 遷移至 Helm 圖表中的操作說明進行。
我們推出一套新的指標，可用於監控 Apigee 代理程式和目標端點。對於混合型 v1.12，ProxyV2 和 TargetV2 監控資源將不再預設使用。所有 Proxy 和 Target 指標都會發布至 Proxy 和 Target 受控資源。

如要繼續將指標傳送至 ProxyV2 和 TargetV2 受控資源，請在 overrides.yaml 中將 metrics.disablePrometheusPipeline 設為 true。
如果您已設定指標警示，請確認混合式安裝程序使用正確的指標。詳情請參閱「以指標為基礎的警報」。
更嚴格的類別例項化檢查：從 1.12.4 版開始，Apigee hybrid 的 JavaCallout 政策現在在 Java 類別例項化期間提供額外安全性。這項進階安全防護措施可防止部署的政策直接或間接嘗試需要不允許權限的動作。
在大多數情況下，現有政策會繼續正常運作，不會有任何問題。不過，依賴第三方程式庫的政策，或是含有會間接觸發需要提升權限的作業的自訂程式碼，都有可能受到影響。

重要事項：如要測試安裝作業，請按照「升級至 1.12.4 後驗證政策」中的程序驗證政策行為。

開始升級至 1.12 版前應考量的問題

Cassandra 注意事項

從 Apigee hybrid 1.11 升級至 1.12 版本時，Cassandra 資料庫也會從 3.11.x 升級至 4.x。雖然 Cassandra 升級作業會在 Apigee 混合升級程序中處理，但請考量下列事項：

Cassandra 版本升級作業會在背景執行，且每次只會在 1 個 Pod (或 Cassandra 節點) 上進行，因此請在升級期間減少資料庫容量。
請先調整 Cassandra 容量，並確保磁碟使用率接近或低於 50%，再開始升級。
驗證並測試 Cassandra 備份和還原程序。
請先備份混合式 1.11 版安裝程序中的 Cassandra 資料，再開始升級並驗證備份。
由於 Cassandra 會執行升級後的工作，因此升級 apigee-datastore 會導致 CPU 用量暫時增加
升級 apigee-datastore (Cassandra) 元件後，您就無法將該元件回溯至先前的版本。升級 apigee-datastore 元件後，如果要將升級作業回溯至混合型 1.12 版，有兩種情況：
- 如果 apigee-datastore 元件處於良好狀態，但其他元件需要回溯，您可以個別回溯這些元件。
  注意：在執行不同混合版本的元件時，您無法新增區域或調整 Cassandra 節點。
- 如果 apigee-datastore 元件處於不良狀態，您必須從 v1.11 備份還原至 v1.11 安裝。
  注意：您無法在還原時混用版本。您必須將在 v1.11 安裝作業中取得的備份還原至 v1.11 安裝作業。

升級單一地區安裝作業前的注意事項

如果您需要回復至舊版 Apigee hybrid，可能需要停機。因此，如果您要升級單一區域的作業，建議您建立第二個區域，然後按照下列順序一次升級一個區域：

使用相同的混合型版本，在現有安裝項目中新增第二個區域。請參閱第 1.11 版說明文件中的「多地區部署」一節。
開始升級前，請先備份並驗證第一個區域的資料。請參閱 1.11 版說明文件中的「Cassandra 備份總覽」。
將新加入的區域升級至 Hybrid 1.12。
將流量切換至新區域，並驗證流量。
驗證完成後，請使用混合型 1.12 升級舊版區域。
將所有流量切換回舊區域，並驗證流量。
停用新區域。

升級多地區安裝作業前的注意事項

Apigee 建議您按照以下順序升級多區域安裝：

開始升級前，請先備份並驗證各個區域的資料。
請在一個區域中升級 Hybrid 版本，並確認所有 Pod 皆處於執行狀態，以便驗證升級作業。
驗證新升級區域的流量。
請在驗證先前區域的流量後，再升級後續區域。
如果需要在多區域部署中回溯升級，請準備將流量從失敗的區域切換，並考慮在將流量轉移的區域中增加足夠的容量，以便處理這兩個區域的流量。

必要條件

升級至混合型 1.12 版前，請確認安裝環境符合下列需求：

使用 Helm 管理的 Apigee Hybrid 1.11 版本安裝作業。
- 如果您使用 apigeectl 管理混合型安裝作業，則必須先將叢集遷移至 Helm 管理。請參閱 hybrid 1.11 版說明文件中的「從 apigeectl 將 Apigee Hybrid 遷移至 Helm」。
- 如果混合式安裝作業執行的版本低於 v1.11，則必須先升級至 1.11 版，再升級至 1.12 版。請參閱「將 Apigee Hybrid 升級至 1.11 版」一文。
Helm 版本 3.14.2 以上版本。
kubectl 1.27、1.28 或 1.29 版 (建議)。
cert-manager 1.13.0 版。如有需要，您可以在下方的「準備升級至版本」部分升級 cert-manager。

限制

規劃從 Apigee hybrid 1.11 升級至 1.12 時，請注意下列限制。如需在升級後復原或回復，事先做好規劃，就能減少停機時間。

由於兩個版本不相容，因此無法在 Hybrid 1.12 中還原 Hybrid 1.11 的備份，反之亦然。
升級至 1.12 版期間，您無法調整資料儲存庫 Pod。請先解決所有區域的縮放需求，再開始升級混合式安裝作業。
在單一區域的混合式安裝作業中，一旦 Datastore 升級程序完成，就無法回溯 Datastore 元件。您無法將 Cassandra 4.x 資料儲存庫回溯至 Cassandra 3.x 資料儲存庫。這項作業需要從 Cassandra 3.x 資料的最新備份 (從混合雲版本 1.11 安裝) 還原資料。
升級期間不支援刪除或新增區域。在多區域升級作業中，您必須先完成所有區域的升級作業，才能新增或刪除區域。

升級至 1.12.4 版總覽

升級至 Apigee Hybrid 1.12 版可能需要停機。

將 Apigee 控制器升級至 1.12.4 版時，所有 Apigee 部署作業都會進行逐步重新啟動。為了在滾動重新啟動期間，盡可能減少實際混合環境的停機時間，請務必至少執行兩個叢集 (位於相同或不同區域/資料中心)。將所有實際工作流量轉移至單一叢集，並將要升級的叢集離線，然後繼續升級程序。針對每個叢集重複執行上述程序。

Apigee 建議您盡快升級所有叢集，以降低對實際作業造成影響的可能性。在第一個叢集升級後，您可以自行決定何時升級所有剩餘叢集，沒有時間限制。不過，在所有剩餘叢集升級完成前，下列作業會受到影響：

Cassandra 備份和還原功能無法搭配混合版本運作。舉例來說，Hybrid 1.11 的備份無法用於還原 Hybrid 1.12 執行個體。
混合型 Hybrid 版本之間無法使用 Cassandra 資料串流功能。因此，您的 Cassandra 叢集無法進行水平調整。
區域擴充和停用作業會受到影響，因為這些作業取決於 Cassandra 資料串流。

升級 Apigee Hybrid 的程序分為以下幾個部分：

準備升級。
- 備份 Cassandra。
- 備份混合式安裝目錄。
安裝 Hybrid 執行階段 1.12.4 版。

準備升級至 1.12 版

備份 cassandra

請先備份所有適用區域中的 Cassandra 資料庫，並驗證混合型 1.11 版本安裝中的資料，再開始升級。請參閱第 1.11 版說明文件中的「監控備份」一節。

請先重新啟動叢集中的所有 Cassandra pod，再開始升級程序，以便找出任何未解決的問題。

如要重新啟動及測試 Cassandra 容器，請個別刪除每個容器，每次刪除一個，然後驗證該容器是否會恢復到執行狀態，且就緒探針是否通過測試：

列出 Cassandra Pod：

kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-cassandra

例如：

kubectl get pods -n apigee -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

. . .

刪除 pod：

kubectl delete pod -n APIGEE_NAMESPACE CASSANDRA_POD_NAME

例如：

kubectl delete pod -n apigee apigee-cassandra-default-0

再次列出 cassandra pod 來檢查狀態：

kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-cassandra

例如：

kubectl get pods -n apigee -l app=apigee-cassandra
NAME                         READY   STATUS    RESTARTS   AGE
apigee-cassandra-default-0   1/1     Running   0          16s
apigee-cassandra-default-1   1/1     Running   0          2h
apigee-cassandra-default-2   1/1     Running   0          2h

. . .

再次套用上次已知的覆寫檔案，確保該檔案未經任何變更，以便您使用相同的設定升級至混合型 1.12 版。

請確認所有區域中的所有 Cassandra 節點都處於 UN (正常運作 / 正常) 狀態。如果任何 Cassandra 節點處於不同的狀態，請先解決問題，再開始升級。

您可以使用下列指令驗證 Cassandra 節點的狀態：

列出 Cassandra Pod：

kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-cassandra

例如：

kubectl get pods -n apigee -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 nodetool status 指令，檢查每個 Cassandra pod 的節點狀態：

kubectl -n APIGEE_NAMESPACE exec -it CASSANDRA_POD_NAME -- nodetool status

例如：

kubectl -n apigee 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
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

備份混合式安裝目錄

這些操作說明會使用環境變數 APIGEE_HELM_CHARTS_HOME，用於您已安裝 Helm 圖表的檔案系統目錄。如有需要，請變更目錄至此目錄，然後使用下列指令定義變數：
Linux
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
Mac OS
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
Windows
```
set APIGEE_HELM_CHARTS_HOME=%CD%
echo %APIGEE_HELM_CHARTS_HOME%
```
請備份 1.11 版 $APIGEE_HELM_CHARTS_HOME/ 目錄。您可以使用任何備份程序。舉例來說，您可以使用以下指令建立整個目錄的 tar 檔案：
```
tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.11-backup.tar.gz $APIGEE_HELM_CHARTS_HOME
```
按照「Cassandra 備份和復原」一文中的操作說明，備份 Cassandra 資料庫。

如果您在覆寫值中使用服務憑證檔案 (.json) 來驗證服務帳戶，請確認服務帳戶憑證檔案位於正確的 Helm 圖表目錄中。Helm 圖表無法讀取各個圖表目錄以外的檔案。

如果您使用 Kubernetes 機密或 Workload Identity 驗證服務帳戶，則不需要執行這個步驟。

下表顯示各服務帳戶檔案的目的，取決於安裝類型：

正式發布階段

服務帳戶	預設檔案名稱	Helm 資訊套件目錄
`apigee-cassandra`	`PROJECT_ID-apigee-cassandra.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/`
`apigee-logger`	`PROJECT_ID-apigee-logger.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-mart`	`PROJECT_ID-apigee-mart.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-metrics`	`PROJECT_ID-apigee-metrics.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-runtime`	`PROJECT_ID-apigee-runtime.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env`
`apigee-synchronizer`	`PROJECT_ID-apigee-synchronizer.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env/`
`apigee-udca`	`PROJECT_ID-apigee-udca.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-watcher`	`PROJECT_ID-apigee-watcher.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`

非正式環境

在下列各個目錄中複製 apigee-non-prod 服務帳戶檔案：

服務帳戶	預設檔案名稱	Helm 資訊套件目錄
`apigee-non-prod`	`PROJECT_ID-apigee-non-prod.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/` `$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/` `$APIGEE_HELM_CHARTS_HOME/apigee-org/` `$APIGEE_HELM_CHARTS_HOME/apigee-env/`

請確認您的 TLS 憑證和金鑰檔案 (.crt、.key 和/或 .pem) 位於 $APIGEE_HELM_CHARTS_HOME/apigee-virtualhost/ 目錄中。

升級 Kubernetes 版本

請檢查您的 Kubernetes 平台版本，並視需要將 Kubernetes 平台升級至 hybrid 1.11 和 hybrid 1.12 都支援的版本。如需協助，請參閱平台的說明文件。

點選展開支援平台清單

	1.10 ⁽³⁾	1.11	1.12
Google Cloud上的 GKE	1.24.x 1.25.x 1.26.x 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.25.x 1.26.x 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	1.26.x 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
GKE on AWS	1.13.x (K8s v1.24.x) 1.14.x (K8s v1.25.x) 1.26.x⁽¹²⁾ 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.14.x (K8s v1.25.x) 1.26.x⁽¹²⁾ 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	1.26.x⁽¹²⁾ 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
GKE on Azure	1.13.x 1.14.x 1.26.x⁽¹²⁾ 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.14.x 1.26.x⁽¹²⁾ 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	1.26.x⁽¹²⁾ 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
VMware 上的 Google Distributed Cloud (僅限軟體) ⁽¹⁾ ⁽¹³⁾	1.13.x 1.14.x 1.15.x (K8s 1.26.x) 1.16.x (K8s 1.27.x) 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.14.x 1.15.x (K8s 1.26.x) 1.16.x (K8s 1.27.x) 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	1.15.x (K8s 1.26.x) 1.16.x (K8s 1.27.x) 1.28.x⁽¹²⁾ 1.29.x^{(1.12.1 以上)}
裸機上的 Google Distributed Cloud (僅限軟體) ⁽¹⁾	1.13.x 1.14.x (K8s 1.25.x) 1.15.x (K8s 1.26.x) 1.16.x (K8s 1.27.x) 1.27.x⁽¹²⁾^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.14.x 1.15.x (K8s 1.26.x) 1.16.x (K8s 1.27.x) 1.28.x⁽¹²⁾^{(1.11.2 以上)} 1.29.x^{(1.11.2 以上)}	1.15.x (K8s 1.26.x) 1.16.x (K8s 1.27.x) 1.28.x⁽¹²⁾ 1.29.x^{(1.12.1 以上)}
EKS⁽⁷⁾	1.24.x 1.25.x 1.26.x 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.25.x 1.26.x 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	1.26.x 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
AKS⁽⁷⁾	1.24.x 1.25.x 1.26.x 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	1.25.x 1.26.x 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	1.26.x 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
OpenShift⁽⁷⁾	4.11 4.12 4.14^{(≥ 1.10.5)} 4.15^{(≥ 1.10.5)}	4.12 4.13 4.14 4.15^{(≥ 1.11.2)} 4.16^{(≥ 1.11.2)}	4.12 4.13 4.14 4.15 4.16^{(≥ 1.12.1)}
Rancher Kubernetes Engine (RKE)	v1.26.2+rke2r1 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	v1.26.2+rke2r1 v1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	v1.26.2+rke2r1 v1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
VMware Tanzu	不適用	不適用	v1.26.x
元件	1.10	1.11	1.12
Cloud Service Mesh	1.17.x⁽¹⁰⁾	1.18.x⁽¹⁰⁾	1.19.x⁽¹⁰⁾
JDK	JDK 11	JDK 11	JDK 11
憑證管理員	1.10.x 1.11.x 1.12.x	1.11.x 1.12.x 1.13.x	1.11.x 1.12.x 1.13.x
Cassandra	3.11	3.11	4.0
Kubernetes	1.24.x 1.25.x 1.26.x	1.25.x 1.26.x 1.27.x	1.26.x 1.27.x 1.28.x
kubectl			1.27.x 1.28.x 1.29.x
Helm	3.10 以上	3.10 以上	3.14.2+
Secret Store CSI 驅動程式		1.3.4	1.4.1
保管箱		1.13.x	1.15.2
⁽¹⁾ 在 Anthos 地端 (Google Distributed Cloud) 1.13 版上，請按照以下操作說明避免與 `cert-manager` 發生衝突：衝突的 cert-manager 安裝程序 ⁽²⁾ Apigee Hybrid 1.7.2 以上版本提供支援。 ⁽³⁾ Apigee Hybrid 1.10 以下版本的正式淘汰日期已到期。我們已停止提供每月定期發布的修補程式。這些版本不再獲得官方支援，但如果客戶有明確且官方例外的支援需求，則不在此限。其他客戶必須升級。 ⁽⁴⁾Anthos 內部部署 (Google Distributed Cloud) 1.12 以下版本已停止支援。請參閱裸機版 Distributed Cloud 的版本支援政策，以及 VMware 版 Distributed Cloud 的支援版本清單。 ⁽⁵⁾ 在裸機或 VMware 上執行 Google Distributed Cloud 需要使用 Cloud Service Mesh 1.14 以上版本。建議您升級至混合型 v1.8，並改用 Apigee 入口網關，因為您不再需要在混合型叢集上安裝 Cloud Service Mesh。 ⁽⁶⁾ Apigee hybrid 1.8.4 以上版本支援。 ⁽⁷⁾ Apigee Hybrid 1.8.4 以上版本不支援。 ⁽⁸⁾ Apigee Hybrid 支援 1.7.6 以上版本。 ⁽⁹⁾ 不支援 Apigee Hybrid 1.8.5 以上版本。 ⁽¹⁰⁾ Cloud Service Mesh 會在 Apigee hybrid 1.9 以上版本自動安裝。 ⁽¹¹⁾ Apigee hybrid 支援 1.9.2 以上版本。 ⁽¹²⁾ AWS 上的 GKE 版本號碼現在會反映 Kubernetes 版本。如需版本詳細資料和建議修補程式，請參閱 GKE Enterprise 版本和升級支援。 ⁽¹³⁾ Vault 未通過 Google Distributed Cloud for VMware 認證。 ⁽¹⁴⁾ Apigee Hybrid 1.10.5 以上版本提供支援。 ⁽¹⁵⁾ Apigee hybrid 1.11.2 以上版本提供支援。 ⁽¹⁶⁾ Apigee hybrid 1.12.1 以上版本支援。

關於附加叢集

如果您想在 Elastic Kubernetes Service (EKS)、Azure Kubernetes Service (AKS) 或其他支援的第三方 Kubernetes 服務供應器上，在多雲端環境中執行 Apigee hybrid，則必須使用 GKE 已連結叢集 (適用於 Apigee hybrid 1.7.x 及更舊版本)。叢集附件可讓 Google 評估 Cloud Service Mesh 的用量。

對於 Apigee 混合式 1.8.x 版本，如果您要使用 Cloud Service Mesh 做為入口網關，則必須使用 GKE 附加叢集。如果您使用的是 Apigee Ingress 閘道，則附加叢集為選用項目。

安裝 Hybrid 1.12.4 執行階段

準備升級 Helm 資訊套件

拉取 Apigee Helm 資訊套件。

Apigee Hybrid 圖表會託管在 Google Artifact Registry 中：

oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts

使用 pull 指令，並使用下列指令將所有 Apigee 混合 Helm 圖表複製到本機儲存空間：

export CHART_REPO=oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts
export CHART_VERSION=1.12.4
helm pull $CHART_REPO/apigee-operator --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-datastore --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-env --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-ingress-manager --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-org --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-redis --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-telemetry --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-virtualhost --version $CHART_VERSION --untar

視需要升級 cert-manager。
如果您需要升級 cert-manager 版本，請使用下列指令安裝新版本：
```
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.13.0/cert-manager.yaml
```

安裝更新版的 Apigee CRD：

注意：這是安裝 Apigee CRD 唯一支援的方法。請勿在沒有 -k 的情況下使用 kubectl apply，也不要省略 --server-side。

執行下列指令，使用 kubectl 模擬測試功能：

kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false --dry-run

使用模擬執行指令驗證後，請執行下列指令：

kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false

使用 kubectl get crds 指令驗證安裝作業：

kubectl get crds | grep apigee

輸出內容應如下所示：

apigeedatastores.apigee.cloud.google.com                    2023-10-09T14:48:30Z
apigeedeployments.apigee.cloud.google.com                   2023-10-09T14:48:30Z
apigeeenvironments.apigee.cloud.google.com                  2023-10-09T14:48:31Z
apigeeissues.apigee.cloud.google.com                        2023-10-09T14:48:31Z
apigeeorganizations.apigee.cloud.google.com                 2023-10-09T14:48:32Z
apigeeredis.apigee.cloud.google.com                         2023-10-09T14:48:33Z
apigeerouteconfigs.apigee.cloud.google.com                  2023-10-09T14:48:33Z
apigeeroutes.apigee.cloud.google.com                        2023-10-09T14:48:33Z
apigeetelemetries.apigee.cloud.google.com                   2023-10-09T14:48:34Z
cassandradatareplications.apigee.cloud.google.com           2023-10-09T14:48:35Z

檢查叢集節點上的標籤。根據預設，Apigee 會在標記為 cloud.google.com/gke-nodepool=apigee-data 的節點上排定資料 Pod，並在標記為 cloud.google.com/gke-nodepool=apigee-runtime 的節點上排定執行階段 Pod。您可以在 overrides.yaml 檔案中自訂節點叢集標籤。

詳情請參閱「設定專屬節點叢集」。

安裝 Apigee Hybrid Helm 資訊套件

注意：在執行任何 Helm 升級/安裝指令之前，請使用 Helm 模擬功能，方法是在指令結尾加上 --dry-run。請參閱 helm -h，查看支援的指令、選項和用法。

如果尚未建立，請前往 APIGEE_HELM_CHARTS_HOME 目錄。在該目錄中執行下列指令。

升級 Apigee Operator/Controller：

注意：這個步驟需要提升叢集權限。如需詳細資訊，請執行 helm -h 或 helm upgrade -h。

模擬測試：

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  -f OVERRIDES_FILE \
  --dry-run

升級圖表：

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --force \
  -f OVERRIDES_FILE

確認 Apigee Operator 安裝作業：

helm ls -n apigee-system

NAME       NAMESPACE       REVISION   UPDATED                                STATUS     CHART                   APP VERSION
operator   apigee-system   3          2023-06-26 00:42:44.492009 -0800 PST   deployed   apigee-operator-1.12.4   1.12.4

確認可用性，確認該服務是否已啟用：

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

升級 Apigee 資料儲存庫：

模擬測試：

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run

升級圖表：

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --force \
  -f OVERRIDES_FILE

檢查 apigeedatastore 的狀態，確認其已啟用並執行：

kubectl -n apigee get apigeedatastore default

NAME      STATE       AGE
default   running    2d

升級 Apigee 遙測：

模擬測試：

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run

升級圖表：

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --force \
  -f OVERRIDES_FILE

查看狀態，確認服務已啟用及執行：

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

升級 Apigee Redis：

模擬測試：

helm upgrade redis apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run

升級圖表：

helm upgrade redis apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade redis apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --force \
  -f OVERRIDES_FILE

查看狀態，確認服務已啟用及執行：

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

升級 Apigee 入口管理工具：

模擬測試：

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run

升級圖表：

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --force \
  -f OVERRIDES_FILE

確認可用性，確認該服務是否已啟用：

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

升級 Apigee 機構：

模擬測試：

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run

升級圖表：

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --force \
  -f OVERRIDES_FILE

檢查相關機構的狀態，確認該機構是否已啟用及運作：

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

升級環境。

您一次只能安裝一個環境。使用 --set env=ENV_NAME 指定環境：

模擬測試：

helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run

ENV_RELEASE_NAME 是先前用來安裝 apigee-env 圖表的名稱。在 hybrid v1.10 中，通常是 apigee-env-ENV_NAME。在 Hybrid 1.11 以上版本中，通常是 ENV_NAME。
ENV_NAME 是您要升級的環境名稱。
OVERRIDES_FILE 是 v.1.12.4 的新覆寫檔案

升級圖表：

helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE

注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：

helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  --force \
  -f OVERRIDES_FILE

檢查相應環境的狀態，確認環境已啟用並執行：

kubectl -n apigee get apigeeenv

NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d

升級環境群組 (virtualhosts)。
1. 您必須一次升級一個環境群組 (虛擬主機)。使用 --set envgroup=ENV_GROUP_NAME 指定環境群組。針對 overrides.yaml 檔案中提及的每個 env 群組重複下列指令：
  模擬測試：
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE \
  --dry-run
```
  ENV_GROUP_RELEASE_NAME 是先前用來安裝 apigee-virtualhost 圖表的名稱。在 hybrid v1.10 中，通常是 apigee-virtualhost-ENV_GROUP_NAME。在 Hybrid 1.11 以上版本中，通常是 ENV_GROUP_NAME。
  
  升級圖表：
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE
```
  注意：如果是從 apigeectl 遷移至 Helm 的裝置，請使用：
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set envgroup=ENV_GROUP_NAME \
  --force \
  -f OVERRIDES_FILE
```
  注意： ENV_GROUP_RELEASE_NAME 在 apigee 命名空間中不得重複。
  舉例來說，如果您有一個名為 prod 的環境和一個名為 prod 的環境群組，請將 ENV_GROUP_RELEASE_NAME 的值設為不重複的值，例如 prod-envgroup。
2. 檢查 ApigeeRoute (AR) 的狀態。
  安裝 virtualhosts 會建立 ApigeeRouteConfig (ARC)，而 ApigeeRoute (AR) 會在 Apigee 監控器從控制平面擷取環境群組相關詳細資料後，在內部建立。因此，請檢查對應的 AR 狀態是否正在執行：
```
kubectl -n apigee get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n apigee get ar
```
```
NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d
```

升級至 1.12.4 後驗證政策

請按照這個程序，在從 1.12.3 或更早版本升級至 1.12.4 以上版本後，驗證 JavaCallout 政策的行為。

檢查 Java JAR 檔案是否要求不必要的權限。
政策部署完成後，請查看執行階段記錄，看看是否有下列記錄訊息："Failed to load and initialize class ..."。如果您看到這則訊息，表示已部署的 JAR 要求了不必要的權限。如要解決這個問題，請調查 Java 程式碼並更新 JAR 檔案。
調查並更新 Java 程式碼。
請查看任何 Java 程式碼 (包括依附元件)，找出可能不允許的作業原因。找到後，請視需要修改原始碼。
啟用安全性檢查功能來測試政策。
在非正式版環境中，啟用安全性檢查標記，並使用更新版 JAR 重新部署政策。如要設定標記，請按照下列步驟操作：
- 在 apigee-env/values.yaml 檔案中，將 conf_security-secure.constructor.only 設為 runtime:cwcAppend: 下方的 true。例如：
```
# Apigee Runtime
runtime:
  cwcAppend:
    conf_security-secure.constructor.only: true
```
- 更新環境的 apigee-env 圖表以套用變更。例如：
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
```
如果記錄訊息 "Failed to load and initialize class ..." 仍存在，請繼續修改及測試 JAR 檔案，直到記錄訊息不再顯示為止。
在實際環境中啟用安全性檢查。
在非正式環境中徹底測試並驗證 JAR 檔案後，請將標記 conf_security-secure.constructor.only 設為 true，並更新正式環境的 apigee-env 圖表，以便套用變更，在正式環境中啟用安全性檢查。

復原至先前版本

這一節會根據升級至 Apigee Hybrid 1.12 後的 apigee-datastore 元件狀態，分成幾個部分。當 apigee-datastore 處於良好狀態時，您可以使用單一區域或多區域回溯程序，並在 apigee-datastore 處於不良狀態時，使用還原或備份程序。

單一區域的回溯和復原作業

在 `apigee-datastore` 處於良好狀態時回復

本程序說明如何將所有 Apigee Hybrid 元件 (apigee-datastore 除外) 從 v1.12 回溯至 v1.11。1.12 版 apigee-datastore 元件與混合式 1.11 版元件回溯相容。

警告：無法復原 apigee-datastore。不同版本的 Cassandra 資料庫之間的資料不相容，因此無法回復至先前版本。

如要將單一區域安裝作業回溯至 1.11 版，請按照下列步驟操作：

開始復原前，請驗證所有 Pod 是否處於執行狀態：

kubectl get pods -n APIGEE_NAMESPACE

kubectl get pods -n apigee-system

使用 Helm 驗證元件的發布：

helm -n APIGEE_NAMESPACE list

helm -n apigee-system list

例如

helm -n apigee list
NAME              NAMESPACE   REVISION   UPDATED                                   STATUS     CHART                           APP VERSION
datastore         apigee      2          2024-03-29 17:08:07.917848253 +0000 UTC   deployed   apigee-datastore-1.12.0         1.12.0
ingress-manager   apigee      2          2024-03-29 17:21:02.917333616 +0000 UTC   deployed   apigee-ingress-manager-1.12.0   1.12.0
redis             apigee      2          2024-03-29 17:19:51.143728084 +0000 UTC   deployed   apigee-redis-1.12.0             1.12.0
telemetry         apigee      2          2024-03-29 17:16:09.883885403 +0000 UTC   deployed   apigee-telemetry-1.12.0         1.12.0
myhybridorg       apigee      2          2024-03-29 17:21:50.899855344 +0000 UTC   deployed   apigee-org-1.12.0               1.12.0

使用下列指令，回復每個元件 (apigee-datastore 除外)：

建立下列環境變數：
- PREVIOUS_HELM_CHARTS_HOME：安裝先前 Apigee hybrid Helm 資訊套件的目錄。這是您要復原的版本。
回復虛擬主機。針對覆寫檔案中提到的每個環境群組重複執行下列指令。
```
helm upgrade ENV_GROUP_RELEASE_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-virtualhost/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
ENV_GROUP_RELEASE_NAME 是先前用來安裝 apigee-virtualhost 圖表的名稱。在 hybrid v1.10 中，通常是 apigee-virtualhost-ENV_GROUP_NAME。在 Hybrid 1.11 以上版本中，通常是 ENV_GROUP_NAME。
復原環境。針對覆寫檔案中提及的每個環境，重複執行下列指令。
```
helm upgrade apigee-env-ENV_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set env=ENV_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
ENV_RELEASE_NAME 是先前用來安裝 apigee-env 圖表的名稱。在 hybrid v1.10 中，通常是 apigee-env-ENV_NAME。在 Hybrid 1.11 以上版本中，通常是 ENV_NAME。

檢查相應環境的狀態，確認環境已啟用並執行：
```
kubectl -n apigee get apigeeenv
```
```
NAME                  STATE     AGE   GATEWAYTYPE
apigee-org1-dev-xxx   running   2d
```

復原機構：

helm upgrade ORG_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

檢查相關機構的狀態，確認該機構是否已啟用及運作：

kubectl -n apigee get apigeeorg

NAME                STATE     AGE
apigee-org1-xxxxx   running   2d

回溯 Ingress Manager：

helm upgrade ingress-manager $PREVIOUS_HELM_CHARTS_HOME/apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

確認可用性，確認該服務是否已啟用：

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

回溯 Redis：

helm upgrade redis $PREVIOUS_HELM_CHARTS_HOME/apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

查看狀態，確認服務已啟用及執行：

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

回復 Apigee 遙測：

helm upgrade telemetry $PREVIOUS_HELM_CHARTS_HOME/apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

查看狀態，確認服務已啟用及執行：

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

回復 Apigee Controller：

helm upgrade operator $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/ \
  --install \
  --namespace apigee-system \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

確認 Apigee Operator 安裝作業：

helm ls -n apigee-system

NAME       NAMESPACE       REVISION   UPDATED                                STATUS     CHART                   APP VERSION
operator   apigee-system   3          2023-06-26 00:42:44.492009 -0800 PST   deployed   apigee-operator-1.12.4   1.12.4

確認可用性，確認該服務是否已啟用：

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

回溯 Apigee Hybrid CRD：

kubectl apply -k  $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false

驗證所有 Pod 是否處於執行或已完成狀態：

kubectl get pods -n APIGEE_NAMESPACE

kubectl get pods -n apigee-system

驗證所有元件的發布作業。除了資料儲存庫以外，所有元件都應位於先前版本：

helm -n APIGEE_NAMESPACE list

helm -n apigee-system list

例如

helm -n apigee  list
NAME              NAMESPACE  REVISION  UPDATED                                  STATUS    CHART                          APP VERSION
datastore         apigee     2         2024-03-29 18:47:55.979671057 +0000 UTC  deployed  apigee-datastore-1.12.0        1.12.0
ingress-manager   apigee     3         2024-03-14 19:14:57.905700154 +0000 UTC  deployed  apigee-ingress-manager-1.11.0  1.11.0
redis             apigee     3         2024-03-14 19:15:49.406917944 +0000 UTC  deployed  apigee-redis-1.11.0            1.11.0
telemetry         apigee     3         2024-03-14 19:17:04.803421424 +0000 UTC  deployed  apigee-telemetry-1.11.0        1.11.0
myhybridorg       apigee     3         2024-03-14 19:13:17.807673713 +0000 UTC  deployed  apigee-org-1.11.0              1.11.0

在 `apigee-datastore` 處於不良狀態時還原

如果 apigee-datastore 元件升級失敗，您就無法將 apigee-datastore 從 1.12 版本回溯至 1.11 版本。您必須從 v1.11 安裝作業所建立的備份還原。請按照下列順序還原先前版本。

如果您沒有正在執行的 Apigee 混合式 1.11 版安裝 (例如在其他區域)，請使用已備份的圖表和覆寫檔案，建立新的 v1.11 版安裝。請參閱 Apigee Hybrid 1.11 版本安裝說明。
按照以下操作說明，從備份還原 v1.11 區域 (或新安裝)：
- Cloud Storage 介面 (CSI) 備份： Cassandra CSI 備份與還原。
- 非 CSI 備份： 在單一區域還原。
驗證已還原安裝項目的流量
選用：按照「解除安裝 Hybrid 執行階段」一文的操作說明，移除 1.12 版的安裝內容。

多區域回溯及復原

在 `apigee-datastore` 處於良好狀態時回復

本程序說明如何將所有 Apigee Hybrid 元件 (apigee-datastore 除外) 從 v1.12 回溯至 v1.11。1.12 版 apigee-datastore 元件與混合式 1.11 版元件回溯相容。

開始復原前，請驗證所有 Pod 是否處於執行狀態：

kubectl get pods -n APIGEE_NAMESPACE

kubectl get pods -n apigee-system

請確認所有區域中的所有 Cassandra 節點皆處於 UN (正常運作 / 正常) 狀態。如果任何 Cassandra 節點處於不同的狀態，請先解決問題，再開始升級程序。

您可以使用下列指令驗證 Cassandra 節點的狀態：

列出 Cassandra Pod：

kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-cassandra

例如：

kubectl get pods -n apigee -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 nodetool status 指令檢查每個 Cassandra pod 的節點狀態：

kubectl -n APIGEE_NAMESPACE exec -it CASSANDRA_POD_NAME -- nodetool -u JMX_USER -pw JMX_PASSWORD

例如：

kubectl -n apigee exec -it apigee-cassandra-default-0 -- nodetool -u jmxuser -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    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
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 Pod 都處於 UN 狀態，請按照「從 Cassandra 叢集中移除 DOWN 節點」一文中的指示操作。

前往安裝先前 Apigee Hybrid Helm 圖表的目錄

將內容變更為已升級的區域

kubectl config use-context UPGRADED_REGION_CONTEXT

驗證所有 Pod 是否處於執行狀態：

kubectl get pods -n APIGEE_NAMESPACE

kubectl get pods -n apigee-system

使用 helm 指令確認所有版本都已升級至 Hybrid 1.12 版：

helm -n APIGEE_NAMESPACE list

helm -n apigee-system list

例如

helm -n apigee list
NAME             NAMESPACE  REVISION  UPDATED                                  STATUS    CHART                          APP VERSION
datastore        apigee     2         2024-03-29 17:08:07.917848253 +0000 UTC  deployed  apigee-datastore-1.12.0        1.12.0
ingress-manager  apigee     2         2024-03-29 17:21:02.917333616 +0000 UTC  deployed  apigee-ingress-manager-1.12.0  1.12.0
redis            apigee     2         2024-03-29 17:19:51.143728084 +0000 UTC  deployed  apigee-redis-1.12.0            1.12.0
telemetry        apigee     2         2024-03-29 17:16:09.883885403 +0000 UTC  deployed  apigee-telemetry-1.12.0        1.12.0
myhybridorg      apigee     2         2024-03-29 17:21:50.899855344 +0000 UTC  deployed  apigee-org-1.12.0              1.12.0

使用下列指令，回復每個元件 (apigee-datastore 除外)：

建立下列環境變數：
- PREVIOUS_HELM_CHARTS_HOME：安裝先前 Apigee hybrid Helm 資訊套件的目錄。這是您要復原的版本。
回復虛擬主機。針對覆寫檔案中提到的每個環境群組重複執行下列指令。
```
helm upgrade ENV_GROUP_RELEASE_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-virtualhost/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
ENV_GROUP_RELEASE_NAME 是先前用來安裝 apigee-virtualhost 圖表的名稱。在 hybrid v1.10 中，通常是 apigee-virtualhost-ENV_GROUP_NAME。在 Hybrid 1.11 以上版本中，通常是 ENV_GROUP_NAME。
復原環境。針對覆寫檔案中提及的每個環境，重複執行下列指令。
```
helm upgrade apigee-env-ENV_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set env=ENV_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
ENV_RELEASE_NAME 是先前用來安裝 apigee-env 圖表的名稱。在 hybrid v1.10 中，通常是 apigee-env-ENV_NAME。在 Hybrid 1.11 以上版本中，通常是 ENV_NAME。

檢查各個環境的狀態，確認每個環境都已啟用並執行：
```
kubectl -n apigee get apigeeenv
```
```
NAME                  STATE     AGE   GATEWAYTYPE
apigee-org1-dev-xxx   running   2d
```

復原機構：

helm upgrade ORG_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

檢查相關機構的狀態，確認該機構是否已啟用及運作：

kubectl -n apigee get apigeeorg

NAME                STATE     AGE
apigee-org1-xxxxx   running   2d

回溯 Ingress Manager：

helm upgrade ingress-manager $PREVIOUS_HELM_CHARTS_HOME/apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

確認可用性，確認該服務是否已啟用：

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

回溯 Redis：

helm upgrade redis $PREVIOUS_HELM_CHARTS_HOME/apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

查看狀態，確認服務已啟用及執行：

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

回復 Apigee 遙測：

helm upgrade telemetry $PREVIOUS_HELM_CHARTS_HOME/apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

查看狀態，確認服務已啟用及執行：

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

回復 Apigee Controller：

helm upgrade operator $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/ \
  --install \
  --namespace apigee-system \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

確認 Apigee Operator 安裝作業：

helm ls -n apigee-system

NAME       NAMESPACE       REVISION   UPDATED                                STATUS     CHART                   APP VERSION
operator   apigee-system   3          2023-06-26 00:42:44.492009 -0800 PST   deployed   apigee-operator-1.12.4   1.12.4

確認可用性，確認該服務是否已啟用：

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

回溯 Apigee Hybrid CRD：

kubectl apply -k  $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false

驗證所有元件的發布作業。所有元件都應包含在先前版本中，但 datastore 除外：

helm -n APIGEE_NAMESPACE list

helm -n apigee-system list

例如

helm -n apigee  list
NAME              NAMESPACE  REVISION  UPDATED                                  STATUS    CHART                          APP VERSION
datastore         apigee     2         2024-03-29 18:47:55.979671057 +0000 UTC  deployed  apigee-datastore-1.12.0        1.12.0
ingress-manager   apigee     3         2024-03-14 19:14:57.905700154 +0000 UTC  deployed  apigee-ingress-manager-1.11.0  1.11.0
redis             apigee     3         2024-03-14 19:15:49.406917944 +0000 UTC  deployed  apigee-redis-1.11.0            1.11.0
telemetry         apigee     3         2024-03-14 19:17:04.803421424 +0000 UTC  deployed  apigee-telemetry-1.11.0        1.11.0
myhybridorg       apigee     3         2024-03-14 19:13:17.807673713 +0000 UTC  deployed  apigee-org-1.11.0              1.11.0

此時，除了 datastore 以外，所有版本都已復原至先前版本。

將多區域安裝作業還原至先前版本

在多區域升級中，如果升級失敗，請從多區域安裝中移除對該區域的參照，以便復原該區域。只有在 Hybrid 1.11 上至少有 1 個實況區域時，才能使用這種方法。v1.12 資料儲存庫與 v1.11 元件相容。

如要從正常運作的區域復原失敗的區域，請執行下列步驟：

將 API 流量從受影響的區域重新導向至正常運作的區域。並據此規劃容量，以支援從故障區域轉移的流量。
停用受影響的區域。針對每個受影響的區域，請按照「停用混合型區域」一節所述的步驟操作。請等待停用作業完成，再進行下一個步驟。
按照「從失敗的升級作業中復原區域」中的操作說明，清理失敗的區域。
復原受影響的區域。如要復原，請建立新的區域，如「GKE、GKE On-Prem 和 AKS 的多區域部署」一文所述。

從備份還原多區域安裝作業，其中 `apigee-datastore` 處於不良狀態

如果 apigee-datastore 元件的升級作業失敗，您就無法從 1.12 版本回溯至 1.11 版本。您必須從 v1.11 安裝作業所建立的備份還原。請按照下列順序還原先前版本。

如果您沒有正在執行的 Apigee 混合式 1.11 版安裝 (例如在其他區域)，請使用已備份的圖表和覆寫檔案，建立新的 v1.11 版安裝。請參閱 Apigee Hybrid 1.11 版本安裝說明。
按照以下操作說明，從備份還原 v1.11 區域 (或新安裝)：
- Cloud Storage 介面 (CSI) 備份： Cassandra CSI 備份與還原。
- 非 CSI 備份： 在多個區域中還原。
驗證已還原安裝項目的流量
如果是多區域安裝作業，請重建並還原下一個區域。請參閱「在多個區域中還原備份」一文中的操作說明。
按照「解除安裝 Hybrid 執行階段」一文的操作說明，移除 1.12 版的安裝作業。

附錄：從失敗的升級作業中復原區域

如果從 1.11 升級至 1.12 失敗，請移除資料中心。

驗證實際運作區域的 Cassandra 叢集狀態：

將 kubectl 背景資訊切換至要移除的區域：
```
kubectl config use-context CONTEXT_OF_LIVE_REGION
```

列出 Cassandra Pod：

kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-cassandra

例如：

kubectl get pods -n apigee -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

執行其中一個 Cassandra Pod：

kubectl exec -it -n CASSANDRA_POD_NAME -- /bin/bash

檢查 Cassandra 叢集的狀態：

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.48.12.16  813.84 KiB  256          100.0%            a6340ad9-37ba-4ec8-a8c2-f7b7ac931807  ra-1
UN  10.48.14.16  859.89 KiB  256          100.0%            39f03c51-e387-4dac-8360-6d8732e690a7  ra-1
UN  10.48.0.18   888.95 KiB  256          100.0%            0d57df49-52e4-4c01-832d-d9df845ab732  ra-1

描述叢集，確認您只會看到來自線上區域的 Cassandra Pod IP，且所有 Pod 都使用相同的結構定義版本：

nodetool -u JMX_USER -pw JMX_PASSWORD describecluster

輸出內容應如下所示：

nodetool -u JMX_USER -pw JMX_PASSWORD describecluster

Schema versions:
    4bebf2de-0582-31b4-9c5f-e36f60127e1b: [10.48.14.16, 10.48.12.16, 10.48.0.18]

清理 Cassandra 鍵值空間複本：

取得 user-setup 工作並刪除。系統會立即建立新的 user-setup 工作。

kubectl get jobs -n APIGEE_NAMESPACE

例如：

kubectl get jobs -n apigee
  NAME                                                           COMPLETIONS   DURATION   AGE
  apigee-cassandra-schema-setup-myhybridorg-8b3e61d          1/1           6m35s      3h5m
  apigee-cassandra-schema-val-myhybridorg-8b3e61d-28499150   1/1           10s        9m22s
 apigee-cassandra-user-setup-myhybridorg-8b3e61d            0/1           21s        21s

kubectl delete jobs USER_SETUP_JOB_NAME -n APIGEE_NAMESPACE

輸出結果應顯示新工作開始的訊息：

kubectl delete jobs apigee-cassandra-user-setup-myhybridorg-8b3e61d -n apigee

  apigee-cassandra-user-setup-myhybridorg-8b3e61d-wl92b         0/1     Init:0/1    0               1s

按照「建立用戶端容器」一節中的操作說明，建立用戶端容器，驗證 Cassandra 鍵值空間複製設定。

取得所有鍵值空間。執行 cassandra-client pod，然後啟動 cqlsh 用戶端：

kubectl exec -it -n APIGEE_NAMESPACE cassandra-client -- /bin/bash

請使用 ddl user 連線至 Cassandra 伺服器，因為該帳戶具備執行下列指令所需的權限：

cqlsh apigee-cassandra-default.apigee.svc.cluster.local -u DDL_USER -p DDL_PASSWORD --ssl

取得鍵值空間：

select * from system_schema.keyspaces;

輸出內容應如下所示，其中 dc-1 為即時 DC：

select * from system_schema.keyspaces;

 keyspace_name            | durable_writes | replication
--------------------------+----------------+--------------------------------------------------------------------------------
   kvm_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
              system_auth |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
            system_schema |           True |                        {'class': 'org.apache.cassandra.locator.LocalStrategy'}
 quota_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
 cache_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
   rtc_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
       system_distributed |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
                   system |           True |                        {'class': 'org.apache.cassandra.locator.LocalStrategy'}
                   perses |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
            system_traces |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
   kms_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}

(11 rows)

如果 user-setup 工作因故持續發生錯誤，且驗證失敗，請使用下列指令修正鍵值空間中的複寫作業。

kubectl exec -it -n APIGEE_NAMESPACE cassandra-client -- /bin/bash

請使用 ddl user 連線至 Cassandra 伺服器，因為該帳戶具備執行下列指令所需的權限：

cqlsh apigee-cassandra-default.apigee.svc.cluster.local -u DDL_USER -p DDL_PASSWORD --ssl

取得鍵值空間：

select * from system_schema.keyspaces;

請使用上述指令中的鍵值空間名稱，並在以下範例中進行替換

alter keyspace quota_myhybridorg_hybrid WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace kms_myhybridorg_hybrid WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace kvm_myhybridorg_hybrid WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace cache_myhybridorg_hybrid WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace perses_myhybridorg_hybrid WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace rtc_myhybridorg_hybrid WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace system_distributed WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};
alter keyspace system_traces WITH replication = {'class': 'NetworkTopologyStrategy', 'LIVE_DC_NAME':'3'};

請使用下列 cqlsh 指令，驗證所有鍵值空間是否已在正確的區域中複製：

select * from system_schema.keyspaces;

例如：

select * from system_schema.keyspaces;

 keyspace_name           | durable_writes | replication
-------------------------+----------------+--------------------------------------------------------------------------------
kvm_myhybridorg_hybrid   |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
          system_auth    |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
        system_schema    |           True |                        {'class': 'org.apache.cassandra.locator.LocalStrategy'}
quota_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
cache_myhybridorg_hybrid |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
rtc_myhybridorg_hybrid   |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
   system_distributed    |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
               system    |           True |                        {'class': 'org.apache.cassandra.locator.LocalStrategy'}
               perses    |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
        system_traces    |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}
kms_myhybridorg_hybrid   |           True | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'dc-1': '3'}

(11 rows)

在這個階段，您已從 Cassandra 叢集中完全移除所有已停用的 DC 參照。

附錄：從 Cassandra 叢集中移除 DOWN 節點

當您要回溯多區域安裝作業，且並非所有 Cassandra 容器都處於「上線 / 正常」(UN) 狀態時，請使用這個程序。

執行其中一個 Cassandra Pod：

kubectl exec -it -n CASSANDRA_POD_NAME -- /bin/bash

檢查 Cassandra 叢集的狀態：

nodetool -u JMX_USER -pw JMX_PASSWORD status

驗證節點是否確實處於「Down」狀態 (DN)。在 Cassandra pod 無法啟動的區域中，執行 Cassandra pod。

Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load        Tokens  Owns (effective)  Host ID                               Rack
UN  10.48.12.16  1.15 MiB    256     100.0%            a6340ad9-37ba-4ec8-a8c2-f7b7ac931807  ra-1
UN  10.48.0.18   1.21 MiB    256     100.0%            0d57df49-52e4-4c01-832d-d9df845ab732  ra-1
UN  10.48.14.16  1.18 MiB    256     100.0%            39f03c51-e387-4dac-8360-6d8732e690a7  ra-1

Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load        Tokens  Owns (effective)  Host ID                               Rack
DN  10.8.4.4     432.42 KiB  256     100.0%            cd672398-5c45-4c88-a424-86d757951e53  rc-1
UN  10.8.19.6    5.8 MiB     256     100.0%            84f771f3-3632-4155-b27f-a67125d73bc5  rc-1
UN  10.8.21.5    5.74 MiB    256     100.0%            f6f21b70-348d-482d-89fa-14b7147a5042  rc-1

移除對向下 (DN) 節點的參照。在上述範例中，我們將移除主機 10.8.4.4 的參照。

kubectl exec -it -n apigee apigee-cassandra-default-2 -- /bin/bash
 nodetool -u JMX_USER -pw JMX_PASSWORD removenode HOST_ID

移除參照後，請終止 pod。新的 Cassandra 吊掛單元應該會啟動並加入叢集
```
kubectl delete pod -n POD_NAME
```

驗證新的 Cassandra Pod 是否已加入叢集。

Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load        Tokens  Owns (effective)  Host ID                               Rack
UN  10.48.12.16  1.16 MiB    256     100.0%            a6340ad9-37ba-4ec8-a8c2-f7b7ac931807  ra-1
UN  10.48.0.18   1.22 MiB    256     100.0%            0d57df49-52e4-4c01-832d-d9df845ab732  ra-1
UN  10.48.14.16  1.19 MiB    256     100.0%            39f03c51-e387-4dac-8360-6d8732e690a7  ra-1

Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load        Tokens  Owns (effective)  Host ID                               Rack
UN  10.8.19.6    5.77 MiB    256     100.0%            84f771f3-3632-4155-b27f-a67125d73bc5  rc-1
UN  10.8.4.5     246.99 KiB  256     100.0%            0182e675-eec8-4d68-a465-69211b621601  rc-1
UN  10.8.21.5    5.69 MiB    256     100.0%            f6f21b70-348d-482d-89fa-14b7147a5042  rc-1

此時，您可以繼續升級或回溯叢集中的其他區域。

附錄：疑難排解：回溯後 `apigee-datastore` 處於停滯狀態

在升級後，如果 apigee-datastore 已還原為 hybrid 1.11，且處於卡住狀態，請使用這個程序。

再次修正資料儲存庫控制器狀態前，請先驗證該狀態是否為 releasing，且 Pod 不會隨著 Cassandra 叢集狀態啟動。

使用 Helm 指令驗證資料儲存庫是否已復原：

helm -n APIGEE_NAMESPACE list

例如：

helm -n apigee list
NAME              NAMESPACE  REVISION  UPDATED                                   STATUS    CHART                              APP VERSION
datastore         apigee     3         2024-04-04 22:15:08.792539892 +0000 UTC   deployed   apigee-datastore-1.11.0           1.11.0
ingress-manager   apigee     1         2024-04-02 22:24:27.564184968 +0000 UTC   deployed   apigee-ingress-manager-1.12.0     1.12.0
redis             apigee     1         2024-04-02 22:23:59.938637491 +0000 UTC   deployed   apigee-redis-1.12.0               1.12.0
telemetry         apigee     1         2024-04-02 22:23:39.458134303 +0000 UTC   deployed   apigee-telemetry-1.12             1.12.0
myhybridorg       apigee     1         2024-04-02 23:36:32.614927914 +0000 UTC   deployed   apigee-org-1.12.0                 1.12.0

取得 Cassandra pod 的狀態：

kubectl get pods -n APIGEE_NAMESPACE

例如：

kubectl get pods -n apigee
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   0/1     CrashLoopBackOff   4 (13s ago)   2m13s

驗證 apigeeds 控制器是否卡在釋放狀態：

kubectl get apigeeds -n APIGEE_NAMESPACE

例如：

kubectl get apigeeds -n apigee
NAME      STATE       AGE
default   releasing   46h

驗證 Cassandra 節點狀態 (請注意，其中一個節點處於 DN 狀態，也就是節點卡在 CrashLoopBackOff 狀態)：

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u JMX_USER -pw JMX_PASSWORD status

例如：

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u jmxuser -pw JMX_PASSWORD status
Defaulted container "apigee-cassandra" out of: apigee-cassandra, apigee-cassandra-ulimit-init (init)
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--   Address       Load       Tokens   Owns (effective)   Host ID                               Rack
UN   10.68.7.28    2.12 MiB   256      100.0%             4de9df37-3997-43e7-8b5b-632d1feb14d3  rc-1
UN   10.68.10.29   2.14 MiB   256      100.0%             a54e673b-ec63-4c08-af32-ea6c00194452  rc-1
DN   10.68.6.26    5.77 MiB   256      100.0%             0fe8c2f4-40bf-4ba8-887b-9462159cac45   rc-1

使用 1.12 版圖表升級資料儲存庫。
注意：控制器會再次進入 releasing 狀態，但這次會使用 Hybrid 1.12 的映像檔建立 Pod，Cassandra 會加入叢集並變成 UN (UP/NORMAL)。
```
helm upgrade datastore APIGEE_HELM_1.12.0_HOME/apigee-datastore/   --install   --namespace APIGEE_NAMESPACE   -f overrides.yaml
```

驗證所有 Pod 是否為 Running，並確認 Cassandra 叢集是否恢復正常。

再次驗證所有 Pod 是否為 READY：

kubectl get pods -n APIGEE_NAMESPACE

例如：

kubectl get pods -n apigee
NAME                         READY   STATUS    RESTARTS   AGE
apigee-cassandra-default-0   1/1     Running   0          29h
apigee-cassandra-default-1   1/1     Running   0          29h
apigee-cassandra-default-2   1/1     Running   0          60m

驗證 Cassandra 叢集狀態：

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u JMX_USER -pw JMX_PASSWORD status

例如：

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u jmxuser -pw JMX_PASSWORD status
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--   Address       Load      Tokens   Owns (effective)   Host ID                                Rack
UN   10.68.4.15    2.05 MiB  256      100.0%             0fe8c2f4-40bf-4ba8-887b-9462159cac45   rc-1
UN   10.68.7.28    3.84 MiB  256      100.0%             4de9df37-3997-43e7-8b5b-632d1feb14d3   rc-1
UN   10.68.10.29   3.91 MiB  256      100.0%             a54e673b-ec63-4c08-af32-ea6c00194452   rc-1

驗證 apigeeds 控制器的狀態：

kubectl get apigeeds -n APIGEE_NAMESPACE

例如：

kubectl get apigeeds -n apigee
NAME      STATE     AGE
default   running   2d1h

此時，您已修正資料儲存庫，且資料儲存庫應處於 running 狀態。

將 Apigee Hybrid 升級至 1.12 版 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Apigee Hybrid 1.11 的變更

開始升級至 1.12 版前應考量的問題

Cassandra 注意事項

升級單一地區安裝作業前的注意事項

升級多地區安裝作業前的注意事項

必要條件

限制

升級至 1.12.4 版總覽

準備升級至 1.12 版

備份 cassandra

備份混合式安裝目錄

Linux

Mac OS

Windows

正式發布階段

非正式環境

升級 Kubernetes 版本

點選展開支援平台清單

元件

關於附加叢集

安裝 Hybrid 1.12.4 執行階段

準備升級 Helm 資訊套件

安裝 Apigee Hybrid Helm 資訊套件

升級至 1.12.4 後驗證政策

復原至先前版本

單一區域的回溯和復原作業

在 apigee-datastore 處於良好狀態時回復

在 apigee-datastore 處於不良狀態時還原

多區域回溯及復原

在 apigee-datastore 處於良好狀態時回復

將多區域安裝作業還原至先前版本

從備份還原多區域安裝作業，其中 apigee-datastore 處於不良狀態

附錄：從失敗的升級作業中復原區域

附錄：從 Cassandra 叢集中移除 DOWN 節點

附錄：疑難排解：回溯後 apigee-datastore 處於停滯狀態

將 Apigee Hybrid 升級至 1.12 版

在 `apigee-datastore` 處於良好狀態時回復

在 `apigee-datastore` 處於不良狀態時還原

在 `apigee-datastore` 處於良好狀態時回復

從備份還原多區域安裝作業，其中 `apigee-datastore` 處於不良狀態

附錄：疑難排解：回溯後 `apigee-datastore` 處於停滯狀態