인스턴스 환경 업그레이드

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

업그레이드 이유

다음과 같은 이유로 Vertex AI Workbench 인스턴스 환경을 업그레이드할 수 있습니다.

  • 최신 버전의 환경에서만 사용할 수 있는 새 기능을 사용하기 위해 업그레이드합니다.

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

업그레이드 방법

Vertex AI Workbench 인스턴스를 업그레이드하는 방법에는 두 가지가 있습니다.

  • 자동 업그레이드: Vertex AI Workbench 인스턴스를 만들 때 자동 업그레이드를 사용 설정합니다. 지정한 반복 기간 동안 Vertex AI Workbench는 인스턴스 업그레이드 가능 여부를 확인하고, 가능한 경우 인스턴스를 업그레이드합니다.

  • 수동 업그레이드: 기존 Vertex AI Workbench 인스턴스가 업그레이드 요구사항을 충족하면 인스턴스를 수동으로 업그레이드할 수 있습니다.

요구사항 및 제한사항

Vertex AI Workbench와의 이전 버전과 호환성은 보장되지 않습니다. Vertex AI Workbench 인스턴스를 업그레이드하기 전에 데이터 사본을 만듭니다.

특정 Vertex AI Workbench 인스턴스를 업그레이드할 수 있는지 확인하려면 다음 요구사항 및 제한사항을 참조하세요.

  • Notebooks API가 인스턴스의 Google Cloud 프로젝트에서 사용 설정되어 있어야 합니다. 자세한 내용은 사용 설정된 서비스 나열 및 API 사용 설정을 참조하세요.

  • Vertex AI Workbench 인스턴스가 컨테이너 기반이면 Vertex AI Workbench에서 OS를 업그레이드합니다. 이미지 버전은 Dockerfile에서 가져오는 특정 이미지에 따라 달라집니다.

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

인스턴스 업그레이드를 사용할 수 없으면 데이터를 새 Vertex AI Workbench 인스턴스로 마이그레이션하는 것이 좋습니다.

업그레이드 작동 방식

업그레이드할 수 있는 Vertex AI Workbench 인스턴스는 부팅 디스크 1개와 데이터 디스크 1개가 있는 이중 디스크입니다. 업그레이드 프로세스는 데이터 디스크에 데이터를 보존하면서 부팅 디스크를 새 이미지로 업그레이드합니다.

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

다음 표에서는 업그레이드되고 보존되는 Vertex AI Workbench 인스턴스의 구성요소를 보여줍니다.

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

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

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

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

환경 버전

Vertex AI Workbench 인스턴스에는 확인할 수 있는 환경 버전 번호가 있습니다.

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

    인스턴스로 이동

  2. 인스턴스 목록의 버전 열에서 인스턴스 환경의 버전 번호를 찾습니다.

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

특정 버전을 사용하여 Vertex AI Workbench 인스턴스를 만드는 방법에 대한 자세한 내용은 Vertex AI Workbench 인스턴스의 특정 버전 만들기를 참조하세요.

시작하기 전에

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

  1. 최신 버전의 업데이트에 대해 알아보려면 출시 노트를 확인하세요.

  2. 백업으로 데이터 사본을 만듭니다.

자동 업그레이드

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

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

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

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

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

자동 업그레이드를 사용 설정해서 Vertex AI Workbench 인스턴스 만들기

자동 업그레이드를 사용 설정해서 Vertex AI Workbench 인스턴스를 만들려면 환경 자동 업그레이드 사용 설정 체크박스를 선택하고 인스턴스를 만들 때 일정을 설정합니다.

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

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

    인스턴스로 이동

  2. 새로 만들기를 클릭합니다.

  3. 새 인스턴스 대화상자에서 고급 옵션을 클릭합니다.

  4. 인스턴스 만들기 대화상자의 세부정보 섹션에서 새 인스턴스에 대해 다음 정보를 제공합니다.

    • 이름: 새 인스턴스 이름을 입력합니다.
    • 리전 및 영역: 새 인스턴스의 리전 및 영역을 선택합니다. 최상의 네트워크 성능을 위해 지리적으로 가장 가까운 리전을 선택합니다. 사용 가능한 Vertex AI Workbench 위치를 참조하세요.

  5. 시스템 상태 섹션에서 환경 자동 업그레이드를 선택합니다.

  6. 노트북을 주 단위 또는 월 단위로 업그레이드할지 선택합니다.

  7. 주중 필드에서 원하는 옵션을 선택합니다.

  8. 시간 필드에서 시간을 선택합니다.

  9. 인스턴스 만들기 대화상자의 나머지 부분을 완료한 후 만들기를 클릭합니다.

자동 업그레이드 일정 수정

Vertex AI Workbench 인스턴스를 만든 후 자동 업그레이드 일정을 수정하려면 다음 단계를 완료하세요.

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

    인스턴스로 이동

  2. 일정을 변경해야 하는 인스턴스 이름을 클릭합니다.

  3. 인스턴스 세부정보 페이지의 환경 자동 업그레이드 섹션에서 일정을 수정합니다.

  4. 제출을 클릭하여 변경사항을 저장합니다.

수동 업그레이드

요구사항을 충족하는 Vertex AI Workbench 인스턴스를 수동으로 업그레이드할 수 있습니다.

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

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

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

    인스턴스로 이동

  2. 최신 환경 버전의 가용성을 확인할 인스턴스 이름을 클릭합니다.

  3. 인스턴스 세부정보 페이지에서 VM 세부정보 옆에 있는 Compute Engine에서 보기를 클릭합니다.

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

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

Google Cloud 콘솔에서 Vertex AI Workbench 인스턴스를 수동으로 업그레이드할 수 있습니다.

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

    인스턴스로 이동

  2. 인스턴스가 실행 중이 아니면 인스턴스를 시작합니다. Vertex AI Workbench는 실행 중일 때만 인스턴스를 업그레이드할 수 있습니다.

  3. 업그레이드하려는 인스턴스 이름을 클릭합니다.

  4. 인스턴스 세부정보 페이지에서  업그레이드를 클릭합니다.

  5. 계속하기 전에 인스턴스의 데이터 사본을 만들었는지 확인합니다.

  6. 데이터가 백업되면 업그레이드를 클릭합니다. Vertex AI Workbench에서 인스턴스를 업그레이드하고 시작합니다.

업그레이드 롤백

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

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

    인스턴스로 이동

  2. 롤백하려는 인스턴스 이름을 클릭합니다.

  3. 인스턴스 세부정보 페이지의 업그레이드 기록에서 롤백을 클릭합니다.

  4. Vertex AI Workbench가 인스턴스를 이전 버전으로 롤백합니다.