Menjadwalkan operasi notebook

Menjadwalkan operasi notebook

Halaman ini menunjukkan cara menggunakan eksekutor Workbench Platform Agen Gemini Enterprise untuk menjalankan file notebook Python pada jadwal per jam.

Sebelum memulai

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.

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 Notebooks and Gemini Enterprise Agent Platform 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 Notebooks and Gemini Enterprise Agent Platform 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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat instance Agent Platform Workbench dan membuka JupyterLab, minta administrator Anda untuk memberi Anda peran IAM berikut pada project:

• Notebooks Admin (roles/notebooks.admin)
• Service Account User (roles/iam.serviceAccountUser)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Membuat instance dan contoh file notebook

1. Membuat instance

   Catatan: Jika Anda memilih JupyterLab 4 sebagai versi JupyterLab untuk instance, instance tersebut akan menggunakan penjadwal Platform Agen Gemini Enterprise untuk menjadwalkan eksekusi notebook.

2. Buka JupyterLab.

3. Buka file notebook baru.

4. Di sel pertama file notebook, masukkan kode berikut:

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

5. Untuk memastikan file notebook Anda tersimpan, pilih File > Simpan Notebook.

Memberikan izin ke akun layanan instance

Untuk memastikan bahwa akun layanan instance Anda memiliki izin yang diperlukan untuk berinteraksi dengan eksekutor Agent Platform Workbench, minta administrator untuk memberikan peran IAM berikut ke akun layanan instance Anda di project:

Penting: Anda harus memberikan peran ini ke akun layanan instance Anda, bukan ke akun pengguna Anda. Kegagalan memberikan peran ke akun utama yang benar dapat menyebabkan error izin.

• Notebooks Runner (roles/notebooks.runner)
• Storage Admin (roles/storage.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun layanan instance Anda melalui peran khusus atau peran yang telah ditetapkan.

Batasan

Pertimbangkan batasan berikut saat menjadwalkan eksekusi notebook di instance JupyterLab 4:

• Saat menjadwalkan eksekusi notebook di JupyterLab 4, Agent Platform Workbench menyimpan salinan notebook dalam statusnya saat ini di Cloud Storage, lalu menjalankan salinan notebook ini sesuai jadwal. Jika Anda mengedit notebook asli, Anda harus membuat jadwal baru untuk menjalankan notebook versi yang telah diupdate.

Menjadwalkan operasi

1. Di konsol Google Cloud , buka halaman Instances.

   Buka Instances

2. Di samping nama instance, klik Open JupyterLab.

   Instance Agent Platform Workbench Anda akan membuka JupyterLab.

3. Di  File Browser, klik dua kali file notebook contoh untuk membukanya.

4. Klik tombol  Eksekusi.

5. Pada dialog Serahkan notebook ke Eksekutor, di kolom Jenis, pilih Eksekusi berulang berbasis jadwal.

   Secara default, eksekutor menjalankan file notebook Anda setiap jam pada menit 00 dari jam tersebut.

6. Di Opsi lanjutan, masukkan nama untuk bucket Anda di kolom bucket Cloud Storage, lalu klik Buat dan pilih. Eksekutor menyimpan output notebook Anda di bucket Cloud Storage.

7. Klik Submit.

   File notebook Anda akan berjalan secara otomatis sesuai jadwal yang Anda tetapkan.

Catatan: Jika instance Anda dinonaktifkan, eksekutor masih akan menjalankan file notebook Anda sesuai jadwal.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.

Melihat, membagikan, dan mengimpor file notebook yang dijalankan

Dengan menggunakan antarmuka JupyterLab instance, Anda dapat melihat output notebook, membagikan hasilnya kepada orang lain, dan mengimpor file notebook yang dieksekusi ke JupyterLab.

Catatan: Untuk menggunakan konsol Google Cloud guna melihat dan membagikan hasil eksekusi, di halaman Eksekusi, klik Lihat hasil.

Melihat hasil eksekusi

1. Di menu navigasi JupyterLab, klik tombol  Eksekutor Notebook.

2. Klik tab Executions.

3. Di bagian eksekusi yang ingin Anda lihat, klik View result.

   Eksekutor akan membuka hasil Anda di tab browser baru.

Membagikan hasil eksekusi

1. Di antarmuka pengguna JupyterLab instance Anda, pada menu navigasi, klik tombol  Notebook Executor.

2. Klik tab Executions.

3. Di samping eksekusi yang ingin Anda bagikan, klik menu opsi , lalu pilih Bagikan hasil eksekusi.

4. Ikuti petunjuk dalam dialog untuk memberi pengguna akses ke hasil eksekusi.

Impor notebook yang dieksekusi ke JupyterLab

1. Di antarmuka pengguna JupyterLab instance Anda, pada menu navigasi, klik tombol  Notebook Executor.

2. Klik tab Executions.

3. Di samping eksekusi yang ingin Anda impor, klik menu opsi , dan pilih Impor notebook yang dieksekusi.

4. Jika dialog Pilih Kernel muncul, pilih kernel yang ingin Anda buka notebook-nya.

   Eksekutor membuka file notebook yang dieksekusi di JupyterLab, dan menyimpan file notebook ini di File Browser JupyterLab dalam folder bernama imported_notebook_jobs.

Melihat atau menghapus jadwal

Anda dapat melihat dan menghapus jadwal menggunakan konsol Google Cloud atau antarmuka pengguna JupyterLab instance Anda.

Melihat jadwal

Lihat jadwal untuk melihat setelan frekuensi jadwal atau melihat lima hasil terbaru dari eksekusi file notebook.

Konsol

1. Di konsol Google Cloud , buka halaman Schedules.

   Buka Jadwal

2. Untuk jadwal yang ingin Anda lihat, klik nama jadwalnya.

   Di halaman Detail jadwal, Anda dapat melihat lima eksekusi terakhir jadwal.

3. Di samping nama eksekusi, klik View result untuk membuka file notebook yang dijalankan.

   Eksekutor akan membuka hasil Anda di tab browser baru.

JupyterLab

1. Di antarmuka pengguna JupyterLab instance Anda, pada menu navigasi, klik tombol  Notebook Executor.

2. Klik tab Schedules.

3. Di bagian eksekusi yang ingin Anda lihat, klik View current execution result.

   Eksekutor akan membuka hasil Anda di tab browser baru.

Hapus jadwal

Menghapus jadwal tidak akan menghapus eksekusi yang dihasilkan dari jadwal tersebut.

Konsol

1. Di konsol Google Cloud , buka halaman Schedules.

   Buka Jadwal

2. Pilih jadwal yang ingin dihapus.

3. Klik  Delete.

JupyterLab

1. Di antarmuka pengguna JupyterLab instance Anda, pada menu navigasi, klik tombol  Notebook Executor.

2. Klik tab Schedules.

3. Klik nama jadwal. Halaman Detail jadwal untuk jadwal tersebut akan terbuka di konsol Google Cloud .

4. Klik  Delete.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Menghapus instance

1. Di konsol Google Cloud , buka halaman Instances.

   Buka Instances

2. Pilih instance yang ingin Anda hapus.

3. Klik  Delete.

Menghapus project

Jika Anda menggunakan resource di luar instance Agent Platform Workbench, seperti bucket Cloud Storage yang diperlukan untuk membuat jadwal, sebaiknya hapus project Anda agar tidak dikenai biaya tambahan.

Perhatian: Penghapusan project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di Konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah berikutnya

Untuk melihat contoh cara menjadwalkan operasi notebook sebagai bagian dari alur kerja yang lebih komprehensif, jalankan notebook "Latih model klasifikasi multikelas untuk penargetan iklan" di salah satu lingkungan berikut:

Buka di Colab | Buka di Colab Enterprise | Buka di Agent Platform Workbench | Lihat di GitHub