Membuat runtime di Colab Enterprise

Halaman ini menunjukkan cara membuat, memulai, dan menghapus runtime di Vertex AI.

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

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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

Peran yang diperlukan

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

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun pengguna Anda melalui peran khusus atau peran bawaan lainnya.

Satu atau beberapa peran yang diperlukan menyertakan izin dataform.repositories.list. Pengguna yang diberi izin dataform.repositories.list atau peran Code Creator (roles/dataform.codeCreator) dalam 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 konsol Google Cloud atau Google Cloud CLI.

Konsol

Untuk membuat runtime:

1. Di Konsol Google Cloud, buka halaman Colab Enterprise Runtimes.

   Buka Runtime

2. Di menu Region, pilih region tempat Anda ingin menjalankan runtime. Region ini harus sama dengan region notebook yang menggunakannya.

3. Klik  Create runtime.

   Dialog Create Vertex AI runtime akan muncul.

4. Di menu Runtime template, pilih template runtime. Jika tidak ada template runtime yang tercantum, buat template runtime terlebih dahulu.

5. Di kolom Runtime name, masukkan nama untuk runtime Anda.

6. Klik Create.

Secara default, saat 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 menginginkan runtime.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Secara default, saat 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.

Memulai runtime

Untuk memulai runtime, Anda dapat menggunakan konsol Google Cloud atau gcloud CLI.

Konsol

Untuk memulai runtime:

1. Di Konsol Google Cloud, buka halaman Colab Enterprise Runtimes.

   Buka Runtime

2. Di menu Region, pilih region yang berisi runtime Anda.

3. Pilih runtime yang ingin Anda mulai.

4. Klik Mulai.

gcloud

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

• RUNTIME_ID: ID runtime Anda.
• PROJECT_ID: project ID Anda.
• REGION: region tempat runtime Anda berada.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

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

Menghapus runtime

Untuk menghapus runtime, Anda dapat menggunakan konsol Google Cloud atau gcloud CLI.

Konsol

Untuk menghapus runtime:

1. Di Konsol Google Cloud, buka halaman Colab Enterprise Runtimes.

   Buka Runtime

2. Di menu Region, pilih region yang berisi runtime Anda.

3. Pilih runtime yang ingin dihapus.

4. Klik  Delete.

5. Klik Konfirmasi.

gcloud

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

• RUNTIME_ID: ID runtime Anda.
• PROJECT_ID: project ID Anda.
• REGION: region tempat runtime Anda berada.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

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

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

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.

Untuk mengatasi masalah ini, minta batas kuota yang lebih tinggi.

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 runtime dengan konfigurasi jenis mesin berbeda, atau coba lagi pada lain waktu.

Runtime default sudah ada

Error berikut terjadi saat Anda mencoba membuat runtime dari template runtime default saat 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 wilayah. 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 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 selanjutnya

• Pelajari lebih lanjut runtime dan template runtime.
• Terhubung ke runtime.
• Pelajari cara membuat template runtime.