管理使用者自行管理的筆記本執行個體 JupyterLab 介面的存取權

管理使用者自行管理的筆記本執行個體 JupyterLab 介面的存取權

Vertex AI Workbench 使用者自行管理的筆記本已淘汰。2025 年 4 月 14 日，我們將停止支援使用者管理的筆記本，並移除建立使用者管理的筆記本執行個體的功能。現有的執行個體會繼續運作，但不會提供修補程式、更新和升級。如要繼續使用 Vertex AI Workbench，建議您將使用者管理型筆記本執行個體遷移至 Vertex AI Workbench 執行個體。

本頁說明如何授予 Vertex AI Workbench 使用者管理的筆記本執行個體 JupyterLab 介面存取權。

您可以透過執行個體的存取模式，控管使用者管理的筆記本執行個體 JupyterLab 介面。建立由使用者管理的筆記本執行個體時，您會設定 JupyterLab 存取模式。筆記本建立後即無法變更存取模式。

JupyterLab 存取模式會決定誰可以使用執行個體的 JupyterLab 介面。存取模式也會決定執行個體與其他 Google Cloud 服務互動時使用的憑證。

存取限制

將主要存取權授予使用者管理的筆記本執行個體 JupyterLab 介面，並不會授予執行個體本身的存取權。舉例來說，如要啟動、停止或重設執行個體，您必須在執行個體上設定 IAM 政策，授予主要使用者執行這些作業的存取權。如要授予使用者自行管理的筆記本執行個體存取權，請參閱「管理使用者自行管理的筆記本執行個體存取權」。

JupyterLab 存取模式

使用者管理的筆記本執行個體支援下列存取模式：

• 僅限單一使用者：僅限單一使用者存取模式只會將存取權授予您指定的使用者。

• 服務帳戶：服務帳戶存取模式會將存取權授予服務帳戶。您可以透過這個服務帳戶，將存取權授予一或多位使用者。

注意： 如要透過單一使用者選項或服務帳戶授予執行個體存取權，您必須使用個別使用者的使用者帳戶電子郵件地址。不支援群組存取權。

僅限單一使用者

建立由使用者管理的筆記本執行個體時，如果您選擇「僅限單一使用者」存取權，請指定使用者帳戶。指定的使用者帳戶是唯一可存取 JupyterLab 介面的使用者。如果指定使用者不是執行個體的建立者，您必須為該使用者授予執行個體服務帳戶的服務帳戶使用者角色 (roles/iam.serviceAccountUser)。如果執行個體需要存取其他 Google Cloud 資源，這個服務帳戶也必須具備存取這些 Google Cloud 資源的權限。

注意： 如果您建立使用者管理的筆記本執行個體，並設定為僅限單一使用者存取權，執行個體會使用 Compute Engine 預設服務帳戶完成啟動程序。在啟動程序完成後，您指定的使用者帳戶就能存取執行個體。

將存取權授予單一使用者

如要授予單一使用者的存取權，請完成下列步驟。

1. 建立由使用者管理的筆記本執行個體，並設定下列規格：

   1. 在「Create instance」對話方塊的「IAM and security」部分中，選取「Single user only」存取模式。

   2. 在「使用者電子郵件」欄位中，輸入要授予存取權的使用者帳戶。

2. 完成對話方塊的其餘步驟，然後按一下「建立」。

服務帳戶

建立具有服務帳戶存取權的使用者管理筆記本執行個體時，您需要指定服務帳戶。如果執行個體需要存取其他 Google 資源，這個服務帳戶也必須具備存取這些 Google 資源的權限。

指定服務帳戶時，請選擇下列任一選項：

• 選取 Compute Engine 預設服務帳戶。
• 指定自訂服務帳戶。自訂服務帳戶必須與使用者管理的 Notebook 執行個體位於相同專案。如要建立執行個體，您必須具備服務帳戶的 iam.serviceAccounts.actAs 權限。

如要透過服務帳戶授予使用者存取權，請為需要存取 JupyterLab 的每位使用者，授予指定服務帳戶的 iam.serviceAccounts.actAs 權限。

透過服務帳戶將存取權授予多位使用者

1. 建立由使用者管理的筆記本執行個體，並設定下列規格：

   1. 在「Create instance」對話方塊的「IAM and security」專區中，選取「Service account」存取模式。

   2. 選擇 Compute Engine 預設服務帳戶或自訂服務帳戶。

      • 如要使用 Compute Engine 預設服務帳戶，請選取「Use Compute Engine default service account」(使用 Compute Engine 預設服務帳戶)。

      • 如要使用自訂服務帳戶，請取消勾選「使用 Compute Engine 預設服務帳戶」，然後在「服務帳戶電子郵件」欄位中輸入自訂服務帳戶的電子郵件地址。

2. 完成對話方塊的其餘步驟，然後按一下「建立」。

3. 針對需要存取 JupyterLab 的每位使用者，請授予服務帳戶 iam.serviceAccounts.actAs 權限。

存取模式中繼資料

在建立使用者管理的筆記本執行個體時所設定的存取模式，會儲存在筆記本中繼資料中。

選取「僅限單一使用者」存取模式時，Vertex AI Workbench 會儲存 proxy-mode 和 proxy-user-mail 的值。以下是單一使用者存取權中繼資料項目的範例：

• proxy-mode=mail
• proxy-user-mail=[e-mail]

選取「服務帳戶」存取模式時，Vertex AI Workbench 會儲存 proxy-mode=service_account 中繼資料項目。

注意： 系統不支援變更存取模式中繼資料，這可能會導致無法存取 JupyterLab 介面。

後續步驟

• 將主體存取權授予由使用者管理的筆記本執行個體。

• 如要瞭解如何授予其他 Google 資源的存取權，請參閱「管理其他資源的存取權」。