Mengupgrade lingkungan instance notebook yang dikelola pengguna

Mengupgrade lingkungan instance notebook yang dikelola pengguna

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

Instance notebook yang dikelola pengguna Vertex AI Workbench adalah instance Deep Learning VM Images dengan lingkungan notebook JupyterLab yang diaktifkan, dan siap digunakan. Halaman ini menjelaskan cara untuk mengupgrade lingkungan instance notebook yang dikelola pengguna.

Alasan untuk melakukan upgrade

Sebaiknya upgrade lingkungan instance notebook yang dikelola pengguna karena salah satu alasan berikut ini:

• Untuk menggunakan kemampuan baru yang hanya tersedia di versi lingkungan Anda yang lebih baru.

• Untuk mendapatkan manfaat dari update framework, update paket, dan perbaikan bug yang telah diimplementasikan dalam versi lingkungan yang lebih baru.

Metode untuk mengupgrade

Ada dua cara untuk mengupgrade instance notebook yang dikelola pengguna:

• Upgrade otomatis: Mengaktifkan upgrade otomatis saat Anda membuat instance notebook yang dikelola pengguna. Selama jangka waktu berulang yang Anda tentukan, Vertex AI Workbench akan memeriksa apakah instance Anda dapat diupgrade, dan jika demikian, Vertex AI Workbench akan mengupgrade instance Anda.

• Upgrade manual: Jika instance notebook yang dikelola pengguna yang sudah ada memenuhi persyaratan untuk upgrade, Anda dapat mengupgrade instance secara manual.

Persyaratan dan batasan

Kompatibilitas mundur dengan notebook yang dikelola pengguna tidak dijamin. Buat salinan data Anda sebelum mengupgrade instance notebook yang dikelola pengguna.

Untuk menentukan apakah Anda dapat mengupgrade instance notebook tertentu yang dikelola pengguna, lihat persyaratan dan batasan berikut ini:

• Notebooks API harus diaktifkan di dalam Project Google Cloud milik instance. Untuk informasi selengkapnya, lihat Mencantumkan layanan yang diaktifkan, dan Mengaktifkan API.

• Versi lingkungan instance notebook yang dikelola pengguna harus berada dalam versi M54, atau yang lebih tinggi.

• Instance notebook yang dikelola pengguna harus sudah dibuat sebelumnya menggunakan Notebooks API, atau harus sudah terdaftar di Notebooks API.

• Jika instance notebook yang dikelola pengguna Anda berbasis container, Vertex AI Workbench akan mengupgrade OS tersebut. Versi image bergantung pada image tertentu yang diambil oleh Dockerfile Anda.

  Untuk membantu memastikan upgrade menggunakan versi terbaru image, pertimbangkan untuk menggunakan tag latest di dalam Dockerfile Anda.

Jika mengupgrade instance tidak memungkinkan, pertimbangkan untuk memigrasikan data ke instance notebook yang dikelola pengguna baru.

Cara kerja upgrade

Instance notebook yang dikelola pengguna yang dapat diupgrade adalah dual-disk, dengan satu boot disk dan satu disk data. Proses upgrade-nya mengupgrade boot disk ke image baru, sekaligus mempertahankan data Anda yang berada di dalam disk data.

Komponen mana yang diupgrade, atau dipertahankan?

Tabel berikut ini menunjukkan komponen instance notebook yang dikelola pengguna yang diupgrade, dan mana yang dipertahankan.

Komponen	Hasil upgrade
Framework machine learning	Diupgrade
Data machine learning	Dipertahankan
Dependensi bawaan	Diupgrade
Library yang diinstal oleh pengguna	Secara default, library ini harus diinstal ulang (lihat Library yang diinstal pengguna)
File lokal di dalam direktori /home/jupyter	Dipertahankan
File lokal di direktori /home/ lainnya	Tidak dipertahankan
Paket sistem operasi bawaan	Diupgrade
Paket sistem operasi yang diinstal oleh pengguna	Tidak dipertahankan
Driver GPU	Diupgrade
Notebook	Dipertahankan
Konfigurasi pengguna	Dipertahankan

Library yang diinstal oleh pengguna

Secara default, instance notebook yang dikelola pengguna menyimpan library pip dan Conda di dalam boot disk, yang diganti selama upgrade. Saat menginstal library pip, Anda dapat menyertakan flag --user untuk menginstalnya di dalam direktori /home/jupyter/, tempat library tersebut dipertahankan selama upgrade.

Secara default, jika Anda menginstal library pip atau Conda dalam kernel yang dibuat dari container kustom, library hanya akan dipertahankan selama kernelnya berjalan. Setiap kali kernel dimulai ulang, library tersebut perlu diinstal ulang. Untuk menginstal library persisten di dalam container kustom, sertakan penginstalan library di Dockerfile Anda. Saat menginstal library pip dalam kernel yang dibuat dari container kustom, Anda dapat menyertakan flag --user agar library akan tetap ada hingga instance-nya dimulai ulang.

Versi lingkungan

Vertex AI Workbench memperbarui lingkungan secara rutin (lihat catatan rilis Deep Learning VM ), tetapi untuk setiap versi yang dirilis, tidak semua lingkungan diperbarui. Vertex AI Workbench hanya mengupgrade instance jika terdapat versi lingkungan yang lebih baru untuk image VM yang menjadi dasar instance Anda.

Untuk mengetahui informasi tentang cara menggunakan versi tertentu untuk membuat instance notebook yang dikelola pengguna, lihat Membuat versi spesifik dari instance notebook yang dikelola pengguna.

Sebelum Anda mengupgrade

Sebelum Anda mengupgrade, selesaikan langkah-langkah berikut ini.

1. Lihat catatan rilis untuk mempelajari update pada versi yang lebih baru.

2. Buat salinan data Anda sebagai cadangan.

Mengupgrade secara otomatis

Vertex AI Workbench dapat secara otomatis mengupgrade instance yang sedang berjalan. Jika dihentikan, instance Anda tidak akan secara otomatis mengupgrade instance, meskipun Anda mengaktifkan upgrade otomatis saat membuatnya.

Saat mengaktifkan upgrade lingkungan otomatis, Anda menentukan jangka waktu berulang saat Vertex AI Workbench memeriksa apakah instance tersebut dapat diupgrade, dan jika benar dapat diupgrade, akan mengupgrade instance tersebut.

Jangka waktu yang Anda tentukan disimpan sebagai entri metadata notebook-upgrade-schedule, dalam format unix-cron, Waktu Greenwich (GMT).

Untuk memeriksa apakah instance dapat diupgrade, Vertex AI Workbench menggunakan metode API isUpgradeable. Metode ini memeriksa apakah ada versi image yang lebih baru pada boot disk instance.

Jika instance dapat diupgrade, Vertex AI Workbench akan menggunakan metode upgrade internal untuk mengupgrade instance tersebut.

Buat instance notebook yang dikelola pengguna menggunakan upgrade otomatis yang diaktifkan

Untuk membuat instance notebook yang dikelola pengguna dengan upgrade otomatis diaktifkan, centang kotak Enable environment auto-upgrade dan tetapkan jadwal saat Anda membuat instance.

Anda dapat menentukan upgrade otomatis menggunakan Konsol Google Cloud, atau Google Cloud CLI.

Sebelum memulai

Sebelum dapat membuat instance notebook yang dikelola pengguna, Anda harus memiliki project Google Cloud dan mengaktifkan Notebooks API untuk project tersebut.

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. Enable the Notebooks API.

   Enable the 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. Enable the Notebooks API.

   Enable the API

8. Jika Anda berencana menggunakan GPU dengan instance notebook yang dikelola pengguna, lihat halaman kuota di Konsol Google Cloud untuk memastikan bahwa Anda memiliki cukup GPU yang tersedia dalam project Anda. Jika GPU tidak tercantum di halaman kuota, atau Anda memerlukan kuota GPU tambahan, Anda dapat meminta penambahan kuota. Lihat Meminta penambahan kuota di halaman Kuota resource Compute Engine.

Peran yang diperlukan

Jika sudah membuat project, Anda memiliki peran IAM Pemilik (roles/owner) pada project, yang mencakup semua izin yang diperlukan. Lewati bagian ini dan mulai buat instance notebook yang dikelola pengguna. Jika Anda tidak membuat project tersebut sendiri, lanjutkan di bagian ini.

Untuk memastikan bahwa akun pengguna Anda memiliki izin yang diperlukan untuk membuat instance notebook yang dikelola pengguna Vertex AI Workbench, minta administrator untuk memberikan peran IAM berikut pada project kepada akun pengguna Anda:

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

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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

Buat instance

Konsol

1. Di dalam Konsol Google Cloud, buka halaman User-managed notebooks. Atau buka notebook.new (https://notebook.new) dan lewati langkah berikutnya.

   Buka User-managed notebooks

2. Klik  New notebook, lalu pilih Customize.

3. Di halaman Create a user-managed notebook, berikan informasi berikut untuk instance baru Anda di bagian Details:

   • Name: nama untuk instance baru Anda
   • Region dan Zone: Pilih region dan zona untuk instance baru. Untuk mendapatkan performa jaringan terbaik, pilih region yang paling dekat secara geografis dengan Anda. Lihat lokasi notebook yang dikelola pengguna yang tersedia.

4. Di bagian System health, pilih Environment auto-upgrade.

5. Pilih apakah Anda akan mengupgrade notebook secara Weekly, atau Monthly.

6. Di dalam kolom Weekday, pilih opsi yang Anda inginkan.

7. Di dalam kolom Hour, pilih jam dalam sehari.

8. Selesaikan dialog pembuatan instance selanjutnya, lalu klik Create.

gcloud

1. Dari Cloud Shell atau lingkungan mana pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut ini:

   gcloud notebooks instances create INSTANCE_NAME
       --metadata=notebook-upgrade-schedule=SCHEDULE
       --vm-image-project=deeplearning-platform-release
       --vm-image-family=VM_IMAGE_FAMILY
       --machine-type=MACHINE_TYPE
       --location=LOCATION
   

   Ganti kode berikut:

   • INSTANCE_NAME: nama instance baru Anda
   • SCHEDULE: jadwal mingguan atau bulanan yang Anda tetapkan, dalam format unix-cron; misalnya "00 19 * * MON" berarti setiap minggu pada hari Senin, pada pukul 1900 Waktu Greenwich (GMT)
   • VM_IMAGE_FAMILY: nama keluarga image yang ingin Anda gunakan untuk membuat instance
   • MACHINE_TYPE: jenis mesin dari VM instance Anda
   • LOCATION: lokasi Google Cloud tempat Anda ingin menaruh instance baru tersebut

2. Akses instance Anda dari Konsol Google Cloud.

Mengedit jadwal upgrade otomatis

Untuk mengedit jadwal upgrade otomatis setelah membuat instance notebook yang dikelola pengguna, selesaikan langkah-langkah berikut ini:

1. Di dalam Konsol Google Cloud, buka halaman User-managed notebooks.

   Buka Notebook yang dikelola pengguna

2. Klik nama instance yang memerlukan perubahan jadwal.

3. Di halaman Notebook details, di bagian Environment auto-upgrade, edit jadwalnya.

4. Klik Submit untuk menyimpan perubahan Anda.

Mengupgrade secara manual

Anda dapat mengupgrade instance notebook yang dikelola pengguna secara manual yang memenuhi persyaratan.

Memeriksa versi yang lebih baru dari lingkungan instance Anda

Untuk memeriksa apakah versi yang lebih baru dari lingkungan instance Anda tersedia, akses instance Anda melalui Konsol Google Cloud.

1. Di dalam Konsol Google Cloud, buka halaman User-managed notebooks.

   Buka Notebook yang dikelola pengguna

2. Jika instance Anda tidak berjalan, mulai instance. Vertex AI Workbench hanya dapat mengupgrade instance saat dijalankan.

3. Klik nama instance yang ingin Anda periksa ketersediaannya untuk versi lingkungan yang lebih baru.

4. Pada halaman Notebook details, di samping VM details, klik View in Compute Engine.

   Jika versi lingkungan yang lebih baru tersedia, pesan "This instance needs to be upgraded" akan muncul.

Mengupgrade lingkungan instance Anda ke versi yang lebih baru

Anda dapat mengupgrade instance notebook yang dikelola pengguna secara manual melalui Konsol Google Cloud, atau dengan menggunakan Google Cloud CLI.

Catatan: Upgrade dapat memengaruhi operasi pengguna yang sedang berjalan.

Konsol

1. Di dalam Konsol Google Cloud, buka halaman User-managed notebooks.

   Buka Notebook yang dikelola pengguna

2. Jika instance Anda tidak berjalan, mulai instance. Vertex AI Workbench hanya dapat mengupgrade instance saat sedang berjalan.

3. Klik nama instance yang ingin Anda upgrade.

4. Di halaman Notebook details, klik  Upgrade.

5. Pastikan Anda telah membuat salinan data di dalam instance sebelum melanjutkan.

6. Setelah data Anda dicadangkan, klik Upgrade. Vertex AI Workbench mengupgrade dan memulai instance Anda.

gcloud

1. Untuk memeriksa apakah instance dapat diupgrade, gunakan metode API isUpgradeable. Metode ini memeriksa apakah ada versi image yang lebih baru pada boot disk instance.

   gcloud notebooks instances is-upgradeable INSTANCE_NAME \
       --location=LOCATION
   

   Ganti kode berikut:

   • INSTANCE_NAME: nama instance Anda
   • LOCATION: lokasi Google Cloud tempat instance Anda berada

   Jika instance dapat diupgrade, responsnya adalah true. Jika responsnya adalah false, instance tidak dapat diupgrade, tetapi Anda masih dapat mencoba memigrasikan data ke instance yang baru.

2. Jika instance Anda tidak berjalan, mulai instance. Vertex AI Workbench hanya dapat mengupgrade instance saat sedang berjalan.

3. Pastikan Anda telah membuat salinan data di instance sebelum melanjutkan.

4. Jika instance dapat diupgrade, gunakan metode API upgrade untuk mengupgrade instance:

   gcloud notebooks instances upgrade INSTANCE_NAME \
       --location=LOCATION
   

   Vertex AI Workbench mengupgrade instance tersebut.

Me-roll back upgrade

Untuk melakukan roll back upgrade, selesaikan langkah-langkah berikut ini:

1. Di dalam Konsol Google Cloud, buka halaman User-managed notebooks.

   Buka Notebook yang dikelola pengguna

2. Klik nama instance yang ingin Anda roll back.

3. Di halaman Notebook details, di bawah Upgrade history, klik Rollback.

4. Vertex AI Workbench me-roll back instance Anda ke versi sebelumnya.