原地升級

istioctl upgrade 命令會執行 Istio 的升級。

升級命令也可以執行 Istio 的降級。

請參閱 istioctl 升級參考以了解 istioctl upgrade 命令提供的所有選項。

升級先決條件

在開始升級程序之前，請檢查下列先決條件

• 已安裝的 Istio 版本不低於升級版本的一個次要版本。例如，在開始升級至 1.7.x 之前，必須使用 1.6.0 或更高版本。

• 您的 Istio 安裝是使用 istioctl 安裝的。

升級步驟

本節中的命令應使用新版本的 istioctl 執行，該版本可在下載套件的 bin/ 子目錄中找到。

1. 下載新的 Istio 版本 並將目錄變更為新的版本目錄。

2. 請確保您的 Kubernetes 配置指向要升級的叢集

   $ kubectl config view
   

3. 請確保升級與您的環境相容。

   $ istioctl x precheck
   ✔ No issues found when checking the cluster. Istio is safe to install or upgrade!
   To get started, check out https://istio.dev.org.tw/latest/docs/setup/getting-started/
   

4. 執行此命令開始升級

   $ istioctl upgrade
   

   如果您使用 --set 標誌安裝 Istio，請確保將相同的 --set 標誌傳遞給升級，否則使用 --set 完成的自訂設定將會被還原。對於生產環境使用，建議使用組態檔案而不是 --set。

   如果您省略 -f 標誌，Istio 將使用預設設定檔進行升級。

   執行幾項檢查後，istioctl 將詢問您是否確認繼續。

5. istioctl 將就地將 Istio 控制平面和閘道升級到新版本，並指示完成狀態。

6. 在 istioctl 完成升級後，您必須通過重新啟動任何帶有 Istio Sidecar 的 Pod 來手動更新 Istio 資料平面

   $ kubectl rollout restart deployment
   

降級先決條件

在開始降級過程之前，請檢查以下先決條件

• 您的 Istio 安裝是使用 istioctl 安裝的。

• 您打算降級到的 Istio 版本不能比已安裝的 Istio 版本低一個次要版本。例如，您可以從 Istio 1.7.x 降級到不低於 1.6.0 的版本。

• 降級必須使用與您打算降級到的 Istio 版本相對應的 istioctl 二進制版本來完成。例如，如果您要從 Istio 1.7 降級到 1.6.5，請使用 istioctl 版本 1.6.5。

降級至較低 Istio 版本的步驟

您可以使用 istioctl upgrade 降級到較低版本的 Istio。步驟與上一節中描述的升級過程相同，僅使用與較低版本（例如 1.6.5）相對應的 istioctl 二進制檔案。完成後，Istio 將恢復到先前安裝的版本。

或者，可以使用 istioctl install 來安裝較舊版本的 Istio 控制平面。