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.

이 오류는 노트북의 리전에 머신 유형 구성에 사용할 수 있는 리소스가 없는 경우에 발생합니다.

이 문제를 해결하려면 다음 중 하나를 시도해 보세요.

  • 다른 리전에 런타임을 만듭니다.
  • 다른 머신 유형 구성으로 런타임 템플릿을 만든 다음 새 런타임 템플릿을 기반으로 런타임을 만듭니다.

런타임 템플릿과 예약의 구성이 일치하지 않음

런타임을 만들려고 하면 다음과 유사한 오류가 발생합니다.

Failed to create notebook runtime with error: Invalid value for field
'resource.reservationAffinity': '{"consumeReservationType":
"SPECIFIC_ALLOCATION", "key": "compute.googleapis.com/reservation-name...'.
No available resources in specified reservations.

이 오류는 예약의 VM 속성이 Colab Enterprise 런타임과 일치하지 않을 때 발생합니다. 예를 들어 예약에 e2-standard-8 머신 유형이 지정된 경우에는 e2-standard-8 머신 유형을 사용하는 경우에만 Colab Enterprise 런타임이 해당 예약을 사용할 수 있습니다. 자세한 내용은 요구사항을 참고하세요.

이 문제를 해결하려면 예약의 VM 속성과 일치하는 구성으로 런타임 템플릿을 만드세요.

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. 저장을 클릭합니다.