管理筆記本

Vertex AI Workbench 是適用於整個數據資料學工作流程的單一開發環境。如要設定以筆記本為基礎的端對端生產環境，請建立內建整合功能的 JupyterLab 執行個體。如果您是 Vertex AI 新手，請進一步瞭解 Vertex AI Workbench。

本頁說明如何在 Vertex AI Workbench 中管理 JupyterLab 筆記本，包括建立及共用筆記本，以及使用筆記本與 Vertex AI 服務互動。本頁面也會說明如何刪除及更新代管筆記本的 JupyterLab 執行個體。

如要瞭解如何備份及還原資料，請參閱「建立備份並還原筆記本資料」。

事前準備

使用 Vertex AI Workbench 管理筆記本前，您必須準備好專案，才能執行 Vertex AI 服務。詳情請參閱「設定 Vertex AI 專案」一文。

如要取得管理專案命名空間內筆記本資源的權限，請要求專案 IAM 管理員授予您下列其中一個角色：

  • Workbench Notebooks 管理員 (workbench-notebooks-admin)：取得專案中所有 Notebook 資源的讀取和寫入權限。您需要這個角色才能建立 JupyterLab 筆記本。
  • Workbench Notebooks 檢視者 (workbench-notebooks-viewer)：取得專案中所有 Notebook 資源的唯讀存取權。您需要這個角色才能開啟 JupyterLab 筆記本。

如要進一步瞭解這些角色，請參閱「準備 IAM 權限」。

建立 JupyterLab 筆記本

本節說明如何在 Vertex AI Workbench 中設定 JupyterLab 執行個體，並在該執行個體中建立 JupyterLab 筆記本。

符合必要條件後，請按照下列步驟設定 JupyterLab 執行個體，並建立 JupyterLab 筆記本：

  1. 登入 GDC 控制台並選取專案。
  2. 在導覽選單中，依序點按「Vertex AI」>「Workbench」。
  3. 按一下「新增筆記本」。

  4. 在「建立筆記本」頁面中，輸入下列欄位的值：

    • 筆記本名稱：輸入要為 JupyterLab 筆記本指定的名稱。Vertex AI Workbench 會使用您選擇的名稱建立網址，以便存取筆記本。
    • 環境：為 JupyterLab 執行個體選取 Docker 映像檔。這個映像檔提供部署基準和典型的機器學習 (ML) 套件。
    • 叢集：為 JupyterLab 執行個體選取符合使用需求的 Kubernetes 叢集。如果沒有可用的 Kubernetes 叢集，請與管理員合作新增一或多個叢集。
    • CPU / 記憶體：輸入工作負載所需的 CPU 和 RAM 數量。如果是需要大量 CPU 資源的工作負載，您可以選擇多個 CPU。
    • 「GPU」：選取 JupyterLab 執行個體所需的 GPU 數量。在 Distributed Cloud 中，GPU 是 A100 Tensor Core GPU 的一個 NVIDIA 多執行個體 GPU (MIG) 切片。
    • Workspace 磁碟區：輸入所需的儲存空間大小 (以 GB 為單位)。

  5. 點選「建立」。

Vertex AI Workbench 會設定 JupyterLab 執行個體，並建立 JupyterLab 筆記本。儲存筆記本的網址，以供日後存取。

在 Vertex AI Workbench 中建立 JupyterLab 筆記本後，請在 JupyterLab 環境中開啟整合式開發環境 (IDE)。詳情請參閱「開啟 JupyterLab 筆記本」。

開啟 JupyterLab 筆記本

在網頁瀏覽器中輸入 JupyterLab 筆記本的網址，即可開啟筆記本。如果您不知道網址，請按照下列步驟開啟筆記本：

  1. 登入 GDC 控制台並選取專案。
  2. 在導覽選單中，依序點按「Vertex AI」>「Workbench」。
  3. 找到要開啟的 JupyterLab 筆記本，然後點按「Open JupyterLab」，開啟 JupyterLab 執行個體 IDE。
  4. 如果系統提示驗證身分，請按照身分識別提供者的驗證步驟操作。
  5. 在 JupyterLab 執行個體中，開啟 JupyterLab 筆記本。

與其他使用者分享 JupyterLab 筆記本的網址，讓他們也能開啟筆記本。目標使用者必須具備 Workbench Notebooks 檢視者角色。

從 JupyterLab 筆記本使用 Vertex AI 服務

使用用戶端程式庫，透過 JupyterLab 筆記本與 Vertex AI 服務互動。您可以使用 Vertex AI 用戶端程式庫，透過程式輔助的方式，對 Distributed Cloud 上的任何 Vertex AI 服務發出 API 呼叫。

如要從 JupyterLab 筆記本使用 Vertex AI 服務，請按照下列步驟操作：

  1. 啟用對應的 Vertex AI API。
  2. 安裝對應的 Vertex AI 用戶端程式庫。
  3. 建立 JupyterLab 筆記本。
  4. 開啟 JupyterLab 筆記本，並使用 Vertex AI 用戶端程式庫編寫程式碼。舉例來說，您可以使用 Vertex AI Translation 用戶端程式庫翻譯文字。

刪除 JupyterLab 執行個體

如要刪除 JupyterLab 執行個體，請按照下列步驟操作：

  1. 登入 GDC 控制台並選取專案。
  2. 在導覽選單中，依序點按「Vertex AI」>「Workbench」。
  3. 找出與要刪除的 JupyterLab 執行個體相關聯的筆記本。
  4. 勾選 JupyterLab 筆記本的核取方塊。
  5. 點選「刪除」。
  6. 在「刪除記事本」對話方塊中，按一下「刪除」。

更新 JupyterLab 執行個體

基礎架構營運商 (IO) 更新 Distributed Cloud 後，您就可以更新 JupyterLab 執行個體。

請針對要更新的每個 JupyterLab 執行個體執行下列步驟：

  1. 將要保留的 JupyterLab 執行個體檔案儲存到儲存空間值區。詳情請參閱「在專案中上傳及下載儲存空間物件」。
  2. 更新完成後，登入 GDC 控制台並選取專案。
  3. 設定新的 JupyterLab 執行個體。 Vertex AI Workbench 會建立 JupyterLab 執行個體，並搭載新版 JupyterLab。舉例來說，新的 JupyterLab 執行個體包含 Distributed Cloud 的用戶端程式庫更新。
  4. 將舊版 JupyterLab 執行個體儲存空間 bucket 中的檔案，複製到新的 JupyterLab 執行個體。

您可以刪除舊版 JupyterLab 執行個體。詳情請參閱刪除 JupyterLab 執行個體。