이 페이지는 Cloud Translation API를 통해 번역되었습니다.

런타임 및 런타임 템플릿

이 페이지에서는 Colab Enterprise의 런타임과 런타임 템플릿을 설명합니다.

런타임은 노트북 (IPYNB 파일)에서 코드를 실행할 수 있는 Google 프로비저닝 가상 머신 (VM)입니다.

런타임 템플릿은 머신 유형, VM의 기타 특성, 네트워크, 공개 인터넷 액세스 사용 설정 여부와 같은 공통 설정을 지정하는 VM 구성입니다. 런타임을 만들면 런타임 템플릿의 사양에 따라 VM이 생성됩니다.

워크플로

Colab Enterprise 노트북을 만들면 런타임에 대해 이해하지 않아도 코드를 실행할 수 있습니다. 코드를 처음 실행하면 Colab Enterprise에서 기본 런타임을 프로비저닝하고 코드를 실행합니다. 다른 런타임에 연결할 때까지 Colab Enterprise는 기본 런타임을 계속 사용합니다.

특정 요구사항에 적합한 런타임을 구성하기 위해 수행해야 할 작업을 선택하세요.

필요한 구성으로 런타임 템플릿을 만듭니다.
해당 템플릿을 기반으로 런타임을 만듭니다.
노트북에서 런타임에 연결하고 코드를 실행합니다.

런타임

이 섹션에서는 런타임의 특징을 설명합니다.

기본 런타임

런타임을 만들지 않으면 코드를 처음 실행하거나 기본 런타임에 연결할 때 액셀러레이터가 없는 런타임이 생성됩니다. 가속기 없이 기본 런타임을 사용하거나 가속기가 포함된 기본 런타임으로 전환할 수 있습니다.

Colab Enterprise는 기본 런타임을 만들 때 먼저 해당 기본 런타임 템플릿을 만듭니다. 런타임과 런타임 템플릿은 모두 Google Cloud 콘솔에 표시되며, 여기에서 관련 정보를 확인할 수 있습니다.

액셀러레이터 없이 기본 런타임을 사용하는 경우 Colab Enterprise는 프로젝트별, 리전별로 액셀러레이터가 없는 기본 런타임 하나와 해당 런타임 템플릿을 만듭니다.

액셀러레이터가 있는 기본 런타임을 사용하는 경우 Colab Enterprise는 프로젝트별, 리전별로 액셀러레이터가 있는 기본 런타임과 해당 런타임 템플릿을 하나씩 만듭니다.

기본 런타임 사양

기본 런타임과 해당 기본 런타임 템플릿에는 다음 사양이 포함됩니다.

사양	기본값	GPU 기본값
Python 버전	사용 가능한 최신 버전 (현재 Python 3.12)	사용 가능한 최신 버전 (현재 Python 3.12)
머신 유형	`e2-standard-4`	지역에 따라 다릅니다. 사양을 참고하세요.
가속기	없음	지역에 따라 다릅니다. 사양을 참고하세요.
부팅 디스크	100GiB SSD 영구 디스크 (`pd-ssd`)	100GiB SSD 영구 디스크 (`pd-ssd`)
데이터 디스크	100GiB 표준 영구 디스크 (`pd-standard`)	지역에 따라 다릅니다. 사양을 참고하세요.
유휴 상태 종료	사용 설정됨, 180분으로 설정됨	사용 설정됨, 180분으로 설정됨
네트워크	프로젝트의 기본 Virtual Private Cloud 네트워크	프로젝트의 기본 Virtual Private Cloud 네트워크
공개 인터넷 액세스	사용 설정됨	사용 설정됨
최종 사용자 인증 정보 인증	사용 설정됨	사용 설정됨
자동 삭제	생성 후 18시간이 지나면 자동 삭제	생성 후 18시간이 지나면 자동 삭제

Python 버전

2025년 5월부터 Colab Enterprise에서 기본 런타임 템플릿을 만들면 기본 런타임 템플릿이 최신 버전의 Python (현재 Python 3.12)을 사용하도록 구성됩니다. 즉, Colab Enterprise에서 새 버전의 Python을 사용할 수 있게 되면 기본 런타임 템플릿에서 생성된 새 런타임은 최신 Python 버전을 사용합니다.

기본 런타임 템플릿이 2025년 5월 이전에 생성된 경우 Python 3.10을 사용하도록 구성되어 있을 수 있습니다. 최신 Python 버전을 사용하도록 기본 런타임 템플릿을 업데이트하려면 기본 런타임 템플릿을 삭제해야 합니다. 그러면 새 기본 런타임 템플릿이 생성될 때 최신 Python 버전을 사용하도록 구성됩니다.

생성한 런타임 템플릿의 Python 버전을 업데이트하려면 런타임 템플릿의 Python 버전 변경을 참고하세요.

Colab Enterprise에서 새 Python 버전을 사용할 수 있는 경우에도 기존 런타임의 Python 버전은 자동으로 변경되지 않습니다. 기존 런타임의 Python 버전 변경은 지원되지 않습니다. 대신 원하는 Python 버전을 사용하는 런타임 템플릿에서 파생된 새 런타임을 만들어야 합니다.

런타임 템플릿의 Python 버전 변경

런타임 템플릿의 Python 버전을 변경하려면 REST API를 사용하면 됩니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

REGION: 런타임 템플릿이 있는 리전입니다.
PROJECT_ID: 프로젝트 ID입니다.
NOTEBOOK_RUNTIME_TEMPLATE_ID: 런타임 템플릿의 ID입니다.
RELEASE_NAME: 사용할 이미지의 출시 이름입니다. 예를 들어 py311은 Python 3.11 이미지의 출시 버전 이름입니다. 이미지를 Latest로 설정하려면 RELEASE_NAME을 비워 둡니다.

HTTP 메서드 및 URL:

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

JSON 요청 본문:

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content

요청이 성공하면 응답 본문에 Operation의 인스턴스가 포함됩니다.

자세한 내용은notebookRuntimeTemplates.patch REST API 문서를 참조하세요.

런타임은 리전별로 제공됩니다.

런타임은 리전별로 제공되며 노트북과 동일한 리전에 있어야 합니다.

런타임은 사용자에게만 제공됩니다.

런타임은 사용자마다 고유합니다. 런타임을 다른 사용자와 공유할 수 없으며 다른 사용자의 런타임을 사용할 수 없습니다. 다른 사용자와 노트북을 공유하더라도 해당 사용자는 내 런타임에 액세스할 수 없으며 자신의 런타임에서 노트북을 실행해야 합니다.

하지만 사용자는 동일한 런타임 템플릿을 기반으로 자체 런타임을 만들 수 있습니다. 런타임 템플릿을 사용자와 공유할 수 있음을 참고하세요.

런타임 파일 관리

Colab Enterprise에서 파일 버튼을 사용하여 런타임의 파일에 액세스하고 수정할 수 있습니다. 런타임에 파일을 업로드할 수도 있습니다.

런타임이 삭제되면 업로드한 파일이 삭제됩니다. 파일을 수정한 경우 새 런타임이 생성되면 파일이 원래 상태로 되돌아갑니다. 기본 런타임 사양 섹션에서 자동 삭제 기간을 확인합니다.

런타임은 노트북에서 공유할 수 있습니다.

동일한 런타임에 두 개 이상의 노트북을 연결할 수 있지만 권장되지는 않습니다. 동일한 런타임을 공유하는 여러 노트북으로 인해 다음과 같은 문제가 발생할 수 있습니다.

런타임의 컴퓨팅 리소스를 공유하므로 노트북이 느리게 실행될 수 있습니다.
한 노트북의 코드는 다른 노트북의 런타임 VM 상태에 영향을 줄 수 있습니다. 예를 들어 한 노트북에 패키지 버전 1.3을 설치했지만 다른 노트북에 버전 1.2가 필요한 경우 두 번째 노트북을 실행할 때 버전 비호환 문제가 발생할 수 있습니다.

동일한 런타임에서 여러 노트북의 코드를 실행하는 대신 동일한 런타임 템플릿을 기반으로 각 노트북의 런타임을 만들 수 있습니다. 동일한 런타임 템플릿에서 여러 런타임을 만들 수 있습니다를 참고하세요.

런타임 요금

사용하는 머신 유형과 가속기에 따라 런타임 처리 요금이 청구됩니다. 부팅 디스크 및 데이터 디스크 스토리지에 대한 요금도 청구됩니다. 런타임이 삭제되면 부팅 디스크와 데이터 디스크가 삭제됩니다.

런타임에는 항상 런타임 템플릿에 지정된 데이터 디스크 외에도 100GiB SSD 영구 디스크가 포함됩니다. 부팅 디스크는 구성할 수 없습니다.

런타임이 종료되는 동안에는 다음이 적용됩니다.

CPU 또는 GPU 사용량이 없으므로 컴퓨팅 요금이 발생하지 않습니다.
부팅 디스크 및 데이터 디스크 스토리지는 요금이 청구됩니다.

자세한 내용은 Colab Enterprise 가격 책정을 참고하세요.

동일한 런타임 템플릿에서 여러 런타임을 만들 수 있습니다.

기본이 아닌 단일 런타임 템플릿에서 여러 런타임을 만들 수 있습니다. 이렇게 하면 해당 VM의 리소스를 공유하지 않고도 동일한 구성의 VM에서 여러 노트북을 실행할 수 있습니다.

런타임 템플릿

이 섹션에서는 런타임 템플릿의 특징을 설명합니다.

런타임 템플릿은 리전별입니다.

런타임 템플릿은 리전별 리소스입니다. 런타임을 만들면 런타임 템플릿과 동일한 리전에 있으며 해당 리전의 노트북에서만 런타임을 사용할 수 있습니다.

런타임 템플릿을 다른 사용자와 공유할 수 있습니다. 이렇게 하면 각 사용자가 동일한 런타임 템플릿을 기반으로 자체 런타임을 만들 수 있으므로 여러 사용자가 동일한 VM 구성에서 동일한 노트북을 실행할 수 있습니다.

자세한 내용은 런타임 템플릿에 대한 액세스 관리를 참고하세요.

구성

런타임 템플릿은 런타임 VM의 구성을 결정합니다. 다음 중 하나를 지정할 수 있습니다.

리전

노트북이 있는 리전을 선택합니다. 런타임 템플릿에서 생성된 런타임은 런타임 템플릿과 동일한 리전에 있습니다. 노트북이 런타임에서 코드를 실행하려면 노트북과 런타임이 동일한 리전에 있어야 합니다.

머신 유형

런타임 템플릿의 머신 유형을 구성할 수 있습니다. 머신 유형에 대한 자세한 내용은 머신 계열 리소스 및 비교 가이드를 참고하세요.

데이터 디스크

런타임 템플릿에서 데이터 디스크의 디스크 유형과 디스크 크기를 구성할 수 있습니다.

런타임이 생성되면 부팅 디스크도 포함됩니다. 부팅 디스크는 100GiB SSD 영구 디스크이며 구성할 수 없습니다.

가속기

런타임 템플릿 구성에 가속기를 추가할 수 있습니다. 가속기 가용성은 머신 유형과 리전을 기반으로 합니다.

네트워크

네트워크를 지정하거나 프로젝트의 기본 가상 프라이빗 클라우드(VPC) 네트워크를 사용합니다.

유휴 상태 종료

Colab Enterprise는 기본적으로 유휴 상태 종료를 사용 설정합니다. 이 설정은 180분 동안 비활성 상태가 되면 인스턴스를 종료합니다. 종료 전 비활성 시간(분)을 변경하거나 유휴 상태 종료를 사용 중지할 수 있습니다.

공개 인터넷 액세스

노트북 및 기타 리소스의 보안을 더 세부적으로 관리하려면 공개 인터넷 액세스를 사용 중지하면 됩니다. 이 방식으로 런타임 템플릿을 구성하면 런타임 템플릿에서 생성된 런타임을 사용하는 노트북이 공개 인터넷에 액세스할 수 없습니다.

최종 사용자 인증 정보 인증

기본적으로 런타임 템플릿은 최종 사용자 인증 정보 인증을 사용하여 노트북에 애플리케이션 기본 사용자 인증 정보 (ADC)에 대한 액세스 권한을 부여합니다. 이 ADC 액세스 권한을 사용하여 Vertex AI 및 기타 Google Cloud 서비스와 상호작용하는 노트북에서 코드를 실행할 수 있습니다. 최종 사용자 인증 정보가 사용 설정되면 노트북은 노트북을 실행하는 사용자의 인증 정보를 사용하여 Google Cloud 리소스에 대한 액세스를 결정합니다.

최종 사용자 인증 정보가 사용 설정되지 않은 경우 노트북의 코드를 통해 사용자를 인증하여 ADC에 액세스할 수 있습니다. 자세한 내용은 로컬 개발 환경의 ADC 설정의 '사용자 인증 정보' 섹션을 참고하세요.

런타임 템플릿 요금

런타임 템플릿을 만들거나 저장하는 데는 비용이 청구되지 않습니다. 런타임 요금도 참고하세요.