SSH를 사용하여 JupyterLab에 액세스

JupyterLab 인스턴스에 대한 HTTPS 액세스 권한이 없으면 항상 SSH를 사용하여 연결을 설정한 다음 http://localhost:8080을 방문하여 JupyterLab에 액세스해야 합니다.

다음 단계에 따라 로컬 포트 전달을 설정한 다음 로컬 브라우저를 통해 JupyterLab 세션에 액세스하세요.

  1. Cloud Shell에서 또는 Cloud SDK가 설치된 환경에서 다음 명령어를 입력합니다. my-project-id, my-zone, my-instance를 관련 정보로 바꿉니다.

    export PROJECT_ID="my-project-id"
    export ZONE="my-zone"
    export INSTANCE_NAME="my-instance"
    gcloud compute ssh --project $PROJECT_ID --zone $ZONE \
      $INSTANCE_NAME -- -L 8080:localhost:8080
    
  2. 로컬 웹브라우저에서 http://localhost:8080을 방문하여 JupyterLab에 액세스합니다.

HTTPS 액세스 권한이 없을 수 있는 이유

JupyterLab에 대한 HTTPS 액세스 권한을 얻으려면 AI Platform Notebooks 인스턴스가 Google Cloud 프록시 서비스에 액세스할 수 있어야 합니다. 인스턴스는 시작될 때 프록시 서비스에 등록하려고 시도합니다. 프록시 액세스 권한을 얻는 데 실패하면 AI Platform Notebooks는 SSH를 통해 JupyterLab에 액세스하라는 메시지를 표시합니다.

JupyterLab에 대한 HTTPS 액세스 권한이 없을 수 있는 일반적인 이유는 다음과 같습니다.

  • JupyterLab 인스턴스의 프록시 모드 메타데이터 설정이 잘못되었습니다.

  • JupyterLab 메모장을 실행하는 가상 머신의 인터넷 액세스를 차단하도록 네트워크가 구성되어 있습니다.

  • AI Platform Notebooks 인스턴스에 외부 IP 주소가 없습니다.

  • VPC 서비스 제어 설정이 Container Registry에 대한 액세스를 차단합니다.

다음 섹션에서 이러한 문제를 해결하는 방법에 대해 알아보세요.

JupyterLab 인스턴스의 프록시 모드 메타데이터 설정이 잘못되었습니다

기본적으로 AI Platform Notebooks를 사용하여 JupyterLab 인스턴스를 만들면 프록시 모드 메타데이터 설정이 자동으로 추가되지만 설정을 변경하거나 삭제하면 메모장이 더 이상 프록시 서비스에 연결할 수 없습니다.

프록시 모드 메타데이터 설정이 올바른지 확인하려면 다음 단계를 완료하세요.

  1. Google Cloud Console에서 AI Platform Notebooks 페이지로 이동합니다.

    AI Platform Notebooks 페이지로 이동

  2. 인스턴스 이름 열에서 수정해야 하는 AI Platform Notebooks 인스턴스를 클릭합니다.

  3. 수정을 클릭합니다.

  4. 커스텀 메타데이터 섹션까지 아래로 스크롤하여 메타데이터를 추가하거나 수정하여 project_editors로 설정된 프록시 모드 항목이 있는지 확인합니다.

    proxy-mode가 project_editors로 설정된 메타데이터 설정

  5. 저장을 클릭합니다.

네트워크가 인터넷 액세스를 차단하고 있습니다

JupyterLab 인스턴스는 공개 URL을 통해 프록시 서비스에 액세스합니다. Virtual Private Cloud 네트워크 설정이 공개 인터넷에 대한 액세스를 차단하거나 방화벽 규칙이 이그레스 트래픽을 차단하는 경우 SSH를 사용하여 AI Platform Notebooks 인스턴스에 액세스해야 합니다. 가능하다면 네트워크 및 방화벽 관리자와 협력하여 공개 인터넷을 통한 AI Platform Notebooks 인스턴스에 대한 액세스를 허용하는 것이 좋습니다.

AI Platform Notebooks 인스턴스에 외부 IP 주소가 없습니다

외부 IP 주소 없이 AI Platform Notebooks 인스턴스를 만들었을 수도 있습니다. 이를 변경해야 하는 경우 다음 단계를 완료하세요.

  1. Google Cloud Console에서 AI Platform Notebooks 페이지로 이동합니다.

    AI Platform Notebooks 페이지로 이동

  2. 인스턴스 이름 열에서 수정해야 하는 AI Platform Notebooks 인스턴스를 클릭합니다.

  3. 수정을 클릭합니다.

  4. 네트워크 인터페이스 섹션까지 아래로 스크롤하고 네트워크 인터페이스에서 상자를 클릭하여 펼칩니다.

  5. 외부 IP에서 드롭다운 메뉴를 클릭하여 원하는 옵션을 선택하고 다른 IP 주소 설정을 원하는 대로 조정합니다. 이 문제를 해결하려면 없음을 선택하지 말아야 합니다.

    네트워크 인터페이스 설정

  6. 네트워크 인터페이스 상자의 하단에서 완료를 클릭합니다.

  7. 저장을 클릭합니다.

VPC 서비스 제어 설정이 Container Registry에 대한 액세스를 차단하고 있습니다

AI Platform Notebooks 인스턴스는 Container Registry에서 다운로드한 에이전트를 실행하여 프록시 서비스에 연결합니다. 이 에이전트가 없으면 인스턴스는 프록시 서비스에 연결할 수 없습니다.

VPC 서비스 제어 설정이 Container Registry에 대한 액세스를 차단하는 경우 Container Registry 서비스를 VPC 서비스 제어의 서비스 경계에 추가해야 합니다. 서비스 경계의 작동 방식과 VPC 서비스 제어를 사용하여 보안을 유지하는 방법 자세히 알아보기

추가 문제해결

그래도 연결에 문제가 있는 경우 가상 머신의 콘솔 로그를 검토해 보세요. 이 로그는 메모장이 프록시 서비스에 등록할 수 없는 이유를 찾는 데 도움이 될 수 있습니다.

이 로그에 액세스하려면 다음 단계를 완료하세요.

  1. Google Cloud Console에서 AI Platform Notebooks 페이지로 이동합니다.

    AI Platform Notebooks 페이지로 이동

  2. 문제를 해결하려는 AI Platform Notebooks 인스턴스의 이름을 클릭합니다.

  3. 로그에서 직렬 포트 1(콘솔)을 클릭합니다.

다음 단계

다른 문제 해결에 대한 도움말은 메모장 문제해결을 참조하세요.