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

런타임 및 런타임 템플릿

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

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

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

워크플로

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

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

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

런타임

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

기본 런타임

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

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

가속기를 사용하지 않고 기본 런타임을 사용하는 경우 Colab Enterprise는 프로젝트 및 리전별로 가속기 없이 기본 런타임 1개와 해당하는 런타임 템플릿 1개를 만듭니다.

가속기를 사용하여 기본 런타임을 사용하는 경우 Colab Enterprise는 프로젝트 및 리전별로 가속기와 해당 런타임 템플릿이 포함된 기본 런타임 하나를 만듭니다.

기본 런타임 사양

기본 런타임 및 이에 상응하는 기본 런타임 템플릿에는 다음 사양이 포함됩니다.

사양	기본값	GPU가 포함된 기본값
Python 버전	사용 가능한 최신 버전 (현재 Python 3.11)	사용 가능한 최신 버전 (현재 Python 3.11)
머신 유형	`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.11)을 사용하도록 구성됩니다. 즉, 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 영구 디스크이며 구성할 수 없습니다.

가속기

런타임 템플릿 구성에 가속기를 추가할 수 있습니다. 가속기 사용 가능 여부는 머신 유형 및 리전에 따라 다릅니다.

네트워크

네트워크를 지정하거나 프로젝트의 기본 Virtual Private Cloud 네트워크를 사용합니다.

유휴 상태 종료

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

공개 인터넷 액세스

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

최종 사용자 인증 정보 인증

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

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

런타임 템플릿 요금

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