Menjadwalkan operasi notebook

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

Sebelum memulai

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Notebooks and Gemini Enterprise Agent Platform APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

Peran yang diperlukan

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

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.

  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:

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 kustom atau peran yang telah ditetapkan.

Batasan

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

  • Saat menjadwalkan operasi notebook di JupyterLab 4, Agent Platform Workbench Gemini Enterprise 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 versi notebook yang diperbarui.

Menjadwalkan operasi

  1. Di Cloud de Confiance konsol, buka halaman Instances.

    Buka Instance

  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.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, baca bagian 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.

Cloud de Confiance

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 dengan menggunakan Cloud de Confiance konsol 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 Cloud de Confiance konsol, 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 Cloud de Confiance konsol, 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 Schedule details untuk jadwal tersebut akan terbuka di Cloud de Confiance konsol.

  4. Klik  Delete.

Pembersihan

Agar akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Cloud de Confiance

Menghapus instance

  1. Di Cloud de Confiance konsol, buka halaman Instances.

    Buka Instance

  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.

  1. Di Cloud de Confiance konsol, buka halaman Manage resources.

    Buka Kelola resource

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

Langkah berikutnya