Menghubungkan ke runtime

Menghubungkan ke runtime

Halaman ini menjelaskan cara terhubung ke runtime di Colab Enterprise.

Untuk menjalankan kode di notebook, Anda harus terhubung ke runtime. Runtime adalah resource komputasi yang menjalankan kode Anda.

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

Terhubung menggunakan berbagai metode

Halaman ini menjelaskan cara terhubung ke runtime menggunakan metode berikut:

• Menggunakan runtime default
• Terhubung ke runtime yang sudah ada
• Membuat runtime

Menggunakan runtime default

Bagian ini menjelaskan cara terhubung ke runtime default.

Peran yang diperlukan

Untuk memastikan bahwa akun pengguna Anda memiliki izin yang diperlukan untuk terhubung ke runtime default di notebook Colab Enterprise, minta administrator untuk memberi akun pengguna Anda peran IAM Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) 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.

Menghubungkan ke runtime default

Saat Anda menjalankan kode di notebook untuk pertama kalinya, Colab Enterprise akan otomatis terhubung ke runtime default, kecuali jika Anda menentukan runtime yang berbeda.

Untuk terhubung ke runtime default tanpa menjalankan kode, lakukan langkah berikut:

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

   Buka Notebooks

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

3. Pada tab My notebooks, klik notebook yang ingin Anda buka. Jika Anda belum membuat notebook, buat notebook terlebih dahulu.

4. Di notebook Anda, klik Connect.
   

5. Jika ini adalah kali pertama Anda terhubung ke runtime dengan kredensial pengguna akhir yang diaktifkan, dialog Login akan muncul.

   Runtime default memiliki kredensial pengguna akhir yang diaktifkan secara default. Untuk menggunakan runtime yang tidak memiliki akses ke kredensial pengguna, buat template runtime tanpa kredensial pengguna akhir yang aktif.

   Untuk memberi Colab Enterprise akses ke kredensial pengguna Anda, lakukan langkah-langkah berikut:

   1. Dalam dialog Login, klik akun pengguna Anda.

   2. Pilih See, edit, configure, and delete your Google Cloud data... untuk memberi Colab Enterprise akses ke kredensial pengguna Anda.

      

   3. Klik Lanjutkan.

Colab Enterprise terhubung ke runtime default. Jika runtime default tidak berjalan, Colab Enterprise akan memulai runtime default, lalu terhubung ke sana.

Terhubung ke runtime yang sudah ada

Bagian ini menjelaskan cara terhubung ke runtime yang sudah ada menggunakan dialog Connect to Vertex AI runtime.

Peran yang diperlukan

Untuk memastikan bahwa akun pengguna Anda memiliki izin yang diperlukan untuk terhubung ke runtime yang sudah ada di notebook Colab Enterprise, minta administrator untuk memberi akun pengguna Anda peran IAM Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) 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.

Terhubung ke runtime yang sudah ada

Untuk terhubung ke runtime yang sudah ada:

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

   Buka Notebooks

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

3. Pada tab My notebooks, klik notebook yang ingin Anda buka. Jika Anda belum membuat notebook, buat notebook terlebih dahulu.

4. Di notebook Anda, klik panah untuk meluaskan Additional connection options, lalu pilih Connect to a runtime.
   

   Dialog Connect to Vertex AI runtime akan terbuka.

5. Pada Select a runtime, pilih Connect to an existing runtime.

6. Pada Select an existing runtime option, pilih runtime ke mana Anda ingin terhubung. Jika tidak ada runtime dalam daftar, buat runtime atau terhubunglah ke runtime default.

7. Klik Connect.

8. Jika runtime Anda memiliki kredensial pengguna akhir yang diaktifkan, dan ini adalah pertama kalinya Anda terhubung ke runtime dengan kredensial pengguna akhir yang aktif, dialog Login akan muncul.

   Untuk menggunakan runtime yang tidak memiliki akses ke kredensial pengguna, buat template runtime tanpa kredensial pengguna akhir yang aktif.

   Untuk memberi Colab Enterprise akses ke kredensial pengguna Anda, lakukan langkah-langkah berikut:

   1. Dalam dialog Login, klik akun pengguna Anda.

   2. Pilih See, edit, configure, and delete your Google Cloud data... untuk memberi Colab Enterprise akses ke kredensial pengguna Anda.

      

   3. Klik Lanjutkan.

Colab Enterprise terhubung ke runtime. Jika runtime tidak berjalan, Colab Enterprise akan memulai runtime, lalu terhubung ke sana.

Membuat runtime

Bagian ini menjelaskan cara membuat runtime dan terhubung ke sana menggunakan dialog Connect to Vertex AI runtime. Anda juga dapat membuat runtime dari tab Runtime.

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 dan terhubung ke sana

Untuk membuat runtime dan terhubung ke sana menggunakan dialog Connect to Vertex AI runtime:

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

   Buka Notebooks

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

3. Pada tab My notebooks, klik notebook yang ingin Anda buka. Jika Anda belum membuat notebook, buat notebook terlebih dahulu.

4. Di notebook Anda, klik panah untuk meluaskan Additional connection options, lalu pilih Connect to a runtime.
   

   Dialog Connect to Vertex AI runtime akan terbuka.

5. Pada Select a runtime, pilih Create new runtime.

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

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

8. Klik Connect.

9. Jika template runtime yang Anda pilih memiliki kredensial pengguna akhir yang diaktifkan, dan ini adalah pertama kalinya Anda terhubung ke runtime dengan kredensial pengguna akhir yang aktif, dialog Login akan muncul.

   Untuk menggunakan runtime yang tidak memiliki akses ke kredensial pengguna, buat template runtime tanpa kredensial pengguna akhir yang aktif.

   Untuk memberi Colab Enterprise akses ke kredensial pengguna Anda, lakukan langkah-langkah berikut:

   1. Dalam dialog Login, klik akun pengguna Anda.

   2. Pilih See, edit, configure, and delete your Google Cloud data... untuk memberi Colab Enterprise akses ke kredensial pengguna Anda.

      

   3. Klik Lanjutkan.

Colab Enterprise memulai runtime default, lalu terhubung ke sana.

Pengelolaan runtime

Secara default, saat membuat runtime, Anda otomatis memiliki izin yang diperlukan untuk menghapus (aiplatform.googleapis.com/notebookRuntimes.delete) dan memulai (aiplatform.googleapis.com/notebookRuntimes.start) runtime tersebut.

Memecahkan masalah

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

Tidak dapat terhubung ke runtime

Masalah ini terjadi karena beberapa alasan. Lihat juga Tidak dapat terhubung ke runtime default. Penyebab yang paling umum adalah:

Browser memblokir cookie pihak ketiga

Browser yang Anda gunakan memblokir cookie pihak ketiga yang digunakan Colab Enterprise untuk membuat koneksi HTTPS ke runtime.

Untuk mengatasi masalah ini, konfigurasi setelan browser Anda agar mengizinkan cookie pihak ketiga DATALAB_TUNNEL_TOKEN dari domain *.aiplatform-notebook.googleusercontent.com.

Jaringan memblokir traffic keluar ke domain notebook

Aturan firewall jaringan Anda memblokir traffic keluar ke *.aiplatform-notebook.cloud.google.com atau *aiplatform.googleapis.com.

Untuk mengatasi masalah ini, konfigurasikan aturan firewall jaringan Anda agar mengizinkan traffic keluar ke *.aiplatform-notebook.cloud.google.com dan *aiplatform.googleapis.com.

Tidak dapat terhubung ke runtime default

Error berikut terjadi saat Anda mencoba terhubung ke runtime default saat tidak ada template runtime default.

Failed to connect to runtime

Saat Anda terhubung ke runtime default yang belum dibuat, Colab Enterprise akan membuat template runtime default terlebih dahulu, lalu menggunakan template runtime default tersebut untuk membuat runtime default. Namun, jika Anda tidak memiliki izin yang diperlukan untuk membuat template runtime, maka Colab Enterprise tidak dapat membuat template runtime default atau runtime default.

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

Notebook lambat terhubung ke runtime

Beberapa menit setelah memulai koneksi ke runtime, pesan Connecting masih berada di pojok kanan atas notebook, dan Colab Enterprise belum terhubung ke runtime.

Untuk mengatasi masalah ini, tunggu beberapa menit lagi. Colab Enterprise masih terhubung ke runtime. Menghubungkan ke runtime yang belum berjalan dapat memerlukan waktu beberapa menit karena Vertex AI mengalokasikan instance virtual machine (VM) baru.

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:

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, 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.
• Buat template runtime.