升級使用者自行管理的筆記本執行個體的環境

Vertex AI Workbench 使用者自管筆記本執行個體是深度學習 VM 映像檔執行個體，已啟用 JupyterLab 筆記本環境，可供使用。本頁說明如何升級使用者自行管理的筆記本執行個體環境。

升級的好處

您可能基於下列原因，想要升級使用者自行管理的筆記本執行個體環境：

  • 使用環境新版本提供的全新功能。

  • 如要使用環境新版本中導入的架構更新、套件更新和錯誤修正。

升級方法

升級使用者自行管理的筆記本執行個體有兩種方式：

  • 自動升級：建立使用者管理的 Notebooks 執行個體時，啟用自動升級功能。在您指定的週期內，Vertex AI Workbench 會檢查執行個體是否可以升級，如果可以，就會升級執行個體。

  • 手動升級：如果現有的使用者自行管理的筆記本執行個體符合升級需求，您可以手動升級執行個體。

需求條件和限制

不保證可回溯相容於您自行管理的筆記本。複製資料 再升級由使用者管理的筆記本執行個體。

如要判斷是否可以升級特定使用者管理的 Notebook 執行個體，請參閱下列規定和限制：

  • 您必須在執行個體的Google Cloud 專案中啟用 Notebooks API。詳情請參閱列出已啟用的服務和啟用 API。

  • 使用者自行管理的筆記本執行個體環境版本必須為 M54 以上。

  • 使用者管理的筆記本執行個體必須是使用 Notebooks API 建立，或是已向 Notebooks API 註冊。

  • 如果使用者自管筆記本執行個體是以容器為基礎，Vertex AI Workbench 會升級 OS。映像檔版本取決於 Dockerfile 提取的特定映像檔。

    為確保升級作業使用最新版映像檔，建議在 Dockerfile 中使用 latest 標記。

如果無法升級執行個體，請考慮將資料遷移至新的使用者自行管理筆記本執行個體。

升級方式

可升級的使用者自行管理的筆記本執行個體為雙磁碟，包含一個開機磁碟和一個資料磁碟。升級程序會將開機磁碟升級為新映像檔，同時保留資料磁碟上的資料。

哪些元件會升級或保留？

下表說明使用者管理筆記本執行個體中，哪些元件會升級，哪些會保留。

元件 升級結果
機器學習架構 已升級
機器學習資料 已保留
預先安裝的依附元件 已升級
使用者安裝的程式庫 根據預設，必須重新安裝 (請參閱「使用者安裝的程式庫」)
/home/jupyter 目錄中的本機檔案 已保留
其他 /home/ 目錄中的本機檔案 不會保留
預先安裝的作業系統套件 已升級
使用者安裝的作業系統套件 不會保留
GPU 驅動程式 已升級
筆記本 已保留
使用者設定 已保留

使用者安裝的程式庫

根據預設，由使用者管理的筆記本執行個體會將 pip 和 Conda 程式庫儲存在開機磁碟中，而升級時會替換開機磁碟。安裝 pip 程式庫時，可以加入 --user 標記，將程式庫安裝在 /home/jupyter/ 目錄中，這樣升級時就會保留這些程式庫。

根據預設，如果您在從自訂容器建立的 Kernel 中安裝 pip 或 Conda 程式庫，這些程式庫只會在 Kernel 執行時保留。每次重新啟動核心時，都必須重新安裝這些程式庫。如要在自訂容器中安裝永久程式庫，請在 Dockerfile 中加入程式庫安裝作業。在從自訂容器建立的 Kernel 中安裝 pip 程式庫時，您可以加入 --user 旗標，讓程式庫在執行個體重新啟動前都能保留。

環境版本

Vertex AI Workbench 會定期更新環境 (請參閱深度學習 VM 版本資訊)，但每次發布新版本時，並非所有環境都會更新。只有在執行個體所用的 VM 映像檔有較新的環境版本時，Vertex AI Workbench 才會升級執行個體。

如要瞭解如何使用特定版本建立由使用者管理的筆記本執行個體，請參閱建立特定版本的由使用者管理的筆記本執行個體。

升級前

升級前，請先完成下列步驟。

  1. 如要瞭解如何更新至較新版本，請參閱版本資訊。

  2. 建立資料副本做為備份。

自動升級

Vertex AI Workbench 可以自動升級執行中的執行個體。如果執行個體已停止，即使您在建立執行個體時啟用自動升級功能，系統也不會自動升級執行個體。

啟用自動環境升級功能後，您可指定週期性時間範圍，讓 Vertex AI Workbench 檢查執行個體是否可升級，如果可以，就會升級執行個體。

您指定的時間範圍會以 notebook-upgrade-schedule 中繼資料項目的形式儲存，並採用 unix-cron 格式，以格林威治標準時間 (GMT) 為準。

如要檢查執行個體是否可以升級，Vertex AI Workbench 會使用 API 方法 isUpgradeable。這個方法會檢查執行個體開機磁碟是否有較新版本的映像檔。

如果可以升級執行個體，Vertex AI Workbench 會使用內部升級方法升級執行個體。

建立啟用自動升級功能的由使用者管理的筆記本執行個體

如要建立啟用自動升級功能的使用者管理筆記本執行個體，請選取「啟用環境自動升級」核取方塊，並在建立執行個體時設定時間表。

您可以透過 Google Cloud 控制台或 Google Cloud CLI 指定自動升級。

事前準備

如要建立由使用者管理的筆記本執行個體，您必須先擁有Google Cloud 專案，並為該專案啟用 Notebooks API。
  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

  8. 如果您打算搭配 GPU 使用使用者管理的 Notebook 執行個體，請查看 Google Cloud Google Cloud 控制台中的配額頁面，確保專案有足夠的 GPU。如果配額頁面未列出 GPU，或您需要額外的 GPU 配額，請要求增加配額。請參閱 Compute Engine 資源配額頁面的「要求提高配額」一節。

    9. 必要的角色

    如果您建立了專案，您在專案中就擁有「擁有者」(roles/owner) IAM 角色，略過本節，直接建立由使用者管理的筆記本執行個體。如果您不是專案建立者，請繼續閱讀本節內容。

    如要取得建立 Vertex AI Workbench 使用者管理筆記本執行個體所需的權限，請要求管理員授予您專案的下列 IAM 角色：

    如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

    您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

    建立執行個體

    主控台

    1. 前往 Google Cloud 控制台的「User-managed notebooks」頁面。或者前往 notebook.new (https://notebook.new)，然後略過下一個步驟。

      前往使用者自行管理的筆記本

    2. 按一下「New notebook」(新增筆記本)，然後選取「Customize」(自訂)。

    3. 在「Create a user-managed notebook」(建立使用者管理的筆記本) 頁面的「Details」(詳細資料) 區段中，為新執行個體提供下列資訊：

      • 名稱：新執行個體的名稱
      • 「Region」(地區)和「Zone」(區域)：選取新執行個體的地區和區域。如要獲得最佳網路效能，請選取最靠近您的地理區域。查看可用的使用者自行管理的筆記本位置。

    4. 在「系統健康狀態」部分，選取「環境自動升級」。

    5. 選擇要升級為「每週」或「每月」筆記本。

    6. 在「Weekday」(平日) 欄位中，選取所需選項。

    7. 在「時」欄位中，選擇一天中的某個小時。

    8. 完成執行個體建立對話方塊的其餘部分，然後按一下「建立」。

    gcloud

    1. 在 Cloud Shell 或安裝 Google Cloud CLI 的任何環境中，輸入下列 Google Cloud CLI 指令：

      gcloud notebooks instances create INSTANCE_NAME
    --metadata=notebook-upgrade-schedule=SCHEDULE
    --vm-image-project=deeplearning-platform-release
    --vm-image-family=VM_IMAGE_FAMILY
    --machine-type=MACHINE_TYPE
    --location=LOCATION

      更改下列內容：

      • INSTANCE_NAME：新執行個體的名稱
      • SCHEDULE：你設定的每週或每月排程，採用 Unix-Cron 格式；例如「00 19 * * MON」表示每週一格林威治標準時間 (GMT) 19: 00
      • VM_IMAGE_FAMILY：您要用來建立執行個體的映像檔系列名稱
      • MACHINE_TYPE：執行個體 VM 的機器類型
      • LOCATION：新執行個體的位置 Google Cloud

    2. 從 Google Cloud 控制台存取執行個體。

    編輯自動升級時間表

    建立使用者管理的筆記本執行個體後，如要編輯自動升級時間表，請完成下列步驟：

    1. 前往 Google Cloud 控制台的「User-managed notebooks」頁面。

      前往使用者自行管理的筆記本

    2. 按一下需要變更排程的執行個體名稱。

    3. 在「Notebook details」(筆記本詳細資料) 頁面的「Environment auto-upgrade」(環境自動升級) 區段中，編輯排程。

    4. 按一下「提交」儲存變更。

    手動升級

    您可以手動升級符合需求的使用者自行管理的筆記本執行個體。

    檢查執行個體環境是否有較新版本

    如要檢查執行個體環境是否有新版本，請從 Google Cloud 控制台存取執行個體。

    1. 前往 Google Cloud 控制台的「User-managed notebooks」頁面。

      前往使用者自行管理的筆記本

    2. 如果執行個體未執行，請啟動執行個體。 Vertex AI Workbench 只能在執行個體執行時升級。

    3. 按一下要檢查是否有較新環境版本的執行個體名稱。

    4. 在「Notebook details」(筆記本詳細資料) 頁面中，按一下「VM details」(VM 詳細資料) 旁的「View in Compute Engine」(在 Compute Engine 中查看)。

      如有較新的環境版本，系統會顯示「這個執行個體需要升級」訊息。

    將執行個體環境升級至新版本

    您可以在 Google Cloud 控制台中，或使用 Google Cloud CLI 手動升級使用者管理的筆記本執行個體。

    控制台

    1. 前往 Google Cloud 控制台的「User-managed notebooks」頁面。

      前往使用者自行管理的筆記本

    2. 如果執行個體未執行，請啟動執行個體。 只有在執行個體執行時，Vertex AI Workbench 才能升級執行個體。

    3. 按一下要升級的執行個體名稱。

    4. 在「Notebook details」(筆記本詳細資料) 頁面上，按一下「Upgrade」(升級)。

    5. 請務必複製執行個體中的資料，再繼續操作。

    6. 資料備份完成後，請按一下「升級」。 Vertex AI Workbench 會升級並啟動執行個體。

    gcloud

    1. 如要檢查執行個體是否可以升級，請使用 API 方法 isUpgradeable。這個方法會檢查執行個體開機磁碟是否有較新版本的映像檔。

      gcloud notebooks instances is-upgradeable INSTANCE_NAME \
    --location=LOCATION

      更改下列內容：

      • INSTANCE_NAME：執行個體名稱
      • LOCATION：執行個體所在位置 Google Cloud

      如果執行個體可升級，回應為 true。如果回應為 false，表示執行個體無法升級，但您仍可嘗試將資料遷移至新執行個體。

    2. 如果執行個體未執行，請啟動執行個體。 只有在執行個體執行時，Vertex AI Workbench 才能升級執行個體。

    3. 請務必複製執行個體中的資料，再繼續操作。

    4. 如果執行個體可升級，請使用 API 方法 upgrade 升級執行個體：

      gcloud notebooks instances upgrade INSTANCE_NAME \
    --location=LOCATION

      Vertex AI Workbench 會升級執行個體。

    復原升級

    如要復原升級，請完成下列步驟：

    1. 前往 Google Cloud 控制台的「User-managed notebooks」頁面。

      前往使用者自行管理的筆記本

    2. 按一下要復原的執行個體名稱。

    3. 在「Notebook details」(筆記本詳細資料) 頁面的「Upgrade history」(升級記錄) 下方，按一下「Rollback」(回溯)。

    4. Vertex AI Workbench 會將執行個體回復為先前的版本。