Menjalankan eksekusi notebook dengan parameter

Menjalankan eksekusi notebook dengan parameter

Notebook terkelola Vertex AI Workbench tidak digunakan lagi. Pada 30 Januari 2025, dukungan untuk notebook terkelola akan berakhir dan kemampuan untuk membuat instance notebook terkelola akan dihapus. Instance yang ada akan terus berfungsi, tetapi patch, update, dan upgrade tidak akan tersedia. Untuk terus menggunakan Vertex AI Workbench, sebaiknya migrasikan instance notebook terkelola ke instance Vertex AI Workbench.

Instance notebook terkelola Vertex AI Workbench memungkinkan Anda menggunakan parameter value dalam eksekusi notebook untuk menentukan perbedaan dalam cara kode file notebook Anda dijalankan. Halaman ini menjelaskan cara menyiapkan file notebook untuk menggunakan parameter dan cara menjalankan eksekusi yang menentukan nilai yang berbeda untuk parameter notebook Anda.

Menggunakan parameter untuk menjalankan iterasi yang berbeda dari file notebook Anda

Anda dapat menggunakan parameter value notebook dalam eksekusi untuk menjalankan kode notebook yang sama sekaligus menentukan perbedaan seperti berikut:

• Menentukan set data berbeda yang akan digunakan, atau ukuran sampel set data yang berbeda.

• Menentukan konfigurasi model berbeda seperti kecepatan pembelajaran atau jenis pengoptimal.

• Menjalankan model berbeda, atau menjalankan versi berbeda dari model yang sama.

Cara menggunakan parameter dalam eksekusi notebook

Proses untuk menjalankan notebook dengan parameter memiliki dua langkah utama:

1. Tambahkan tag parameters ke salah satu sel file notebook Anda. Sel ini biasanya berisi kode yang menetapkan nilai ke variabel parameter Anda, meskipun ini bukan persyaratan teknis. Jika Anda tidak menetapkan parameter value yang berbeda dalam eksekusi, eksekusi Anda akan menggunakan parameter value dalam file notebook Anda sebagai nilai default.

2. Buat eksekusi untuk file notebook yang menyertakan nilai baru untuk parameter Anda. Gunakan pola berikut untuk memformat parameter dan nilainya: parameter1=value1,parameter2=value2. Format tersebut memerlukan koma antara pasangan parameter value, tanpa spasi, dan tanpa tanda kutip. Saat eksekusi dijalankan, eksekutor akan menambahkan sel ke notebook yang memperbarui nilai parameter Anda secara langsung setelah sel yang diberi tag parameters.

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 Notebooks and Vertex AI 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 Notebooks and Vertex AI APIs.

   Enable the APIs

8. Buat instance notebook terkelola, jika Anda belum membuatnya.

Peran yang diperlukan

Untuk memastikan bahwa akun layanan instance Anda memiliki izin yang diperlukan untuk berinteraksi dengan eksekutor Vertex AI Workbench, minta administrator untuk memberi akun layanan instance Anda peran IAM berikut di project:

• Notebooks Viewer (roles/notebooks.viewer)
• Pengguna Vertex AI (roles/aiplatform.user)
• Storage Admin (roles/storage.admin)

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 layanan instance Anda melalui peran khusus atau peran bawaan lainnya.

Buka JupyterLab

Untuk membuka JupyterLab dan menyiapkan file notebook untuk dijalankan, selesaikan langkah-langkah berikut.

1. Buka JupyterLab.

2. Upload file notebook (ipynb), buka file yang sudah ada, atau buka file notebook baru, lalu tambahkan kode yang ingin Anda jalankan ke notebook baru.

3. Pastikan kode file notebook Anda memenuhi persyaratan untuk menggunakan eksekutor.

Menambahkan tag parameters ke sel notebook

1. Di antarmuka pengguna JupyterLab instance notebook terkelola Anda, buka file notebook yang ingin Anda jalankan.

2. Tulis kode dalam satu sel yang menetapkan nilai ke variabel parameter Anda. Ini adalah nilai yang digunakan file notebook Anda jika Anda tidak menetapkan parameter value yang berbeda dalam eksekusi.

3. Pastikan sel parameter Anda tetap dipilih, lalu di sidebar kanan, klik  Property inspector.

4. Pada pemeriksa properti, di bagian Cell Tags, klik Add Tag, masukkan parameters, lalu tekan Enter.

   Catatan: Jika Anda memberi tag lebih dari satu sel dengan parameters, eksekutor hanya menambahkan satu sel parameter secara langsung setelah sel pertama dengan tag parameters.

Memberikan parameter value untuk eksekusi Anda

1. Di antarmuka pengguna JupyterLab instance notebook terkelola Anda, klik tombol  Executor.

2. Pada dialog Submit notebooks to Executor, masukkan nama untuk eksekusi Anda di kolom Execution name.

3. Pilih Machine type dan Accelerator type.

4. Pilih Environment.

5. Di kolom Type, pilih One-time execution, atau pilih Schedule-based recurring executions, lalu selesaikan dialog untuk menjadwalkan eksekusi.

6. Di Advanced options, pilih Region tempat Anda ingin menjalankan notebook.

7. Di kolom Cloud Storage bucket, pilih bucket Cloud Storage yang tersedia atau masukkan nama untuk bucket baru, lalu klik Create and select. Eksekutor menyimpan output notebook Anda di bucket Cloud Storage ini.

8. Di bagian Notebook parameterization kotak teks Input parameters, tambahkan parameter notebook yang dipisahkan oleh koma, misalnya optimizer=SGD,learning_rate=0.01. Format ini mengharuskan tanpa spasi dan tanda kutip.

9. Konfigurasikan seluruh eksekusi Anda, lalu klik Submit.

Notebook

Untuk melihat contoh cara menggunakan parameter dalam eksekusi notebook sebagai bagian dari alur kerja yang lebih komprehensif, jalankan notebook Jupyter "Melatih model klasifikasi kelas jamak untuk penargetan iklan" di salah satu lingkungan berikut:

Buka di Colab | Buka di Colab Enterprise | Buka di notebook Vertex AI Workbench yang dikelola pengguna | Lihat di GitHub

Langkah selanjutnya

• Pelajari lebih lanjut cara menjalankan kode notebook di eksekutor.