Colab Enterprise에서 런타임 만들기

이 페이지에서는 Vertex AI에서 런타임을 만들고, 시작하고, 삭제하는 방법을 보여줍니다.

런타임에서 기본 구성과 다른 구성을 사용하는 코드를 실행하는 런타임을 만들 수 있습니다. 런타임은 머신 유형 및 디스크 크기와 같은 사양이 포함된 런타임 템플릿을 기반으로 생성됩니다.

런타임에 대한 자세한 내용은 런타임 및 런타임 템플릿을 참고하세요.

시작하기 전에

1. 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.

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

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

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

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

필요한 역할

Colab Enterprise에서 런타임을 만드는 데 필요한 권한이 사용자 계정에 있는지 확인하려면 관리자에게 사용자 계정에 프로젝트에 대한 Colab Enterprise 관리자(roles/aiplatform.colabEnterpriseAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

런타임 만들기

런타임을 만들려면 Google Cloud 콘솔 또는 Google Cloud CLI를 사용합니다.

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

런타임 시작

런타임을 시작하려면 Google Cloud 콘솔 또는 gcloud CLI를 사용하면 됩니다.

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

런타임 삭제

런타임을 삭제하려면 Google Cloud 콘솔 또는 gcloud CLI를 사용하세요.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

문제 해결

이 섹션에서는 Colab Enterprise에서 런타임을 만들 때 발생하는 문제를 해결하는 방법을 설명합니다.

런타임을 만들 수 없음

이 문제는 런타임을 만들 수 없는 경우에 발생합니다. 기본 런타임을 만들 수 없음도 참고하세요. 가장 일반적인 원인은 다음과 같습니다.

할당량 부족

런타임을 만들 수 없다면 Compute Engine 런타임 할당량을 초과했을 수 있습니다.

Colab Enterprise는 런타임에 Compute Engine 할당량을 사용합니다. 자세한 내용은 Compute Engine 할당량 및 한도 개요를 참조하세요.

이 문제를 해결하려면 할당량 한도 상향을 요청하세요.

사용 불가 리소스

런타임을 만들려고 하면 다음 오류가 발생합니다.

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

이 오류는 노트북의 리전에 머신 유형 구성에 사용할 수 있는 리소스가 없는 경우에 발생합니다.

이 문제를 해결하려면 다른 머신 유형 구성으로 런타임을 사용해 보거나 나중에 다시 시도해 보세요.

기본 런타임이 이미 존재함

기본 런타임이 이미 있는 경우 기본 런타임 템플릿에서 런타임을 만들려고 하면 다음 오류가 발생합니다.

Failed to create runtime

One click runtime already exists.

기본 런타임 템플릿에서 런타임을 만들려고 하면 Colab Enterprise에서 기본 런타임을 만들려고 시도합니다. 사용자, 프로젝트, 리전당 기본 런타임은 하나만 있을 수 있습니다. 기본 런타임이 이미 있는 경우 Colab Enterprise에서는 다른 기본 런타임을 만들 수 없습니다.

이 문제를 해결하려면 기존 기본 런타임에 연결하거나 기본이 아닌 런타임 템플릿에서 런타임을 만드세요.

기본 런타임을 만들 수 없음

Colab Enterprise는 기본 런타임을 만들 때 먼저 기본 런타임을 생성하는 데 사용하는 기본 런타임 템플릿을 만듭니다. 런타임 템플릿을 만드는 데 필요한 권한이 없이 기본 런타임을 만들려고 하면 Colab Enterprise에서 기본 런타임을 만들 수 없습니다.

이 문제를 해결하려면 관리자에게 aiplatform.notebookRuntimeTemplates.create 권한이 포함된 역할을 부여해 달라고 요청하세요.

다음 단계

• 런타임 및 런타임 템플릿을 자세히 알아봅니다.
• 런타임에 연결합니다.
• 런타임 템플릿 생성 방법을 알아봅니다.