升級執行個體環境
Vertex AI Workbench 執行個體是深度學習 VM 映像檔執行個體，已啟用 JupyterLab 筆記本環境，可供使用。本頁說明如何升級 Vertex AI Workbench 執行個體的環境。
升級的好處
您可能基於下列原因，需要升級 Vertex AI Workbench 執行個體的環境：
使用環境新版本提供的功能。
如要使用新版環境中導入的架構更新、套件更新和錯誤修正。
升級方法
升級 Vertex AI Workbench 執行個體的方式有兩種：
自動升級：建立 Vertex AI Workbench 執行個體時，啟用自動升級功能。在您指定的週期內，Vertex AI Workbench 會檢查執行個體是否可以升級，如果可以，Vertex AI Workbench 就會升級執行個體。
手動升級：如果現有的 Vertex AI Workbench 執行個體符合升級需求，您可以手動升級執行個體。
需求條件和限制
不保證可回溯相容於 Vertex AI Workbench。升級 Vertex AI Workbench 執行個體前，請複製資料。
如要判斷是否可以升級特定 Vertex AI Workbench 執行個體，請參閱下列需求和限制：
必須在執行個體的Google Cloud 專案中啟用 Notebooks API。詳情請參閱列出已啟用的服務和啟用 API。
如果 Vertex AI Workbench 執行個體是以容器為基礎，Vertex AI Workbench 會升級 OS。映像檔版本取決於 Dockerfile 提取的特定映像檔。
為確保升級作業使用最新版本的映像檔，請考慮在 Dockerfile 中使用
latest標記。
如果無法升級執行個體，請考慮將資料遷移至新的 Vertex AI Workbench 執行個體。
升級方式
可升級的 Vertex AI Workbench 執行個體為雙磁碟，包含一個開機磁碟和一個資料磁碟。升級程序會將開機磁碟升級為新映像檔，同時保留資料磁碟上的資料。
哪些元件會升級或保留？
下表說明 Vertex AI Workbench 執行個體中哪些元件會升級，哪些會保留。
| 元件 | 升級結果 |
|---|---|
| 機器學習架構 | 已升級 |
| 機器學習資料 | 已保留 |
| 預先安裝的依附元件 | 已升級 |
| 使用者安裝的程式庫 | 根據預設，必須重新安裝 (請參閱「使用者安裝的程式庫」) |
/home/jupyter 目錄中的本機檔案 |
已保留 |
其他 /home/ 目錄中的本機檔案 |
未保留 |
| 預先安裝的作業系統套件 | 已升級 |
| 使用者安裝的作業系統套件 | 未保留 |
| GPU 驅動程式 | 已升級 |
| 筆記本 | 已保留 |
| 使用者設定 | 已保留 |
使用者安裝的程式庫
根據預設，Vertex AI Workbench 執行個體會在開機磁碟中儲存 pip 和 Conda 程式庫，而升級時會替換開機磁碟。安裝 pip 程式庫時，可以加入 --user 標記，將程式庫安裝在 /home/jupyter/ 目錄中，這樣升級時就會保留這些程式庫。
根據預設，如果您在從自訂容器建立的 Kernel 中安裝 pip 或 Conda 程式庫，這些程式庫只會在 Kernel 執行時保留。每次重新啟動核心時，都需要重新安裝這些程式庫。如要在自訂容器中安裝永久程式庫，請在 Dockerfile 中加入程式庫安裝作業。在從自訂容器建立的 Kernel 中安裝 pip 程式庫時，您可以加入 --user 標記，讓程式庫在執行個體重新啟動前都能保留。
環境版本
Vertex AI Workbench 執行個體具有環境版本號碼，您可以驗證：
前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。
在執行個體清單中，找出「版本」欄中執行個體環境的版本號碼。
Vertex AI Workbench 會定期更新環境 (請參閱版本資訊)，但每次發布新版本時，並非所有環境都會更新。只有在執行個體所用的 VM 映像檔有較新的環境版本時，Vertex AI Workbench 才會升級執行個體。
如要瞭解如何使用特定版本建立 Vertex AI Workbench 執行個體，請參閱「建立特定版本的 Vertex AI Workbench 執行個體」。
事前準備
升級前，請先完成下列步驟。
自動升級
Vertex AI Workbench 可以自動升級執行中的執行個體。如果執行個體已停止，即使您在建立執行個體時啟用自動升級，系統也不會自動升級執行個體。
啟用自動環境升級功能後，您可指定週期性時間範圍，讓 Vertex AI Workbench 檢查執行個體是否可以升級，如果可以，就會升級執行個體。
您指定的時間範圍會以 notebook-upgrade-schedule 中繼資料項目的形式儲存，並採用 unix-cron 格式，以格林威治標準時間 (GMT) 為準。
如要檢查執行個體是否可以升級，Vertex AI Workbench 會使用 API 方法 checkUpgradability。這個方法會檢查執行個體開機磁碟是否有較新版本的映像檔。
如果可以升級執行個體，Vertex AI Workbench 會使用內部升級方法升級執行個體。
建立已啟用自動升級功能的 Vertex AI Workbench 執行個體
如要建立啟用自動升級功能的 Vertex AI Workbench 執行個體，請選取「啟用環境自動升級」核取方塊，並在建立執行個體時設定排程。
您可以使用 Google Cloud 控制台指定自動升級。
前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。
按一下 「建立新標籤」。
在「New instance」對話方塊中，按一下「Advanced options」。
在「建立執行個體」對話方塊的「詳細資料」部分，為新執行個體提供下列資訊：
- 名稱：為新執行個體命名。
- 「Region」(地區)和「Zone」(區域)：選取新執行個體的地區和區域。如要獲得最佳網路效能，請選取最靠近您的地理區域。請參閱可用的 Vertex AI Workbench 位置。
在「系統健康狀態」部分，選取「環境自動升級」。
選擇要升級「每週」或「每月」筆記本。
在「Weekday」(平日) 欄位中，選取所需選項。
在「Hour」(小時) 欄位中，選擇一天中的某個小時。
完成執行個體建立對話方塊的其餘部分，然後按一下「建立」。
編輯自動升級時間表
建立 Vertex AI Workbench 執行個體後，如要編輯自動升級排程，請完成下列步驟：
前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。
按一下需要變更排程的執行個體名稱。
在「執行個體詳細資料」頁面的「環境自動升級」部分，編輯排程。
按一下「提交」儲存變更。
手動升級
您可以手動升級符合需求的 Vertex AI Workbench 執行個體。
檢查執行個體環境是否有較新版本
如要檢查執行個體環境是否有新版本，請從 Google Cloud 控制台存取執行個體。
前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。
按一下要檢查是否有較新環境版本的執行個體名稱。
在「執行個體詳細資料」頁面中，按一下「VM 詳細資料」旁的「在 Compute Engine 中查看」。
如有較新的環境版本，系統會顯示「這個執行個體需要升級」訊息。
將執行個體環境升級至新版本
您可以在 Google Cloud 控制台中手動升級 Vertex AI Workbench 執行個體。
前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。
如果執行個體未執行，請啟動執行個體。 只有在執行個體執行時，Vertex AI Workbench 才能升級執行個體。
按一下要升級的執行個體名稱。
在「執行個體詳細資料」頁面上，按一下「升級」。
請務必複製執行個體中的資料，再繼續操作。
資料備份完成後，請按一下「升級」。 Vertex AI Workbench 會升級並啟動執行個體。
。復原升級
如要復原升級，請完成下列步驟：
前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。
按一下要復原的執行個體名稱。
在「Instance details」(執行個體詳細資料) 頁面的「Upgrade history」(升級記錄) 下方，按一下「Rollback」(回溯)。
Vertex AI Workbench 會將執行個體回復至先前的版本。