連線至執行階段

連線至執行階段

本頁說明如何連線至 Colab Enterprise 中的執行階段。

如要在筆記本中執行程式碼，必須先連線至執行階段。執行階段是執行程式碼的運算資源。

事前準備

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.

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Enable the APIs

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Enable the APIs

使用其他方法連線

本頁說明如何使用下列方法連線至執行階段：

• 使用預設執行階段
• 連線至現有的執行階段
• 建立執行階段

使用預設執行階段

本節說明如何連線至預設執行階段。

必要的角色

如要取得必要權限，以便在 Colab Enterprise 筆記本中連線至預設執行階段，請要求管理員授予您專案的 Colab Enterprise 使用者 (roles/aiplatform.colabEnterpriseUser) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

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

一或多個必要角色包含 dataform.repositories.list 權限。在專案中獲派 dataform.repositories.list 權限或「程式碼建立者」(roles/dataform.codeCreator) 角色的使用者，可以使用 Dataform API 或 Dataform 指令列介面 (CLI)，列出該專案中的程式碼資產名稱。使用 BigQuery Studio 的非管理員只能查看自己建立或與自己共用的程式碼資產。

連線至預設執行階段

首次在筆記本中執行程式碼時，Colab Enterprise 會自動連線至預設執行階段，除非您指定其他執行階段。

如要連線至預設執行階段，但不要執行程式碼，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往 Colab Enterprise 的「My notebooks」(我的筆記本) 頁面。

   前往「我的筆記本」

2. 在「Region」(區域) 選單中，選取包含筆記本的區域。

3. 按一下要開啟的筆記本。如果尚未建立筆記本，請建立筆記本。

4. 在筆記本中，按一下「連線」。
   

5. 如果這是您第一次連結已啟用使用者憑證的執行階段，系統會顯示「登入」對話方塊。

   預設執行階段會預設啟用使用者憑證。如要使用無法存取使用者憑證的執行階段，請建立執行階段範本，並停用使用者憑證。

   如要授予 Colab Enterprise 使用者憑證存取權，請完成下列步驟：

   1. 在「登入」對話方塊中，按一下您的使用者帳戶。

   2. 選取「查看、編輯、設定和刪除您的資料...」 Google Cloud ，授予 Colab Enterprise 存取使用者憑證的權限。

      

   3. 按一下「繼續」。

Colab Enterprise 會連線至預設執行階段，如果預設執行階段未執行，Colab Enterprise 會啟動預設執行階段，然後連線至該階段。

連線至現有執行階段

本節說明如何使用「連線至 Vertex AI 執行階段」對話方塊連線至現有執行階段。

必要的角色

如要取得必要權限，以便在 Colab Enterprise 筆記本中連線至現有執行階段，請要求管理員授予您專案的 Colab Enterprise 使用者 (roles/aiplatform.colabEnterpriseUser) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

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

一或多個必要角色包含 dataform.repositories.list 權限。在專案中獲派 dataform.repositories.list 權限或「程式碼建立者」(roles/dataform.codeCreator) 角色的使用者，可以使用 Dataform API 或 Dataform 指令列介面 (CLI)，列出該專案中的程式碼資產名稱。使用 BigQuery Studio 的非管理員只能查看自己建立或與自己共用的程式碼資產。

連線至現有執行階段

如要連線至現有的執行階段，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往 Colab Enterprise 的「My notebooks」(我的筆記本) 頁面。

   前往「我的筆記本」

2. 在「Region」(區域) 選單中，選取包含筆記本的區域。

3. 按一下要開啟的筆記本。如果尚未建立筆記本，請建立筆記本。

4. 在筆記本中，按一下「其他連線選項」展開箭頭，然後選取「連線到執行階段」。
   

   「Connect to Vertex AI runtime」(連線至 Vertex AI 執行階段) 對話方塊隨即開啟。

5. 在「選取執行階段」部分，選取「連線至現有的執行階段」。

6. 如要選取現有的執行階段選項，請選取要連結的執行階段。如果清單中沒有任何執行階段，請建立執行階段或連線至預設執行階段。

7. 按一下「連線」。

8. 如果您的執行階段已啟用使用者憑證，且您是第一次連線至已啟用使用者憑證的執行階段，系統會顯示「登入」對話方塊。

   如要使用無法存取使用者憑證的執行階段，請建立執行階段範本，並停用使用者憑證。

   如要授予 Colab Enterprise 使用者憑證存取權，請完成下列步驟：

   1. 在「登入」對話方塊中，按一下您的使用者帳戶。

   2. 選取「查看、編輯、設定和刪除您的資料...」 Google Cloud ，授予 Colab Enterprise 存取使用者憑證的權限。

      

   3. 按一下「繼續」。

Colab Enterprise 會連線至執行階段。如果執行階段未執行，Colab Enterprise 會啟動執行階段，然後連線至該執行階段。

建立執行階段

本節說明如何建立執行階段，並使用「Connect to Vertex AI runtime」(連線至 Vertex AI 執行階段) 對話方塊連線至執行階段。或者，您也可以從「執行階段」分頁建立執行階段。

必要的角色

如要取得在 Colab Enterprise 中建立執行階段所需的權限，請要求管理員授予您專案的 Colab Enterprise 管理員 (roles/aiplatform.colabEnterpriseAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

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

一或多個必要角色包含 dataform.repositories.list 權限。在專案中獲派 dataform.repositories.list 權限或「程式碼建立者」(roles/dataform.codeCreator) 角色的使用者，可以使用 Dataform API 或 Dataform 指令列介面 (CLI)，列出該專案中的程式碼資產名稱。使用 BigQuery Studio 的非管理員只能查看自己建立或與自己共用的程式碼資產。

建立並連線至執行階段

如要建立執行階段並使用「Connect to Vertex AI runtime」(連線至 Vertex AI 執行階段) 對話方塊連線至執行階段，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往 Colab Enterprise 的「My notebooks」(我的筆記本) 頁面。

   前往「我的筆記本」

2. 在「Region」(區域) 選單中，選取包含筆記本的區域。

3. 按一下要開啟的筆記本。如果尚未建立筆記本，請建立筆記本。

4. 在筆記本中，按一下「其他連線選項」展開箭頭，然後選取「連線到執行階段」。
   

   「Connect to Vertex AI runtime」(連線至 Vertex AI 執行階段) 對話方塊隨即開啟。

5. 在「選取執行階段」部分，選取「建立新的執行階段」。

6. 在「執行階段範本」選單中，選取執行階段範本。如果沒有列出任何執行階段範本，請建立執行階段範本。

7. 在「Runtime name」(執行階段名稱) 欄位中，輸入執行階段的名稱。

8. 按一下「連線」。

9. 如果您選取的執行階段範本已啟用使用者憑證，且這是您首次連線至已啟用使用者憑證的執行階段，系統會顯示「登入」對話方塊。

   如要使用無法存取使用者憑證的執行階段，請建立執行階段範本，並停用使用者憑證。

   如要授予 Colab Enterprise 使用者憑證存取權，請完成下列步驟：

   1. 在「登入」對話方塊中，按一下您的使用者帳戶。

   2. 選取「查看、編輯、設定和刪除您的資料...」 Google Cloud ，授予 Colab Enterprise 存取使用者憑證的權限。

      

   3. 按一下「繼續」。

Colab Enterprise 會啟動預設執行階段，然後連線至該執行階段。

切換至預設的 GPU 執行階段

如果管理員已啟用預設 GPU 執行階段，或您的使用者帳戶具有 aiplatform.notebookRuntimeTemplates.create 權限，連線至預設執行階段後，即可切換至具有 GPU 的執行階段。

在筆記本中，按一下「切換至 GPU」。

如要瞭解如何啟用含 GPU 的預設執行階段，請參閱「啟用含 GPU 的預設執行階段」。

執行階段管理

根據預設，您建立執行階段時，系統會自動授予刪除 (aiplatform.googleapis.com/notebookRuntimes.delete) 和啟動 (aiplatform.googleapis.com/notebookRuntimes.start) 該執行階段的必要權限。

如要瞭解如何管理執行階段 (包括刪除、啟動或中斷執行階段連線)，請參閱「管理執行階段」。

疑難排解

本節說明如何解決 Colab Enterprise 中連線至執行階段的問題。

無法連線至執行階段

造成這個問題的原因有很多，另請參閱「無法連線至預設執行階段」。最常見的原因如下：

瀏覽器封鎖第三方 Cookie

您使用的瀏覽器封鎖了第三方 Cookie，而 Colab Enterprise 會使用這類 Cookie 與執行階段建立 HTTPS 連線。

如要解決這個問題，請將瀏覽器設定為允許來自網域 DATALAB_TUNNEL_TOKEN*.aiplatform-notebook.googleusercontent.com 的第三方 Cookie。

網路會封鎖筆記本網域的出埠流量

您網路的防火牆規則會封鎖傳出流量，使其無法連至 *.aiplatform-notebook.cloud.google.com 或 *aiplatform.googleapis.com。

如要解決這個問題，請設定網路的防火牆規則，允許傳出流量到 *.aiplatform-notebook.cloud.google.com 和 *aiplatform.googleapis.com。

無法連線至預設執行階段

當您嘗試連線至預設執行階段，但沒有現有的預設執行階段範本時，就會發生下列錯誤：

Failed to connect to runtime

連線至尚未建立的預設執行階段時，Colab Enterprise 會先建立預設執行階段範本，然後使用該範本產生預設執行階段。不過，如果您沒有建立執行階段範本的必要權限，Colab Enterprise 就無法建立預設執行階段範本和預設執行階段。

如要解決這個問題，請管理員授予您具備 aiplatform.notebookRuntimeTemplates.create 權限的角色。

筆記本連線至執行階段的速度緩慢

開始連線至執行階段幾分鐘後，筆記本右上角仍顯示 Connecting 訊息，且 Colab Enterprise 尚未連線至執行階段。

如要解決這個問題，請再等幾分鐘。Colab Enterprise 仍在連線至執行階段。連線至尚未執行的執行階段可能需要幾分鐘，因為 Vertex AI 會配置新的虛擬機器 (VM) 執行個體。

無法建立執行階段

如果無法建立執行階段，就會發生這個問題。另請參閱「無法建立預設執行階段」。最常見的原因如下：

無法使用的資源

嘗試建立執行階段時發生下列錯誤。

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

如果筆記本所在區域沒有可用的機器類型設定資源，就會發生這項錯誤。

如要解決這個問題，請嘗試下列任一方法：

• 在其他區域建立執行階段。
• 建立具有不同機器類型設定的執行階段範本，然後根據新的執行階段範本建立執行階段。

預設執行階段已存在

如果預設執行階段已存在，嘗試從預設執行階段範本建立執行階段時，會發生下列錯誤：

Failed to create runtime

One click runtime already exists.

如果您嘗試從預設執行階段範本建立執行階段，Colab Enterprise 會嘗試建立預設執行階段。每個使用者、專案和區域只能有一個預設執行階段。如果預設執行階段已存在，Colab Enterprise 就無法建立其他預設執行階段。

如要解決這個問題，請連線至現有的預設執行階段，或使用非預設執行階段範本建立執行階段。

無法建立預設執行階段

Colab Enterprise 建立預設執行階段時，會先建立預設執行階段範本，再使用該範本產生預設執行階段。如果您嘗試建立預設執行階段，但沒有建立執行階段範本所需的權限，Colab Enterprise 就無法建立預設執行階段。

如要解決這個問題，請管理員授予您具備 aiplatform.notebookRuntimeTemplates.create 權限的角色。

後續步驟

• 進一步瞭解執行階段和執行階段範本。
• 建立執行階段範本。
• 如要尋找可協助您快速啟動專案的筆記本，請參閱筆記本庫。