사용자 관리형 노트북 인스턴스의 환경 업그레이드

Vertex AI Workbench 사용자 관리형 노트북 인스턴스는 JupyterLab 노트북 환경이 사용 설정되고 바로 사용할 수 있는 Deep Learning VM Image 인스턴스입니다. 이 페이지에서는 사용자 관리형 노트북 인스턴스의 환경을 업그레이드하는 방법을 설명합니다.

업그레이드 이유

다음과 같은 이유로 사용자 관리형 노트북 인스턴스 환경을 업그레이드할 수 있습니다.

최신 버전의 환경에서만 사용할 수 있는 새 기능을 사용하기 위해 업그레이드합니다.
최신 버전의 환경에서 구현된 프레임워크 업데이트, 패키지 업데이트, 버그 수정의 혜택을 얻기 위해 업그레이드합니다.

업그레이드 방법

사용자 관리형 노트북 인스턴스를 업그레이드하는 방법에는 두 가지가 있습니다.

자동 업그레이드: 사용자 관리형 노트북 인스턴스를 만들 때 자동 업그레이드를 사용 설정합니다. 지정한 반복 기간 동안 Vertex AI Workbench는 인스턴스 업그레이드 가능 여부를 확인하고, 가능한 경우 인스턴스를 업그레이드합니다.
수동 업그레이드: 기존 사용자 관리형 노트북 인스턴스가 업그레이드 요구사항을 충족하면 인스턴스를 수동으로 업그레이드할 수 있습니다.

요구사항 및 제한사항

사용자 관리형 노트북과의 이전 버전과 호환성은 보장되지 않습니다. 사용자 관리형 노트북 인스턴스를 업그레이드하기 전에 데이터 사본을 만듭니다.

특정 사용자 관리형 노트북 인스턴스를 업그레이드할 수 있는지 확인하려면 다음 요구사항 및 제한사항을 참조하세요.

Notebooks API가 인스턴스의 Google Cloud 프로젝트에서 사용 설정되어 있어야 합니다. 자세한 내용은 사용 설정된 서비스 나열 및 API 사용 설정을 참조하세요.
사용자 관리형 노트북 인스턴스의 환경 버전은 M54 이상이어야 합니다.
사용자 관리형 노트북 인스턴스는 Notebooks API를 사용하여 생성되었거나 Notebooks API에 등록되었어야 합니다.
사용자 관리형 노트북 인스턴스가 컨테이너 기반이면 Vertex AI Workbench에서 OS를 업그레이드합니다. 이미지 버전은 Dockerfile에서 가져오는 특정 이미지에 따라 달라집니다.

업그레이드에서 이미지의 최신 버전을 사용하게 하려면 Dockerfile에서 latest 태그를 사용하는 것이 좋습니다.

인스턴스 업그레이드를 사용할 수 없으면 데이터를 새 사용자 관리형 노트북 인스턴스로 마이그레이션하는 것이 좋습니다.

업그레이드 작동 방식

업그레이드할 수 있는 사용자 관리형 노트북 인스턴스는 부팅 디스크 1개와 데이터 디스크 1개가 있는 이중 디스크입니다. 업그레이드 프로세스는 데이터 디스크에 데이터를 보존하면서 부팅 디스크를 새 이미지로 업그레이드합니다.

업그레이드되거나 보존되는 구성요소는 무엇인가요?

다음 표에서는 업그레이드되는 사용자 관리형 노트북 인스턴스의 구성요소와 보존된 구성요소를 보여줍니다.

구성요소	업그레이드 결과
머신러닝 프레임워크	업그레이드됨
머신러닝 데이터	보존됨
사전 설치된 종속 항목	업그레이드됨
사용자가 설치한 라이브러리	기본적으로 다시 설치해야 함(사용자 설치 라이브러리 참조)
`/home/jupyter` 디렉터리의 로컬 파일	보존됨
다른 모든 `/home/` 디렉터리의 로컬 파일	보존되지 않음
사전 설치된 운영체제 패키지	업그레이드됨
사용자가 설치한 운영체제 패키지	보존되지 않음
GPU 드라이버	업그레이드됨
Notebooks	보존됨
사용자 구성	보존됨

사용자가 설치한 라이브러리

기본적으로 사용자 관리형 노트북 인스턴스는 부팅 디스크에 pip 및 Conda 라이브러리를 저장하며 이는 업그레이드 중에 교체됩니다. pip 라이브러리를 설치할 때 --user 플래그를 포함하여 /home/jupyter/ 디렉터리에 설치할 수 있습니다. 그러면 업그레이드 중에 보존됩니다.

기본적으로 커스텀 컨테이너로부터 생성된 커널에 pip 또는 Conda 라이브러리를 설치하면 커널이 실행되는 동안만 라이브러리가 지속됩니다. 커널을 다시 시작할 때마다 이러한 라이브러리를 다시 설치해야 합니다. 커스텀 컨테이너에 영구 라이브러리를 설치하려면 Dockerfile에 라이브러리 설치를 포함합니다. 커스텀 컨테이너에서 만든 커널에 pip 라이브러리를 설치할 때 --user 플래그를 포함하면 인스턴스가 다시 시작될 때까지 라이브러리가 지속되도록 할 수 있습니다.

환경 버전

Vertex AI Workbench는 정기적으로 환경을 업데이트하지만 (Deep Learning VM 출시 노트 참조), 각 출시 버전에서 모든 환경이 업데이트되는 것은 아닙니다. Vertex AI Workbench는 인스턴스의 기반이 되는 VM 이미지의 최신 환경 버전이 있는 경우에만 인스턴스를 업그레이드합니다.

특정 버전을 사용하여 사용자 관리형 노트북 인스턴스를 만드는 방법에 대한 자세한 내용은 사용자 관리형 노트북 인스턴스의 특정 버전 만들기를 참조하세요.

업그레이드하기 전에

업그레이드하기 전 다음 단계를 완료합니다.

최신 버전의 업데이트에 대해 알아보려면 출시 노트를 확인하세요.
백업으로 데이터 사본을 만듭니다.

자동 업그레이드

Vertex AI Workbench는 실행 중인 인스턴스를 자동으로 업그레이드할 수 있습니다. 인스턴스를 중지하면 인스턴스를 만들 때 자동 업그레이드를 사용 설정하더라도 인스턴스가 자동으로 업그레이드되지 않습니다.

자동 환경 업그레이드를 사용 설정하면 Vertex AI Workbench가 인스턴스를 업그레이드할 수 있는지 확인하고, 인스턴스를 업그레이드할 수 있는 경우 반복 기간을 지정합니다.

지정한 기간은 notebook-upgrade-schedule 메타데이터 항목으로, unix-cron 형식, 그리니치 표준시(GMT)로 저장됩니다.

Vertex AI Workbench는 인스턴스를 업그레이드할 수 있는지 확인하기 위해 API 메서드 isUpgradeable을 사용합니다. 이 메서드는 인스턴스의 부팅 디스크에 있는 최신 버전의 이미지를 확인합니다.

인스턴스를 업그레이드할 수 있으면 Vertex AI Workbench는 내부 업그레이드 메서드를 사용하여 인스턴스를 업그레이드합니다.

자동 업그레이드가 사용 설정된 사용자 관리형 노트북 인스턴스 만들기

자동 업그레이드가 사용 설정된 사용자 관리형 노트북 인스턴스를 만들려면 환경 자동 업그레이드 사용 설정 체크박스를 선택하고 인스턴스를 만들 때 일정을 설정합니다.

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 자동 업그레이드를 지정할 수 있습니다.

시작하기 전에

사용자 관리형 노트북 인스턴스를 만들려면 먼저 Google Cloud 프로젝트가 있고 이 프로젝트에 Notebooks API를 사용 설정해야 합니다.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Enable the Notebooks API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Enable the Notebooks API.

Enable the API

사용자 관리형 노트북 인스턴스에 GPU를 사용하려는 경우 Google Cloud 콘솔의 할당량 페이지를 확인하여 프로젝트에 사용 가능한 GPU가 충분히 있는지 확인하세요. GPU가 할당량 페이지에 나와 있지 않거나 추가 GPU 할당량이 필요한 경우 할당량 상향 조정을 요청하세요. Compute Engine 리소스 할당량 페이지의 추가 할당량 요청을 참조하세요.

필요한 역할

프로젝트를 만든 경우 프로젝트에 대한 소유자(roles/owner) IAM 역할이 있으며 이 역할에는 모든 필수 권한이 포함됩니다. 이 섹션을 건너뛰고 사용자 관리형 노트북 인스턴스를 만듭니다. 프로젝트를 직접 만들지 않았으면 이 섹션에서 계속 진행합니다.

사용자 계정에 Vertex AI Workbench 사용자 관리형 노트북 인스턴스를 만드는 데 필요한 권한이 있는지 확인하려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 사용자 계정에 부여해 달라고 요청하세요.

Notebooks 관리자(roles/notebooks.admin)
서비스 계정 사용자(roles/iam.serviceAccountUser)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

관리자는 커스텀 역할이나 다른 사전 정의된 역할을 통해 사용자 계정에 필요한 권한을 부여할 수도 있습니다.

인스턴스 만들기

콘솔

Google Cloud 콘솔에서 사용자 관리형 노트북 페이지로 이동합니다. 또는 notebook.new(https://notebook.new)로 이동하고 다음 단계로 건너뜁니다.

사용자 관리형 노트북으로 이동
새 노트북을 클릭한 후 맞춤설정을 선택합니다.
사용자 관리형 노트북 만들기 페이지의 세부정보 섹션에서 새 인스턴스에 대해 다음 정보를 제공하세요.
- 이름: 새 인스턴스 이름
- 리전 및 영역: 새 인스턴스의 리전 및 영역을 선택합니다. 최상의 네트워크 성능을 위해 지리적으로 가장 가까운 리전을 선택합니다. 사용 가능한 사용자 관리형 노트북 위치를 참조하세요.
시스템 상태 섹션에서 환경 자동 업그레이드를 선택합니다.
노트북을 주 단위 또는 월 단위로 업그레이드할지 선택합니다.
주중 필드에서 원하는 옵션을 선택합니다.
시간 필드에서 시간을 선택합니다.
인스턴스 만들기 대화상자의 나머지 부분을 완료한 후 만들기를 클릭합니다.

gcloud

Cloud Shell에서 또는 Google Cloud CLI가 설치된 환경에서 다음 Google Cloud CLI 명령어를 입력합니다.
```
gcloud notebooks instances create INSTANCE_NAME
    --metadata=notebook-upgrade-schedule=SCHEDULE
    --vm-image-project=deeplearning-platform-release
    --vm-image-family=VM_IMAGE_FAMILY
    --machine-type=MACHINE_TYPE
    --location=LOCATION
```
다음을 바꿉니다.
- INSTANCE_NAME: 새 인스턴스 이름
- SCHEDULE: unix-cron 형식으로 설정한 주별 또는 월별 일정입니다. 예를 들어 '00 19 * * MON'은 매주 월요일 그리니치 표준시(GMT) 기준 오후 7시를 의미합니다.
- VM_IMAGE_FAMILY: 인스턴스를 만드는 데 사용할 이미지 계열 이름
- MACHINE_TYPE: 인스턴스 VM의 머신 유형
- LOCATION: 새 인스턴스를 배치할 Google Cloud 위치
Google Cloud 콘솔에서 인스턴스에 액세스합니다.

자동 업그레이드 일정 수정

사용자 관리형 노트북 인스턴스를 만든 후 자동 업그레이드 일정을 수정하려면 다음 단계를 완료하세요.

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

사용자 관리형 노트북으로 이동
일정을 변경해야 하는 인스턴스 이름을 클릭합니다.
노트북 세부정보 페이지의 환경 자동 업그레이드 섹션에서 일정을 수정합니다.
제출을 클릭하여 변경사항을 저장합니다.

수동 업그레이드

요구사항을 충족하는 사용자 관리형 노트북 인스턴스를 수동으로 업그레이드할 수 있습니다.

인스턴스 환경의 최신 버전 확인

최신 버전의 인스턴스 환경 사용 여부를 확인하려면 Google Cloud 콘솔에서 인스턴스에 액세스합니다.

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

사용자 관리형 노트북으로 이동
인스턴스가 실행 중이 아니면 인스턴스를 시작합니다. Vertex AI Workbench는 실행 중일 때만 인스턴스를 업그레이드할 수 있습니다.
최신 환경 버전의 가용성을 확인할 인스턴스 이름을 클릭합니다.
노트북 세부정보 페이지에서 VM 세부정보 옆에 있는 Compute Engine에서 보기를 클릭합니다.

최신 버전의 환경을 사용할 수 있으면 '이 인스턴스를 업그레이드해야 합니다'라는 메시지가 표시됩니다.

인스턴스 환경을 최신 버전으로 업그레이드

Google Cloud 콘솔에서 또는 Google Cloud CLI를 사용하여 사용자 관리형 노트북 인스턴스를 수동으로 업그레이드할 수 있습니다.

콘솔

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

사용자 관리형 노트북으로 이동
인스턴스가 실행 중이 아니면 인스턴스를 시작합니다. Vertex AI Workbench는 실행 중일 때만 인스턴스를 업그레이드할 수 있습니다.
업그레이드하려는 인스턴스 이름을 클릭합니다.
노트북 세부정보 페이지에서 수정을 클릭합니다.
계속하기 전에 인스턴스의 데이터 사본을 만들었는지 확인합니다.
데이터가 백업되면 업그레이드를 클릭합니다. Vertex AI Workbench에서 인스턴스를 업그레이드하고 시작합니다.

gcloud

인스턴스를 업그레이드할 수 있는지 확인하려면 API 메서드 isUpgradeable을 사용합니다. 이 메서드는 인스턴스의 부팅 디스크에 있는 최신 버전의 이미지를 확인합니다.
```
gcloud notebooks instances is-upgradeable INSTANCE_NAME \
    --location=LOCATION
```
다음을 바꿉니다.
- INSTANCE_NAME: 인스턴스의 이름
- LOCATION인스턴스가 있는 Google Cloud 위치
인스턴스를 업그레이드할 수 있는 경우 응답은 true입니다. 인스턴스를 업그레이드할 수 없지만 데이터를 새 인스턴스로 마이그레이션하려고 시도할 수 있는 경우 응답은 false입니다.
인스턴스가 실행 중이 아니면 인스턴스를 시작합니다. Vertex AI Workbench는 실행 중일 때만 인스턴스를 업그레이드할 수 있습니다.
계속하기 전에 인스턴스의 데이터 사본을 만들었는지 확인합니다.
인스턴스를 업그레이드할 수 있는 경우 API 메서드 upgrade를 사용하여 인스턴스를 업그레이드합니다.
```
gcloud notebooks instances upgrade INSTANCE_NAME \
    --location=LOCATION
```
Vertex AI Workbench에서 인스턴스를 업그레이드합니다.

업그레이드 롤백

업그레이드를 롤백하려면 다음 단계를 완료합니다.

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

사용자 관리형 노트북으로 이동
롤백하려는 인스턴스 이름을 클릭합니다.
노트북 세부정보 페이지의 업그레이드 기록에서 롤백을 클릭합니다.
Vertex AI Workbench가 인스턴스를 이전 버전으로 롤백합니다.