Terhubung ke runtime di Colab Enterprise

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.

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. 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, konfigurasi aturan firewall jaringan Anda agar mengizinkan traffic keluar ke *.aiplatform-notebook.cloud.google.com dan *aiplatform.googleapis.com.

Langkah selanjutnya

• Pelajari lebih lanjut runtime dan template runtime.
• Buat template runtime.