升級執行個體的環境
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 會升級作業系統。映像檔版本取決於 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/ 目錄中，這樣就能在升級期間保留這些程式庫。
根據預設，如果您在使用自訂容器建立的核心中安裝 pip 或 Conda 程式庫，這些程式庫只會在核心執行時保留。每次重新啟動核心時，都必須重新安裝這些程式庫。如要在自訂容器中安裝永久程式庫，請在 Dockerfile 中加入程式庫安裝作業。在自訂容器建立的核心中安裝 pip 程式庫時，您可以加入 --user 標記，讓程式庫在執行個體重新啟動前持續存在。
環境版本
Vertex AI Workbench 執行個體有您可以驗證的環境版本號碼：
前往 Google Cloud 控制台的「Instances」頁面。
在執行個體清單中，在「Version」欄中找出執行個體環境的版本號碼。
Vertex AI Workbench 會定期更新環境 (請參閱深度學習 VM 版本資訊)，但每個版本更新時，並非所有環境都會更新。只有在執行個體所依據的 VM 映像檔有較新的環境版本時，Vertex AI Workbench 才會升級執行個體。
如要瞭解如何使用特定版本建立 Vertex AI Workbench 執行個體，請參閱「建立特定版本的 Vertex AI Workbench 執行個體」。
事前準備
升級前，請先完成下列步驟。
自動升級
Vertex AI Workbench 可自動升級執行中的執行個體。如果執行個體已停止，即使您在建立執行個體時已啟用自動升級功能，執行個體也不會自動升級。
啟用自動環境升級功能時，您必須指定週期性時間範圍，讓 Vertex AI Workbench 檢查是否可以升級執行個體，如果可以，就升級執行個體。
您指定的時間範圍會以 unix-cron 格式儲存為 notebook-upgrade-schedule 中繼資料項目，格林威治標準時間 (GMT)。
如要檢查是否可升級執行個體，Vertex AI Workbench 會使用 checkUpgradability API 方法。這個方法會檢查執行個體的開機磁碟上是否有較新的映像檔。
如果可升級執行個體，Vertex AI Workbench 會使用內部升級方法來升級執行個體。
建立啟用自動升級功能的 Vertex AI Workbench 執行個體
如要建立啟用自動升級功能的 Vertex AI Workbench 執行個體，請在建立執行個體時選取「啟用環境自動升級功能」核取方塊，並設定排程。
您可以使用 Google Cloud 控制台指定自動升級功能。
前往 Google Cloud 控制台的「Instances」頁面。
按一下「建立新項目」。
在「New instance」對話方塊中，按一下「Advanced options」。
在「Create instance」對話方塊的「Details」部分，為新執行個體提供下列資訊：
- 名稱：提供新執行個體的名稱。
- 「Region」(地區) 和「Zone」(區域)：選取新執行個體的地區和區域。為取得最佳網路效能，請選取最靠近您的地理區域。請參閱可用的 Vertex AI Workbench 位置。
在「系統健康狀態」部分，選取「環境自動升級」。
選擇要每週或每月更新筆記本。
在「星期幾」欄位中，選取所需選項。
在「小時」欄位中，選擇一天中的某個小時。
完成執行個體建立對話方塊的其餘部分，然後按一下「建立」。
編輯自動升級時間表
如要在建立 Vertex AI Workbench 執行個體後編輯自動升級時間表，請完成下列步驟：
前往 Google Cloud 控制台的「Instances」頁面。
按一下需要變更排程的執行個體名稱。
在「Instance details」(執行個體詳細資料) 頁面的「Environment auto-upgrade」(環境自動升級) 部分中，編輯排程。
按一下「提交」即可儲存變更。
手動升級
您可以手動升級符合規定的 Vertex AI Workbench 執行個體。
檢查執行個體的較新環境
如要確認是否有新版執行個體環境可用，請透過 Google Cloud 控制台存取執行個體。
前往 Google Cloud 控制台的「Instances」頁面。
按一下要檢查新版環境是否可用的執行個體名稱。
在「Instance details」(執行個體詳細資料) 頁面上，點選「VM details」(VM 詳細資料) 旁的「View in Compute Engine」(在 Compute Engine 中查看)。
如果有較新的環境版本可供使用，系統會顯示「This instance needs to be upgraded」訊息。
將執行個體環境升級至新版本
您可以在 Google Cloud 控制台中手動升級 Vertex AI Workbench 執行個體。
前往 Google Cloud 控制台的「Instances」頁面。
如果執行個體未執行，請啟動執行個體。Vertex AI Workbench 只能在執行個體執行時升級。
按一下要升級的執行個體名稱。
在「Instance details」頁面上，按一下 「Upgrade」。
請務必備份執行個體中的資料，再繼續操作。
資料備份完成後，請按一下「升級」。Vertex AI Workbench 會升級及啟動執行個體。
「Upgrade」。復原升級
如要復原升級，請完成下列步驟：
前往 Google Cloud 控制台的「Instances」頁面。
按一下要復原的執行個體名稱。
在「Instance details」頁面的「Upgrade history」下方，按一下「Rollback」。
Vertex AI Workbench 會將執行個體回溯至先前的版本。