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

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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 mendapatkan izin yang diperlukan untuk terhubung ke runtime default di notebook Colab Enterprise, minta administrator untuk memberi Anda peran IAM Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) di project tersebut. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Satu atau beberapa peran yang diperlukan mencakup izin dataform.repositories.list. Pengguna yang diberi izin dataform.repositories.list atau peran Code Creator (roles/dataform.codeCreator) dalam suatu 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 Google Cloud konsol, buka halaman Colab Enterprise My notebooks.

   Buka My notebooks

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

3. 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 mendapatkan izin yang diperlukan untuk terhubung ke runtime yang sudah ada di notebook Colab Enterprise, minta administrator untuk memberi Anda peran IAM Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) di project tersebut. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Satu atau beberapa peran yang diperlukan mencakup izin dataform.repositories.list. Pengguna yang diberi izin dataform.repositories.list atau peran Code Creator (roles/dataform.codeCreator) dalam suatu 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 Google Cloud konsol, buka halaman Colab Enterprise My notebooks.

   Buka My notebooks

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

3. 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 mendapatkan izin yang diperlukan untuk membuat runtime di Colab Enterprise, minta administrator untuk memberi Anda peran IAM Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) di project tersebut. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Satu atau beberapa peran yang diperlukan mencakup izin dataform.repositories.list. Pengguna yang diberi izin dataform.repositories.list atau peran Code Creator (roles/dataform.codeCreator) dalam suatu 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 Google Cloud konsol, buka halaman Colab Enterprise My notebooks.

   Buka My notebooks

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

3. 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 Anda membuat runtime, Anda akan otomatis memiliki izin yang diperlukan untuk menghapus (aiplatform.googleapis.com/notebookRuntimes.delete) dan memulai (aiplatform.googleapis.com/notebookRuntimes.start) runtime tersebut.

Untuk mempelajari cara mengelola runtime, termasuk cara menghapus, memulai, atau memutuskan koneksi dari runtime, lihat Mengelola runtime.

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 dari domain *.aiplatform-notebook.googleusercontent.com.DATALAB_TUNNEL_TOKEN

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 berikutnya

• Pelajari lebih lanjut runtime dan template runtime.
• Buat template runtime.
• Untuk menemukan notebook yang dapat membantu Anda memulai project dengan cepat, lihat galeri notebook.