Terhubung ke runtime di Colab Enterprise

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. Login ke akun Google Cloud Anda. 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.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Aktifkan API Vertex AI, Dataform, and Compute Engine.

   Mengaktifkan API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

7. Aktifkan API Vertex AI, Dataform, and Compute Engine.

   Mengaktifkan API

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.

Administrator mungkin juga dapat memberi akun pengguna Anda izin yang diperlukan melalui peran khusus atau peran yang telah ditetapkan lainnya.

Pengguna yang diberi peran Code Creator dalam suatu project dapat mencantumkan nama aset kode dalam project tersebut menggunakan Dataform API atau antarmuka command line (CLI) Dataform. Dalam pratinjau, pengguna non-administrator yang menggunakan BigQuery Studio hanya dapat melihat aset kode yang mereka buat atau yang dibagikan kepada mereka.

Terhubung 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.

Administrator mungkin juga dapat memberi akun pengguna Anda izin yang diperlukan melalui peran khusus atau peran yang telah ditetapkan lainnya.

Pengguna yang diberi peran Code Creator dalam suatu project dapat mencantumkan nama aset kode dalam project tersebut menggunakan Dataform API atau antarmuka command line (CLI) Dataform. Dalam pratinjau, 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.

Administrator mungkin juga dapat memberi akun pengguna Anda izin yang diperlukan melalui peran khusus atau peran yang telah ditetapkan lainnya.

Pengguna yang diberi peran Code Creator dalam suatu project dapat mencantumkan nama aset kode dalam project tersebut menggunakan Dataform API atau antarmuka command line (CLI) Dataform. Dalam pratinjau, 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 untuk 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.