Membuat runtime

Halaman ini menjelaskan cara membuat, memulai, dan menghapus runtime di Colab Enterprise.

Anda dapat membuat runtime untuk menjalankan kode pada runtime yang memiliki konfigurasi berbeda dengan default-nya. Runtime dibuat berdasarkan template runtime, yang mencakup spesifikasi seperti jenis mesin dan ukuran disk.

Untuk mempelajari runtime lebih lanjut, lihat Runtime dan template runtime.

Sebelum memulai

Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat runtime di Colab Enterprise, minta administrator untuk memberi Anda peran IAM Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) di project tersebut. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Satu atau beberapa peran yang diperlukan mencakup izin dataform.repositories.list. Pengguna yang diberi izin dataform.repositories.list atau peran Code Creator (roles/dataform.codeCreator) dalam suatu project dapat mencantumkan nama aset kode dalam project tersebut menggunakan Dataform API atau antarmuka command line (CLI) Dataform. Pengguna non-administrator yang menggunakan BigQuery Studio hanya dapat melihat aset kode yang mereka buat atau yang dibagikan kepada mereka.

Membuat runtime

Untuk membuat runtime, Anda dapat menggunakan Google Cloud konsol, Google Cloud CLI, atau Terraform.

Konsol

Untuk membuat runtime:

Di Google Cloud konsol, buka halaman Runtimes Colab Enterprise.

Buka Runtime
Di menu Region, pilih region tempat Anda ingin menjalankan runtime. Region ini harus sama dengan region notebook yang menggunakannya.
Klik Create.

Dialog Create Vertex AI runtime akan muncul.
Di menu Runtime template, pilih template runtime. Jika tidak ada template runtime yang tercantum, buat template runtime terlebih dahulu.
Di kolom Runtime name, masukkan nama untuk runtime Anda.
Klik Create.

Secara default, saat Anda membuat runtime, Anda otomatis memiliki izin yang diperlukan untuk memulai dan menghapus runtime tersebut.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

DISPLAY_NAME: nama tampilan untuk runtime Anda.
RUNTIME_TEMPLATE_ID: ID template runtime. Template runtime menentukan konfigurasi komputasi runtime Anda.
PROJECT_ID: project ID Anda.
REGION: region tempat Anda ingin menjalankan runtime.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Secara default, saat Anda membuat runtime, Anda otomatis memiliki izin yang diperlukan untuk memulai dan menghapus runtime tersebut.

Untuk mengetahui informasi selengkapnya tentang perintah untuk membuat template runtime dari command line, lihat dokumentasi gcloud CLI.

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat Terraform dokumentasi referensi penyedia.

Contoh berikut menggunakan resource Terraform untuk membuat runtime Colab Enterprise. google_colab_runtime

resource "google_colab_runtime_template" "my_template" {
  name        = "{{index $.Vars "runtime_name"}}"
  display_name = "Runtime template full"
  location    = "us-central1"
  description = "Full runtime template"
  machine_spec {
    machine_type     = "n1-standard-2"
    accelerator_type = "NVIDIA_TESLA_T4"
    accelerator_count = "1"
  }

  data_persistent_disk_spec {
    disk_type    = "pd-standard"
    disk_size_gb = 200
  }

  network_spec {
    enable_internet_access = true
  }

  labels = {
    k = "val"
  }

  idle_shutdown_config {
    idle_timeout = "3600s"
  }

  euc_config {
    euc_disabled = true
  }

  shielded_vm_config {
    enable_secure_boot = true
  }

  network_tags = ["abc", "def"]

  encryption_spec {
    kms_key_name = "{{index $.Vars "key_name"}}"
  }
}

resource "google_colab_runtime" "{{$.PrimaryResourceId}}" {
  name = "{{index $.Vars "runtime_name"}}"
  location = "us-central1" 

  notebook_runtime_template_ref {
    notebook_runtime_template = google_colab_runtime_template.my_template.id
  }

  display_name = "Runtime full"
  runtime_user = "gterraformtestuser@gmail.com"
  description = "Full runtime"

  desired_state = "ACTIVE"

  auto_upgrade = true

  depends_on = [
    google_colab_runtime_template.my_template
  ]
}

Memecahkan masalah

Bagian ini menjelaskan cara menyelesaikan masalah terkait pembuatan runtime di Colab Enterprise.

Tidak dapat membuat runtime

Masalah ini terjadi saat Anda tidak dapat membuat runtime. Lihat juga Tidak dapat membuat runtime default. Penyebab yang paling umum adalah:

Kuota tidak mencukupi

Jika tidak dapat membuat runtime, Anda mungkin telah melampaui kuota runtime Compute Engine.

Colab Enterprise menggunakan kuota Compute Engine untuk runtime. Untuk informasi selengkapnya, lihat ringkasan kuota dan batas Compute Engine overview.

Untuk mengatasi masalah ini, Minta penyesuaian kuota.

Resource tidak tersedia

Error berikut terjadi saat Anda mencoba membuat runtime.

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

Error ini terjadi jika tidak ada resource yang tersedia untuk konfigurasi jenis mesin di region notebook Anda.

Untuk mengatasi masalah ini, coba salah satu hal berikut:

Buat runtime di region lain.
Buat template runtime dengan konfigurasi jenis mesin yang berbeda, lalu buat runtime berdasarkan template runtime baru.

Runtime default sudah ada

Error berikut terjadi saat Anda mencoba membuat runtime dari template runtime default jika runtime default sudah ada.

Failed to create runtime

One click runtime already exists.

Jika Anda mencoba membuat runtime dari template runtime default, Colab Enterprise akan mencoba membuat runtime default. Hanya boleh ada satu runtime default per pengguna, project, dan region. Jika runtime default sudah ada, Colab Enterprise tidak dapat membuat runtime default lainnya.

Untuk mengatasi masalah ini, hubungkan ke runtime default yang ada atau buat runtime dari template runtime non-default.

Tidak dapat membuat runtime default

Saat Colab Enterprise membuat runtime default, Colab Enterprise akan membuat template runtime default terlebih dahulu yang digunakan untuk membuat runtime default. Jika Anda mencoba membuat runtime default tanpa izin yang diperlukan untuk membuat template runtime, maka Colab Enterprise tidak dapat membuat runtime default.

Untuk mengatasi masalah ini, minta administrator untuk memberi Anda peran yang menyertakan izin aiplatform.notebookRuntimeTemplates.create.

Langkah berikutnya

Untuk mengelola runtime, lihat Mengelola runtime.
Pelajari lebih lanjut runtime dan template runtime.
Terhubung ke runtime.
Pelajari cara membuat template runtime.