Runtime dan template runtime

Halaman ini menjelaskan runtime dan template runtime untuk Colab Enterprise.

Runtime adalah virtual machine (VM) yang disediakan Google yang dapat menjalankan kode di notebook Anda (file IPYNB).

Template runtime adalah konfigurasi VM yang menentukan jenis mesin dan karakteristik VM lainnya, serta setelan umum seperti jaringan dan apakah akses internet publik diaktifkan. Saat Anda membuat runtime, VM-nya akan dibuat sesuai dengan spesifikasi template runtime.

Alur kerja

Anda dapat membuat notebook Colab Enterprise dan menjalankan kode di dalamnya tanpa perlu memahami runtime. Saat Anda menjalankan kode untuk pertama kalinya, Colab Enterprise akan menyediakan runtime default dan menjalankan kode Anda di dalamnya. Colab Enterprise akan terus menggunakan runtime default hingga Anda terhubung ke runtime lain.

Untuk mengonfigurasi runtime untuk kebutuhan tertentu, Anda harus:

  1. Buat template runtime dengan konfigurasi yang Anda perlukan.

  2. Buat runtime berdasarkan template tersebut.

  3. Hubungkan ke runtime dari notebook Anda dan jalankan kode Anda.

Runtime

Bagian ini menjelaskan karakteristik runtime.

Runtime default

Jika Anda tidak membuat runtime, runtime tanpa akselerator akan dibuat untuk Anda saat pertama kali Anda menjalankan kode atau terhubung ke runtime default. Anda dapat menggunakan runtime default tanpa akselerator, atau beralih ke runtime default yang menyertakan akselerator.

Hanya satu runtime default tanpa akselerator dan satu runtime default dengan akselerator yang diizinkan untuk setiap pengguna per project, per region.

Saat membuat runtime default, Colab Enterprise akan terlebih dahulu membuat template runtime default yang sesuai jika project belum memilikinya di region tersebut. Runtime default dan template runtime muncul di konsol Google Cloud , tempat Anda bisa mendapatkan informasi tentang keduanya.

Jika Anda menggunakan runtime default tanpa akselerator, Colab Enterprise akan membuat satu runtime default tanpa akselerator dan template runtime yang sesuai jika belum ada template runtime default, per project, per region.

Jika Anda menggunakan runtime default dengan akselerator, Colab Enterprise akan membuat satu runtime default dengan akselerator dan template runtime yang sesuai jika belum ada template runtime default dengan akselerator, per project, per region.

Spesifikasi runtime default

Runtime default dan template runtime default yang dibuat secara otomatis mencakup spesifikasi berikut:

Spesifikasi Default Default dengan GPU
Versi Python Versi terbaru yang tersedia (saat ini Python 3.13) Versi terbaru yang tersedia (saat ini Python 3.13)
Jenis mesin e2-standard-4 Bergantung pada ketersediaan regional. Lihat Spesifikasi.
Akselerator Tidak ada Bergantung pada ketersediaan regional. Lihat Spesifikasi.
Boot disk Persistent disk SSD 100 GiB (pd-ssd) Persistent disk SSD 100 GiB (pd-ssd)
Disk data Persistent disk standar 100 GiB (pd-standard) Bergantung pada ketersediaan regional. Lihat Spesifikasi.
Penonaktifan saat tidak ada aktivitas Diaktifkan, disetel ke 180 menit Diaktifkan, disetel ke 180 menit
Jaringan Jaringan Virtual Private Cloud default project Anda Jaringan Virtual Private Cloud default project Anda
Akses internet publik Aktif Aktif
Autentikasi kredensial pengguna akhir Aktif Aktif
Penghapusan otomatis Penghapusan otomatis 18 jam setelah pembuatan Penghapusan otomatis 18 jam setelah pembuatan

Menetapkan template runtime sebagai template runtime default

Anda dapat menetapkan template runtime yang ada sebagai template runtime default untuk project dan region Anda. Saat Anda menetapkan template runtime sebagai default, runtime default baru yang dibuat di project dan region saat ini akan menggunakan konfigurasi template tersebut. Runtime yang ada tidak akan terpengaruh.

Setelah template runtime ditetapkan sebagai template runtime default, semua runtime baru yang dibuat dari template runtime default akan otomatis dihapus 18 jam setelah pembuatan.

Setiap kombinasi region dan project hanya dapat memiliki satu template runtime default tanpa akselerator dan satu template runtime default dengan akselerator. Template runtime yang sebelumnya merupakan template default akan menjadi template yang ditentukan pengguna dan runtime baru yang dibuat dari template tersebut akan otomatis dihapus setelah 6 bulan.

Anda dapat menetapkan template runtime default tanpa akselerator dan template runtime default dengan akselerator.

Untuk menetapkan template runtime sebagai template runtime default, Anda dapat menggunakan konsolGoogle Cloud . Anda dapat melakukannya dari halaman Runtime templates atau dari halaman detail template runtime.

Dari halaman template runtime:

  1. Di konsol Google Cloud , buka halaman Runtime templates Colab Enterprise.

    Buka Template Runtime

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

  3. Di baris template runtime yang ingin Anda tetapkan sebagai default, klik  Actions.

  4. Bergantung pada apakah template menyertakan akselerator:

    • Untuk template tanpa akselerator, klik Set as Default.
    • Untuk template dengan akselerator, klik Set as Default with GPU.

  5. Pada dialog konfirmasi, klik Set as Default atau Set as Default with GPU untuk mengonfirmasi.

Dari halaman detail template runtime:

  1. Di konsol Google Cloud , buka halaman Runtime templates Colab Enterprise.

    Buka Template Runtime

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

  3. Di kolom ID, klik ID template runtime yang ingin Anda tetapkan sebagai default.

  4. Di panel tindakan di bagian atas halaman, klik  Set as Default atau  Set as Default with GPU.

  5. Pada dialog konfirmasi, klik Set as Default atau Set as Default with GPU untuk mengonfirmasi.

Versi Python

Saat Colab Enterprise membuat template runtime default, template runtime default dikonfigurasi untuk menggunakan versi Python terbaru yang tersedia (saat ini Python 3.13). Artinya, saat versi baru Python tersedia di Colab Enterprise, runtime baru yang dibuat dari template runtime default akan menggunakan versi Python terbaru.

Jika template runtime default Anda dibuat pada Mei 2025 atau sebelumnya, template tersebut mungkin dikonfigurasi untuk menggunakan Python 3.10. Untuk mengupdate template runtime default agar menggunakan versi Python terbaru, Anda harus menghapus template runtime default. Kemudian, saat template runtime default baru dibuat, template tersebut akan dikonfigurasi untuk menggunakan versi Python terbaru.

Untuk mengupdate versi Python dari template runtime yang Anda buat, lihat Mengelola template runtime.

Versi Python dari runtime yang ada tidak otomatis berubah, meskipun versi Python baru tersedia di Colab Enterprise. Mengubah versi Python runtime yang ada tidak didukung. Sebagai gantinya, Anda harus membuat runtime baru yang berasal dari template runtime yang menggunakan versi Python yang Anda inginkan.

Mengubah versi Python template runtime

Untuk mengubah versi Python template runtime, Anda dapat menggunakan konsol Google Cloud atau REST API.

Konsol

Untuk mengedit template runtime, lakukan tindakan berikut:

  1. Di konsol Google Cloud , buka halaman Runtime templates Colab Enterprise.

    Buka Template Runtime

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

  3. Di kolom ID, klik nomor ID template runtime yang ingin Anda edit.

  4. Klik  Edit.

  5. Di panel Edit runtime template, buat perubahan pada template runtime.

  6. Klik Update.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGION: region tempat template runtime Anda berada.
  • PROJECT_ID: project ID Anda.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: ID template runtime Anda.
  • RELEASE_NAME: nama rilis image yang ingin Anda gunakan. Misalnya, py311 adalah nama rilis untuk image Python 3.11. Untuk menetapkan image ke Latest, biarkan RELEASE_NAME kosong.

Metode HTTP dan 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

Meminta isi JSON: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$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
Jika berhasil, isi respons akan berisi instance Operation.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi REST API notebookRuntimeTemplates.patch.

Versi Python yang didukung

Colab Enterprise mendukung versi Python untuk jangka waktu tertentu.

Tabel berikut mencantumkan akhir patch dan tanggal dukungan serta akhir tanggal ketersediaan untuk setiap versi Python yang didukung. Untuk mempelajari tanggal ini lebih lanjut, lihat Memahami tanggal akhir dukungan.

Versi Python Akhir patch dan tanggal dukungan Akhir tanggal ketersediaan
Python 3.13 Belum ditentukan Belum ditentukan
Python 3.12 Belum ditentukan Belum ditentukan
Python 3.11 Belum ditentukan Belum ditentukan
Python 3.10 23 Februari 2026 17 Agustus 2026

Memahami tanggal akhir dukungan

Dukungan untuk versi Python akan berakhir sesuai dengan tanggal berikut:

  • Akhir patch dan tanggal dukungan: Setelah tanggal ini, perubahan berikut akan terjadi:

    • Anda tidak dapat membuat template runtime yang menggunakan versi Python ini.
    • Setiap template runtime yang ada dan menggunakan versi Python ini akan otomatis diupgrade untuk menggunakan versi Python terbaru yang tersedia.
    • Runtime yang ada tidak dapat diupgrade lagi.
    • Runtime akan berhenti berfungsi enam bulan setelah upgrade terbarunya, atau jika tidak diupgrade, enam bulan setelah dibuat.

    Untuk meminta perpanjangan penggunaan versi Python ini hingga akhir tanggal ketersediaan, hubungi perwakilan akun Google Cloud Anda.

  • Akhir tanggal ketersediaan: Setelah tanggal ini, perubahan berikut akan terjadi:

    • Versi Python ini tidak tersedia di Colab Enterprise, bahkan untuk pengguna yang diberi ekstensi.
    • Setiap template runtime yang ada yang menggunakan versi Python ini akan otomatis diupgrade untuk menggunakan versi Python terbaru yang tersedia.

Runtime bersifat regional

Runtime bersifat regional, dan harus berada di region yang sama dengan notebook Anda.

Runtime bersifat eksklusif untuk pengguna

Runtime bersifat eksklusif untuk pengguna. Anda tidak dapat membagikan runtime Anda kepada orang lain dan Anda tidak dapat menggunakan runtime mereka. Meskipun Anda membagikan notebook kepada seseorang, dia tidak memiliki akses ke runtime Anda dan harus menjalankan notebook di runtime-nya sendiri.

Namun, pengguna dapat membuat runtime mereka sendiri berdasarkan template runtime yang sama. Lihat Template runtime dapat dibagikan kepada pengguna.

Mengelola file runtime Anda

Anda dapat mengakses dan mengubah file di runtime menggunakan tombol  Files di Colab Enterprise. Anda juga dapat mengupload file ke runtime.

Jika runtime Anda dihapus, semua file yang Anda upload akan dihapus. Jika Anda telah mengubah file, file tersebut akan kembali ke status aslinya saat runtime baru dibuat. Lihat jangka waktu penghapusan otomatis di bagian Default runtime specifications.

Runtime dapat dibagikan oleh notebook

Anda dapat menghubungkan lebih dari satu notebook ke runtime yang sama, tetapi hal ini tidak direkomendasikan. Beberapa notebook yang menggunakan runtime yang sama dapat menyebabkan masalah, termasuk:

  • Notebook mungkin berjalan lambat karena berbagi resource komputasi runtime.

  • Kode dalam satu notebook dapat memengaruhi status VM runtime untuk notebook lainnya. Misalnya, jika Anda menginstal versi 1.3 dari sebuah paket di satu notebook, tetapi notebook Anda yang lain memerlukan versi 1.2, Anda mungkin mengalami ketidakcocokan versi saat menjalankan notebook kedua.

Alih-alih menjalankan kode dari beberapa notebook pada runtime yang sama, Anda dapat membuat runtime untuk setiap notebook berdasarkan template runtime yang sama. Lihat Anda dapat membuat beberapa runtime dari template runtime yang sama.

Biaya runtime

Anda akan dikenai biaya untuk pemrosesan runtime berdasarkan jenis mesin dan akselerator yang Anda gunakan. Anda juga dikenai biaya untuk penyimpanan boot disk dan disk data. Boot disk dan disk data akan dihapus saat runtime dihapus.

Runtime selalu menyertakan persistent disk SSD 100 GiB selain disk data yang ditentukan dalam template runtime. Boot disk tidak dapat dikonfigurasi.

Saat runtime dinonaktifkan:

  • Biaya komputasi tidak dihasilkan karena tidak ada penggunaan CPU atau GPU.
  • Penyimpanan boot disk dan disk data dikenai biaya.

Untuk mengetahui informasi selengkapnya, lihat Harga Colab Enterprise.

Anda dapat membuat beberapa runtime dari template runtime yang sama

Anda dapat membuat beberapa runtime dari satu template runtime non-default. Dengan cara ini, Anda dapat menjalankan beberapa notebook di VM dengan konfigurasi yang sama tanpa berbagi resource VM tersebut.

Template runtime

Bagian ini menjelaskan karakteristik template runtime.

Template runtime bersifat regional

Template runtime bersifat regional. Saat Anda membuat runtime, runtime tersebut berada di region yang sama dengan template runtime, dan runtime hanya dapat digunakan dengan notebook di region tersebut.

Template runtime dapat dibagikan kepada pengguna

Anda dapat membagikan template runtime kepada pengguna lain. Dengan cara ini, setiap pengguna dapat membuat runtime mereka sendiri berdasarkan template runtime yang sama, sehingga beberapa pengguna dapat menjalankan notebook yang sama pada konfigurasi VM yang sama.

Untuk mempelajari lebih lanjut, lihat Mengelola akses ke template runtime.

Konfigurasi

Template runtime menentukan konfigurasi VM runtime Anda. Anda dapat menentukan salah satu dari hal berikut:

Wilayah

Pilih region tempat notebook Anda berada. Runtime yang dibuat dari template runtime berada di region yang sama dengan template runtime. Agar notebook dapat menjalankan kode di runtime, notebook dan runtime harus berada di region yang sama.

Jenis mesin

Anda dapat mengonfigurasi jenis mesin template runtime. Untuk informasi tentang jenis mesin, lihat Panduan perbandingan dan resource kelompok mesin.

Disk data

Anda dapat mengonfigurasi jenis disk dan ukuran disk dari disk data di template runtime Anda.

Saat runtime dibuat, runtime tersebut juga menyertakan boot disk. Boot disk adalah persistent disk SSD 100 GiB dan tidak dapat dikonfigurasi.

Akselerator

Anda dapat menambahkan akselerator ke konfigurasi template runtime. Ketersediaan akselerator didasarkan pada jenis mesin dan region.

Jaringan

Tentukan jaringan Anda atau gunakan jaringan Virtual Private Cloud default project.

Penonaktifan saat tidak ada aktivitas

Colab Enterprise mengaktifkan penonaktifan saat tidak ada aktivitas secara default. Setelan ini akan mematikan instance Anda setelah tidak aktif selama 180 menit. Anda dapat mengubah jumlah menit tidak aktif sebelum penonaktifan, atau menonaktifkan penonaktifan saat tidak ada aktivitas.

Akses internet publik

Untuk mendapatkan kontrol lebih besar atas keamanan notebook dan resource lainnya, Anda dapat menonaktifkan akses internet publik. Jika Anda mengonfigurasi template runtime dengan cara ini, notebook yang menggunakan runtime yang dibuat dari template runtime tidak akan memiliki akses ke internet publik.

Autentikasi kredensial pengguna akhir

Secara default, template runtime menggunakan autentikasi kredensial pengguna akhir untuk memberi notebook Anda akses ke Kredensial Default Aplikasi (ADC). Anda dapat menggunakan akses ke ADC ini untuk menjalankan kode di notebook yang berinteraksi dengan Agent Platform dan layanan Google Cloud lainnya. Jika kredensial pengguna akhir diaktifkan, notebook Anda akan menggunakan kredensial siapa pun yang menjalankan notebook untuk menentukan akses ke resource Google Cloud .

Jika kredensial pengguna akhir tidak diaktifkan, Anda bisa mendapatkan akses ke ADC dengan mengautentikasi pengguna melalui kode notebook Anda. Untuk mempelajari lebih lanjut, lihat bagian "Kredensial pengguna" di Menyiapkan ADC untuk lingkungan pengembangan lokal.

Biaya template runtime

Tidak ada biaya untuk membuat atau menyimpan template runtime. Lihat juga Biaya runtime.

Langkah berikutnya