排解 Colab Enterprise 問題
本頁面說明如何解決 Colab Enterprise 的問題。
無法存取 Colab Enterprise
嘗試在 Google Cloud 控制台存取 Colab Enterprise 時，會發生下列錯誤。
Authentication error: 7; Error Details: User not allowed to access service.
Google Workspace 設定「無個別控制項的額外服務」已關閉。
如要解決這個問題，請將「無個別控制項的其他服務」設為「開啟」。
無法連線至執行階段
這項問題可能有多種原因。另請參閱「無法連線至預設執行階段」。最常見的原因如下：
瀏覽器封鎖第三方 Cookie
您使用的瀏覽器會封鎖 Colab Enterprise 用來與執行階段建立 HTTPS 連線的第三方 Cookie。
如要解決這個問題，請將瀏覽器設定設為允許來自網域 *.aiplatform-notebook.googleusercontent.com 的 DATALAB_TUNNEL_TOKEN 第三方 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) 執行個體。
無法建立執行階段
這個問題會在您無法建立執行階段時發生。另請參閱「無法建立預設執行階段」。最常見的原因如下：
配額不足
如果無法建立執行階段，表示您可能已超過 Compute Engine 執行階段配額。
Colab Enterprise 會使用 Compute Engine 配額來執行程式。詳情請參閱 Compute Engine 配額與限制總覽。
如要解決這個問題，請要求調整配額。
無法使用的資源
嘗試建立執行階段時，會發生下列錯誤。
No available zone found for runtime RUNTIME_ID for machine type MACHINE_TYPE with accelerator type: ACCELERATOR. Please try again later.
如果筆記本所在區域沒有可用的機器類型設定資源，就會發生這項錯誤。
如要解決這個問題，請嘗試下列任一方法：
- 在其他區域建立執行階段。
- 使用不同的機器類型設定建立執行階段範本，然後根據新的執行階段範本建立執行階段。
Colab Enterprise 無法建立執行階段範本
本節說明如何解決建立執行階段範本的問題。
無法選取足夠的 GPU
建立執行階段範本時，您無法選取所需的 GPU 數量。這可能是因為您的配額不足。
Colab Enterprise 會使用 Compute Engine 的 GPU 配額。詳情請參閱 Compute Engine 配額與限制總覽。
如要解決這個問題，請要求調整配額。
預設執行階段已存在
當您嘗試從預設執行階段範本建立執行階段時，如果預設執行階段已存在，就會發生下列錯誤。
Failed to create runtime One click runtime already exists.
如果您嘗試從預設執行階段範本建立執行階段，Colab Enterprise 會嘗試建立預設執行階段。每位使用者、專案和地區只能有一個預設執行階段。如果預設執行階段已存在，Colab Enterprise 就無法建立其他預設執行階段。
如要解決這個問題，請連線至現有的預設執行階段，或使用非預設執行階段範本建立執行階段。
無法建立預設執行階段
Colab Enterprise 建立預設執行階段時，會先建立預設執行階段範本，用於產生預設執行階段。如果您嘗試建立預設執行階段，但缺少建立執行階段範本所需的權限，Colab Enterprise 就無法建立預設執行階段。
如要解決這個問題，請管理員授予您具備 aiplatform.notebookRuntimeTemplates.create 權限的角色。
執行程式碼時找不到使用者憑證
當您嘗試在與 Google Cloud 服務和 API 互動的筆記本中執行程式碼時，但未授予 Colab Enterprise 存取您的使用者憑證，就會發生這個問題。
錯誤訊息可能會如下所示：
Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential
DefaultCredentialsError: Your default credentials were not found.
請參閱以下常見原因和解決方法：
-
您首次連線至已啟用使用者憑證的執行階段時，未完成登入對話方塊。完成這個對話方塊後，您就會授予 Colab Enterprise 存取使用者憑證的權限。
如要解決這個問題，請嘗試再次連線至執行階段並授予存取權。
如要驗證是否已授予存取權，請按照下列步驟操作：
-
依序點選「帳戶」>「受管理的 Google 帳戶」>「資料和隱私權」>「第三方應用程式和服務」。
-
確認是否列出 Colab Enterprise。
-
-
首次連線至已啟用終端使用者憑證的執行階段時，在登入對話方塊 (同意聲明畫面) 中，您未選取使用者帳戶，因此 Colab Enterprise 無法存取您的使用者憑證。
如何解決這個問題：
-
在 Google Cloud 控制台中，依序按一下帳戶個人資料相片和「Google 帳戶」。
-
按一下「資料和隱私權」。
-
在「您在應用程式和服務中的資料」中，點選「第三方應用程式和服務」。
-
按一下「Colab Enterprise」。
-
在「Colab Enterprise 有權存取您 Google 帳戶中的部分資料」中，按一下「查看詳細資料」。
-
按一下 [移除存取權]。
-
按一下「確認」。
這麼做會移除目前的存取設定。
-
下次連線至已啟用終端使用者憑證的執行階段時，請務必在完成「Sign in」對話方塊時選取正確的使用者帳戶。
-
-
彈出式視窗封鎖工具可能會阻擋 Colab Enterprise 登入對話方塊 (同意畫面) 顯示。
如要解決這個問題，請暫時在瀏覽器中啟用彈出式視窗，然後再次嘗試連線至執行階段。
-
Google Workspace 中的額外服務已關閉 Colab。
如要解決這個問題，請在 Google Workspace 中啟用 Colab 服務。
雖然這項政策是針對 Colab 而定，但也會影響 Colab Enterprise。
Colab 應為所有人啟用。
-
企業服務限制可能會阻擋 Colab Enterprise 的存取權。
如要找出這個問題，請 確認貴機構的服務限制不會阻擋 Google 服務的存取權。
「服務狀態」應設為「為所有人啟用」。
-
您未使用啟用使用者憑證的執行階段，且未使用 Google Cloud CLI 將使用者憑證提供給應用程式預設憑證 (ADC)。
如要解決這個問題，請參閱「在筆記本中執行程式碼，將使用者憑證提供給 ADC」一文。
Gemini 功能無法運作
在 Colab Enterprise 筆記本中輸入內容時，系統不會顯示程式碼完成建議。 或者，pen_spark「幫我寫程式碼」按鈕未顯示在程式碼單元格上方。
您可能已在 Colab Enterprise 設定中關閉「顯示依據相關資訊提供的程式碼完成建議」設定。
如要解決這個問題，請按照下列步驟操作：
- 按一下 「切換標題顯示設定」。
- 在「工具」選單中，按一下「設定」。
- 按一下「編輯器」。
- 選取「顯示依據相關資訊提供的程式碼完成建議」。
- 按一下 [儲存]。