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

將 Apigee Hybrid 升級至 1.10 版

本程序涵蓋從 Apigee Hybrid 1.9.x 升級至 Apigee Hybrid 1.10.5，以及從 Hybrid 1.10.x 先前版本升級至 1.10.5 的程序。

升級次要版本 (例如從 1.9 升級至 1.10) 和升級修補程式版本 (例如從 1.10.0 升級至 1.10.5) 時，請使用相同的程序。

升級至 1.10.5 版總覽

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

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

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

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

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

準備升級。
安裝混合式執行階段 1.10.5 版。

先決條件

這些升級操作說明假設您已安裝 Apigee Hybrid 1.9.x 版本，並希望將其升級至 1.10.5 版。如果您要從舊版更新，請參閱將 Apigee hybrid 升級至 1.9 版的操作說明。

準備升級至 1.10 版

備份混合式安裝 (建議)

這些操作說明會使用環境變數 APIGEECTL_HOME，用於您已安裝 apigeectl 的檔案系統目錄。如有需要，請變更目錄至 apigeectl 目錄，然後使用下列指令定義變數：
Linux
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Mac OS
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
```

備份 1.9 版 $APIGEECTL_HOME/ 目錄。例如：

tar -czvf $APIGEECTL_HOME/../apigeectl-v1.9-backup.tar.gz $APIGEECTL_HOME

按照「Cassandra 備份和復原」一文中的操作說明，備份 Cassandra 資料庫。

升級 Kubernetes 版本

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

點選展開支援平台清單

	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
Anthos 服務網格	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 需要使用 Anthos 服務網格 1.14 以上版本。建議您升級至 hybrid v1.8，並改用 Apigee 入口網關，這樣就不必在混合式叢集中安裝 Anthos 服務網格。 ⁽⁶⁾ Apigee hybrid 1.8.4 以上版本支援。 ⁽⁷⁾ Apigee Hybrid 1.8.4 以上版本不支援。 ⁽⁸⁾ Apigee Hybrid 支援 1.7.6 以上版本。 ⁽⁹⁾ 不支援 Apigee Hybrid 1.8.5 以上版本。 ⁽¹⁰⁾ Anthos 服務網格會自動與 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 評估 Anthos 服務網格的使用情形。

如果您使用 Anthos 服務網格做為 Ingress 閘道，則 Apigee 混合型版本 1.8.x 需要 GKE 連結叢集。如果您使用的是 Apigee Ingress 閘道，則附加叢集為選用項目。

安裝 Hybrid 1.10.5 執行階段

請確認您位於混合式基礎目錄 (apigeectl 可執行檔所在目錄的父目錄)：
```
cd $APIGEECTL_HOME/..
```

使用下列指令，下載適用於您作業系統的版本套件。請務必在下表中選取您的平台：

Linux

Linux 64 位元：

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.5/apigeectl_linux_64.tar.gz

Mac OS

Mac 64 位元：

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.5/apigeectl_mac_64.tar.gz

Windows

Windows 64 位元：

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.5/apigeectl_windows_64.zip

將目前的 apigeectl/ 目錄重新命名為備份目錄名稱。例如：

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.9/

Mac OS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.9/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.9

將下載的 gzip 檔案內容解壓縮至混合式基礎目錄。混合型基礎目錄是重新命名的 apigeectl-v1.9 目錄所在的目錄：
Linux
```
tar xvzf filename.tar.gz -C ./
```
Mac OS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
根據預設，tar 內容會解壓縮為名稱中含有版本和平台的目錄。例如：./apigeectl_1.10.5-xxxxxxx_linux_64。使用下列指令將該目錄重新命名為 apigeectl：
Linux
```
mv apigeectl_1.10.5-xxxxxxx_linux_64 apigeectl
```
Mac OS
```
mv apigeectl_1.10.5-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.10.5-xxxxxxx_windows_64 apigeectl
```
切換至 apigeectl 目錄：
```
cd ./apigeectl
```
這個目錄是 apigeectl 主目錄。這是 apigeectl 可執行指令所在的位置。
這些操作說明會使用環境變數 $APIGEECTL_HOME，用於指向安裝 apigeectl 公用程式的檔案系統目錄。如有需要，請變更目錄至 apigeectl 目錄，然後使用下列指令定義變數：
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Mac OS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
使用 version 指令驗證 apigeectl 的版本：
```
./apigeectl version
```
```
Version: 1.10.5
```

建立 hybrid-base-directory/hybrid-files 目錄，然後移動至該目錄。hybrid-files 目錄是設定檔的所在位置，例如覆寫檔案、憑證和服務帳戶。例如：

Linux

mkdir $APIGEECTL_HOME/../hybrid-files

cd $APIGEECTL_HOME/../hybrid-files

Mac OS

mkdir $APIGEECTL_HOME/../hybrid-files

cd $APIGEECTL_HOME/../hybrid-files

Windows

mkdir %APIGEECTL_HOME%/../hybrid-files

cd %APIGEECTL_HOME%/../hybrid-files

使用下列指令，確認 kubectl 已設為正確的內容。應將目前的內容設定為您要升級 Apigee Hybrid 的叢集。
```
kubectl config get-contexts | grep \*
```
在 hybrid-files 目錄中：
1. 將下列符號連結更新為 $APIGEECTL_HOME。這些連結可讓您從 hybrid-files 目錄內執行新安裝的 apigeectl 指令：
```
ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
```
2. 如要確認是否已正確建立符號連結，請執行下列指令，並確認連結路徑指向正確的位置：
```
ls -l | grep ^l
```
請對 overrides.yaml 檔案進行下列變更，啟用 apigee-operator 圖表或使用正確的標記 1.10.5-hotfix.1：
```
  ao:
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-operators"
      tag: "1.10.5-hotfix.1"
  
```
進行初始化模擬測試，檢查是否有錯誤：
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
其中 OVERRIDES_FILE 是覆寫檔案的名稱，例如 ./overrides/overrides.yaml。

提示：您可以將上述程式碼範例中的 OVERRIDES_FILE 替換為覆寫檔案的名稱和路徑，這個頁面上的每個例項都會遭到取代。
如果沒有任何錯誤，請初始化 hybrid 1.10.5：
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
注意：執行 apigeectl init 時，apigeectl 會安裝及設定 Apigee 入口閘道。
檢查初始化狀態：
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
成功之後，輸出內容會顯示：All containers ready.
```
kubectl describe apigeeds -n apigee
```
在輸出內容中，找出 State: running。
使用 --dry-run 標記，執行 apply 指令的模擬測試，檢查是否有錯誤：
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
如果沒有任何錯誤，請套用覆寫值。請根據安裝作業，選取並遵循正式環境或非正式環境的操作說明。
生產

在實際執行環境中，請個別升級每個混合型元件，並在繼續升級下一個元件前，檢查已升級元件的狀態。
1. 確認您位於 hybrid-files 目錄。
2. 套用覆寫值來升級 Cassandra：
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
3. 檢查完成情況：
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  提示：如果 check-ready 失敗，您可以透過以下方式取得 Pod 的更多資訊：
  kubectl -n NAMESPACE get pods
  
  其中 NAMESPACE 是 Apigee 混合式命名空間。
  只有在 Pod 就緒時，才繼續執行下一個步驟。
4. 套用覆寫值來升級遙測元件，並檢查完成情況：
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
5. 啟動 Redis 元件：
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
6. 套用覆寫值來升級機構層級元件 (MART、Watcher 和 Apigee Connect)，並檢查完成情況：
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
7. 套用覆寫值來升級環境。您有兩種選擇：
  - 逐一環境：一次將覆寫值套用至一個環境，並檢查是否完成。針對每個環境重複執行這個步驟：
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    其中 ENV_NAME 是您要升級的環境名稱。
  - 一次套用至所有環境：一次將覆寫值套用至所有環境，並檢查完成情況：
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. 套用覆寫值來升級 virtualhosts 元件，並檢查完成情形：
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
非正式環境

在大多數非正式環境、示範或實驗環境中，您可以一次將覆寫值套用至所有元件。如果非正式環境龐大且複雜，或與正式環境非常相似，建議您按照升級正式環境的操作說明進行操作。
1. 確認您位於 hybrid-files 目錄。
2. $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
3. 查看狀態：
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

復原升級

如要還原先前的升級，請按照下列步驟操作：

清理混合式執行階段命名空間的已完成工作，其中 NAMESPACE 是覆寫檔案中指定的命名空間 (如果您已指定命名空間)。如未指定，預設命名空間為 apigee：
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

清理 apigee-system 命名空間的已完成工作：

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

變更 APIGEECTL_HOME 變數，讓其指向包含舊版 apigeectl 的目錄。例如：
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```

在要回溯至的安裝根目錄中，執行 apigeectl apply，檢查 Pod 狀態，然後執行 apigeectl init。請務必使用原始覆寫檔案，以便還原至所需版本：

在 hybrid-files 目錄中執行 apigeectl apply：
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
其中 ORIGINAL_OVERRIDES_FILE 是舊版混合安裝的覆寫檔案的相對路徑和檔案名稱，例如 ./overrides/overrides1.9.yaml。
請檢查這些 pod 的狀態：
```
kubectl -n NAMESPACE get pods
```
其中 NAMESPACE 是 Apigee 混合式命名空間。

檢查 apigeeds 的狀態：

kubectl describe apigeeds -n apigee

輸出內容應如下所示：

Status:
  Cassandra Data Replication:
  Cassandra Pod Ips:
    10.8.2.204
  Cassandra Ready Replicas:  1
  Components:
    Cassandra:
      Last Successfully Released Version:
        Revision:  v1-f8aa9a82b9f69613
        Version:   v1
      Replicas:
        Available:  1
        Ready:      1
        Total:      1
        Updated:    1
      State:        running
  Scaling:
    In Progress:         false
    Operation:
    Requested Replicas:  0
  State:                 running

只有在 apigeeds pod 執行時，才能繼續進行下一個步驟。

執行下列指令，記下升級後訊息處理器的新複本計數值。如果這些值與先前設定的值不符，請變更覆寫檔案中的值，以符合先前的設定。

apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2

輸出內容應如下所示：

      autoScaler:
        minReplicas: 2
        maxReplicas: 10

執行 apigeectl init：

$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE

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

升級至 1.10.5 版總覽

先決條件

準備升級至 1.10 版

備份混合式安裝 (建議)

Linux

Mac OS

Windows

升級 Kubernetes 版本

點選展開支援平台清單

元件

關於附加叢集

安裝 Hybrid 1.10.5 執行階段

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

生產

非正式環境

復原升級

將 Apigee Hybrid 升級至 1.10 版