Notebooks API로 기존 인스턴스 등록

이 페이지에서는 Notebooks API로 기존 사용자 관리형 노트북 인스턴스를 마이그레이션하고 등록하는 방법을 보여줍니다. Compute Engine API를 사용하여 만든 인스턴스를 기존 인스턴스라고 합니다. 기존 인스턴스에는 기능에 대한 최신 업데이트가 적용되지 않습니다.

Notebooks API에서 제공되는 새로운 기능을 사용하려면 기존 인스턴스를 Notebooks API에 등록해야 합니다. 기존 인스턴스를 등록하기 전에 요구사항을 충족하는지 확인합니다. 요구사항을 충족하지 않는 인스턴스는 마이그레이션할 수 있습니다.

기존 인스턴스를 등록하기 전에 Notebooks API를 사용 설정하면 Notebooks API 활성화 프로세스가 자동으로 기존 인스턴스 등록을 시도합니다.

요구사항 및 제한사항

Notebooks API로 기존 인스턴스를 등록하기 전에 다음 요구사항 및 제한사항을 고려하세요.

  • 소스 영역과 대상 영역이 일치하고 Notebooks API에 유효한 영역이어야 합니다.

    예를 들어 us-west1-a의 기존 사용자 관리형 노트북 인스턴스는 Notebooks API에 등록되었을 때 us-west1-a에 남아 있습니다. 하지만 us-central1-f가 Notebooks API에 대해 유효한 영역이 아니므로 us-central1-f의 기존 사용자 관리형 노트북 인스턴스는 Notebooks API에 등록되지 않습니다.

    Notebooks API 노트북 인스턴스의 유효한 영역 목록을 가져오려면 원하는 터미널 또는 Cloud Shell에서 Google Cloud CLI를 사용하여 다음 명령어를 실행합니다.

    gcloud notebooks locations list

    기존 인스턴스의 영역이 Notebooks API의 유효한 영역이 아닌 경우 지원팀 또는 계정 관리자에게 문의하거나 기존 인스턴스를 새 사용자 관리형 노트북 인스턴스로 마이그레이션할 수 있습니다.

  • 이중 디스크 인스턴스만 모든 사용자 관리형 노트북 기능을 사용할 수 있습니다.

    단일 디스크 기존 인스턴스는 Notebooks API에 등록된 후에도 자동 업그레이드와 같은 일부 사용자 관리형 노트북 기능을 사용할 수 없습니다. 단일 디스크 기존 인스턴스에서 사용 가능한 모든 기능을 사용하려면 단일 디스크 인스턴스를 이중 디스크 인스턴스로 마이그레이션해야 합니다.

    기존 인스턴스에서 Notebooks API에 등록된 인스턴스로 마이그레이션하는 과정에서 단일 디스크 인스턴스를 이중 디스크 인스턴스로 마이그레이션할 수 있습니다. Notebooks API에 기존 인스턴스를 이미 등록한 경우에도 인스턴스를 새 이중 디스크 인스턴스로 마이그레이션하여 문제를 해결할 수 있습니다.

    디스크 수를 확인하려면 다음 단계를 완료하세요.

    콘솔

    1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

      VM 인스턴스로 이동

    2. 현재 기존 사용자 관리형 노트북 인스턴스를 찾습니다.

    3. 인스턴스 이름을 클릭하여 VM 인스턴스 세부정보 페이지를 엽니다.

    4. 부팅 디스크 및 추가 디스크 섹션에서 VM에 연결된 디스크 수를 확인합니다.

    gcloud

    1. Cloud Shell에서 또는 Google Cloud CLI가 설치된 환경에서 다음 Google Cloud CLI 명령어를 입력합니다.

      gcloud compute instances describe MY_INSTANCE_NAME \
    --zone=MY_ZONE

      다음을 바꿉니다.

      • MY_INSTANCE_NAME: 인스턴스의 이름
      • MY_ZONE: 인스턴스의 영역

    2. disks: 뒤에 오는 정보를 검토하고 VM에 연결된 디스크 수를 확인합니다.

기존 인스턴스를 새 사용자 관리형 노트북 인스턴스로 마이그레이션

기존 사용자 관리형 노트북 인스턴스가 Notebooks API의 유효한 영역이 아닌 영역에 있거나 단일 디스크 인스턴스에서 이중 디스크 인스턴스로 마이그레이션하려는 경우 사용자 관리형 노트북 인스턴스를 만들고 기존 인스턴스의 사용자 데이터를 새 인스턴스로 복사해야 합니다.

사용자 관리형 노트북 인스턴스를 만들고 기존 인스턴스에서 새 인스턴스로 사용자 데이터를 복사하려면 다음 단계를 완료하세요.

  1. ssh를 사용하여 기존 인스턴스에 연결하려면 Cloud Shell 또는 Google Cloud CLI가 설치된 환경에서 다음 Google Cloud CLI 명령어를 입력합니다.

    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

    다음을 바꿉니다.

    • MY_PROJECT_ID: Google Cloud 프로젝트의 ID
    • MY_ZONE: 인스턴스의 영역
    • MY_INSTANCE: 관련 정보가 있는 인스턴스의 이름

  2. 기존 인스턴스의 콘텐츠를 Cloud Storage 버킷에 복사하려면 gcloud storage을 사용합니다. 다음 예시 명령어는 모든 노트북(.ipynb) 파일을 기본 디렉터리 /home/jupyter/에서 my-bucket/legacy-notebooks라는 Cloud Storage 디렉터리로 복사합니다.

    gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive

  3. 기존 인스턴스와 동일한 하드웨어 사양으로 사용자 관리형 노트북 인스턴스를 만듭니다. Google Cloud CLI 또는 Google Cloud 콘솔을 사용하여 인스턴스를 만들 수 있습니다.

    이 예시에서 Vertex AI Workbench는 us-west1-a 영역에 n1-standard-1 머신 유형으로 최신 TensorFlow 2 이미지를 사용하여 example 프로젝트에 new-notebook이라는 사용자 관리형 노트북 인스턴스를 만듭니다.

    Cloud Shell에서 또는 Google Cloud CLI가 설치된 환경에서 다음 Google Cloud CLI 명령어를 입력합니다.

    gcloud notebooks instances create new-notebook \
    --vm-image-project=example \
    --vm-image-family=tf-latest-cpu \
    --machine-type=n1-standard-1 \
    --location=us-west1-a

    새 사용자 관리형 노트북 인스턴스는 이중 디스크입니다. 부팅 디스크 하나와 데이터 디스크 하나가 있습니다.

  4. 방금 만든 사용자 관리형 노트북 인스턴스에 ssh를 사용하여 연결합니다.

  5. gcloud storage을 사용하여 기존 인스턴스의 콘텐츠를 Cloud Storage 버킷에서 새 인스턴스로 복사합니다. 다음 예시 명령어는 모든 노트북(.ipynb) 파일을 Cloud Storage 디렉터리에서 새 인스턴스의 /home/jupyter/ 디렉터리로 복사합니다.

    gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive

  6. 새 사용자 관리형 노트북 인스턴스에서 JupyterLab을 열고 사용자 데이터와 애셋이 복사되었는지 확인합니다.

  7. 선택사항: 기존 인스턴스를 삭제합니다.

Notebooks API로 기존 인스턴스 등록

Notebooks API를 사용하여 기존 인스턴스를 관리하려면 Notebooks API로 기존 인스턴스를 등록해야 합니다.

기존 인스턴스를 등록하기 전에 Notebooks API를 사용 설정하면 Notebooks API 활성화 프로세스가 자동으로 기존 인스턴스 등록을 시도합니다. Notebooks API가 사용 설정된 후 기존 인스턴스를 만드는 경우 다음 방법 중 하나를 사용하여 수동으로 기존 인스턴스를 등록해야 합니다.

Notebooks API에 기존 인스턴스를 등록하려면 Google Cloud 콘솔 또는 Notebooks API를 사용할 수 있습니다.

콘솔

Google Cloud 콘솔에서 모두 등록 옵션을 사용하려면 다음 단계를 완료하세요.

  1. Google Cloud Console에서 사용자 관리형 노트북 페이지로 이동합니다.

    사용자 관리형 노트북으로 이동

  2. 기존 사용자 관리형 노트북 인스턴스가 하나 이상 있는 경우 Notebooks API에 등록해야 한다는 메시지가 표시됩니다. 이 메시지 옆에 있는 모두 등록을 클릭합니다.

  3. 기존 사용자 관리형 노트북 인스턴스가 없지만 아직 Notebooks API를 사용 설정하지 않았다면 Notebooks API 사용 설정을 클릭하여 Notebooks API를 사용하여 새 사용자 관리형 노트북 인스턴스를 만들 수 있도록 합니다.

Notebooks API

Notebooks API, Cloud Shell 또는 Google Cloud CLI가 설치된 환경에서 제공하는 register 메서드를 사용하려면 다음 Google Cloud CLI 명령어를 입력합니다.

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

다음을 바꿉니다.

  • MY_INSTANCE_NAME: 인스턴스의 이름
  • MY_ZONE: 인스턴스의 영역

다음 단계