Colab Enterprise 문제 해결

이 페이지에서는 Colab Enterprise 관련 문제를 해결하는 방법을 보여줍니다.

Colab Enterprise에 액세스할 수 없음

Google Cloud 콘솔에서 Colab Enterprise에 액세스하려고 하면 다음 오류가 발생합니다. 

Authentication error: 7; Error Details: User not allowed to access service.

Google Workspace 설정 개별 컨트롤이 없는 추가 서비스가 사용 중지됩니다.

이 문제를 해결하려면 개별 설정 없이 추가 서비스를 사용으로 설정하세요.

런타임에 연결할 수 없음

이 오류는 여러 가지 이유로 발생합니다. 기본 런타임에 연결할 수 없음도 참고하세요. 가장 일반적인 원인은 다음과 같습니다.

브라우저에서 제3자 쿠키 차단

사용 중인 브라우저에서 Colab Enterprise가 런타임과 HTTPS 연결을 설정하는 데 사용하는 제3자 쿠키를 차단하고 있습니다.

이 문제를 해결하려면 *.aiplatform-notebook.googleusercontent.com 도메인에서 DATALAB_TUNNEL_TOKEN 제3자 쿠키를 허용하도록 브라우저 설정을 구성합니다.

네트워크가 노트북 도메인에 대한 아웃바운드 트래픽 차단

네트워크의 방화벽 규칙은 *.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는 GPU에 Compute Engine 할당량을 사용합니다. 자세한 내용은 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에 사용자 인증 정보에 대한 액세스 권한이 부여됩니다.

    이 문제를 해결하려면 런타임에 다시 연결하고 액세스 권한을 부여해 보세요.

    액세스 권한이 부여되었는지 확인하려면 다음 단계를 따르세요.

    1. 계정 > 관리 Google 계정 > 데이터 및 개인 정보 보호 > 서드 파티 앱 및 서비스를 클릭합니다.

    2. Colab Enterprise가 표시되는지 확인합니다.

  • 최종 사용자 인증 정보가 사용 설정된 런타임에 처음 연결할 때 표시되는 로그인 대화상자 (동의 화면)에서 Colab Enterprise에 사용자 인증 정보에 대한 액세스 권한을 부여할 사용자 계정을 선택하지 않았습니다.

    이 문제를 해결하려면 다음 안내를 따르세요.

    1. Google Cloud 콘솔에서 계정 프로필 이미지를 클릭한 다음 Google 계정을 클릭합니다.

    2. 데이터 및 개인 정보 보호를 클릭합니다.

    3. 사용 중인 앱 및 서비스의 데이터에서 서드 파티 앱 및 서비스를 클릭합니다.

    4. Colab Enterprise를 클릭합니다.

    5. Colab Enterprise에 Google 계정에 대한 일부 액세스 권한이 있습니다에서 세부정보 보기를 클릭합니다.

    6. 액세스 권한 삭제를 클릭합니다.

    7. 확인을 클릭합니다.

      이렇게 하면 현재 액세스 설정이 삭제됩니다.

    8. 다음에 최종 사용자 인증 정보가 사용 설정된 런타임에 연결할 때 로그인 대화상자를 작성할 때 올바른 사용자 계정을 선택해야 합니다.

  • 팝업 차단기로 인해 Colab Enterprise 로그인 대화상자 (동의 화면)가 표시되지 않을 수 있습니다.

    이 문제를 해결하려면 브라우저에서 일시적으로 팝업을 사용 설정하고 런타임에 다시 연결해 보세요.

  • Google Workspace의 추가 서비스에서 Colab이 사용 중지되었습니다.

    이 문제를 해결하려면 Google Workspace에서 Colab 서비스를 사용 설정하세요.

    Colab을 언급하지만 Colab Enterprise에도 영향을 미칩니다.

    Colab이 모든 사용자에 대해 사용 설정되어 있어야 합니다.

  • Enterprise 서비스 제한으로 인해 Colab Enterprise에 액세스하지 못할 수 있습니다.

    이 문제를 파악하려면 조직의 서비스 제한사항이 Google 서비스에 대한 액세스를 차단하고 있지 않은지 확인합니다.

    서비스 상태가 모든 사용자에 대해 사용으로 설정되어야 합니다.

  • 최종 사용자 인증 정보가 사용 설정된 런타임을 사용하지 않고 있으며 Google Cloud CLI를 사용하여 애플리케이션 기본 사용자 인증 정보 (ADC)에 사용자 인증 정보를 제공하지 않았습니다.

    이 문제를 해결하려면 노트북에서 코드를 실행하여 ADC에 사용자 인증 정보 제공을 참고하세요.

Gemini 기능이 작동하지 않음

Colab Enterprise 노트북에 입력해도 코드 완성 제안이 표시되지 않습니다. 또는 pen_spark 코딩 도우미 버튼이 코드 셀 위에 표시되지 않습니다.

Colab Enterprise 설정에서 코드 완성 제안을 자동으로 표시 설정을 사용 중지했을 수 있습니다.

이 문제를 해결하려면 다음 단계를 따르세요.

  1.  헤더 공개 상태 전환을 클릭합니다.
  2. 도구 메뉴에서 설정을 클릭합니다.
  3. 편집기를 클릭합니다.
  4. 코드 완성 제안을 자동으로 표시를 선택합니다.
  5. 저장을 클릭합니다.