Mengupgrade lingkungan instance

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

Alasan untuk melakukan upgrade

Anda mungkin ingin mengupgrade lingkungan instance Vertex AI Workbench karena salah satu alasan berikut:

  • 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 Vertex AI Workbench:

  • Upgrade otomatis: Aktifkan upgrade otomatis saat Anda membuat instance Vertex AI Workbench. 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 Vertex AI Workbench yang ada memenuhi persyaratan untuk upgrade, Anda dapat mengupgrade instance secara manual.

Persyaratan dan batasan

Kompatibilitas mundur dengan Vertex AI Workbench tidak dijamin. Buat salinan data Anda sebelum mengupgrade instance Vertex AI Workbench.

Untuk menentukan apakah Anda dapat mengupgrade instance Vertex AI Workbench tertentu, lihat persyaratan dan batasan berikut:

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

  • Jika instance Vertex AI Workbench Anda berbasis container, Vertex AI Workbench akan mengupgrade OS. 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 Vertex AI Workbench baru.

Cara kerja upgrade

Instance Vertex AI Workbench yang dapat diupgrade adalah dual-disk, dengan satu boot disk dan satu disk data. Proses upgrade mengupgrade boot disk ke image baru sekaligus mempertahankan data Anda di disk data.

Komponen mana yang diupgrade, atau dipertahankan?

Tabel berikut menunjukkan komponen instance Vertex AI Workbench Anda 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 Vertex AI Workbench menyimpan library pip dan Conda di boot disk, yang diganti selama upgrade. Saat menginstal library pip, Anda dapat menyertakan flag --user untuk menginstalnya di 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

Instance Vertex AI Workbench Anda memiliki nomor versi lingkungan yang dapat Anda verifikasi:

  1. Di Konsol Google Cloud, buka halaman Instances.

    Buka Instance

  2. Dalam daftar instance, temukan nomor versi lingkungan instance Anda di kolom Version.

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

Untuk mengetahui informasi tentang cara menggunakan versi tertentu guna membuat instance Vertex AI Workbench, lihat Membuat versi khusus instance Vertex AI Workbench.

Sebelum memulai

Sebelum mengupgrade, selesaikan langkah-langkah berikut.

  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 checkUpgradability. 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.

Membuat instance Vertex AI Workbench dengan upgrade otomatis yang diaktifkan

Untuk membuat instance Vertex AI Workbench dengan upgrade otomatis yang diaktifkan, centang kotak Aktifkan upgrade otomatis lingkungan dan tetapkan jadwal saat Anda membuat instance.

Anda dapat menentukan upgrade otomatis menggunakan Konsol Google Cloud.

  1. Di Konsol Google Cloud, buka halaman Instances.

    Buka Instance

  2. Klik  Buat baru.

  3. Dalam dialog Instance baru, klik Opsi lanjutan.

  4. Pada dialog Buat instance, di bagian Detail, berikan informasi berikut untuk instance baru Anda:

    • Nama: Berikan nama untuk instance baru Anda.
    • Region dan Zona: Pilih region dan zona untuk instance baru. Untuk mendapatkan performa jaringan terbaik, pilih region yang paling dekat secara geografis dengan Anda. Lihat lokasi Vertex AI Workbench yang tersedia.

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

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

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

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

  9. Selesaikan dialog pembuatan instance selanjutnya, lalu klik Buat.

Mengedit jadwal upgrade otomatis

Untuk mengedit jadwal upgrade otomatis setelah membuat instance Vertex AI Workbench, selesaikan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Instances.

    Buka Instance

  2. Klik nama instance yang memerlukan perubahan jadwal.

  3. Di halaman Detail instance, di bagian Upgrade otomatis lingkungan, edit jadwal.

  4. Klik Kirim untuk menyimpan perubahan.

Mengupgrade secara manual

Anda dapat mengupgrade instance Vertex AI Workbench secara manual yang memenuhi persyaratan.

Memeriksa versi yang lebih baru dari lingkungan instance Anda

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

  1. Di Konsol Google Cloud, buka halaman Instances.

    Buka Instance

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

  3. Pada halaman Detail instance, di samping Detail VM, klik Lihat di Compute Engine.

    Jika versi lingkungan yang lebih baru tersedia, pesan "This instance need to be upgrade" (Instance ini perlu diupgrade) akan muncul.

Mengupgrade lingkungan instance Anda ke versi yang lebih baru

Anda dapat mengupgrade instance Vertex AI Workbench secara manual di Konsol Google Cloud.

  1. Di Konsol Google Cloud, buka halaman Instances.

    Buka Instance

  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 detail Instance, klik  Upgrade.

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

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

Me-roll back upgrade

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

  1. Di Konsol Google Cloud, buka halaman Instances.

    Buka Instance

  2. Klik nama instance yang ingin Anda roll back.

  3. Di halaman Detail Instance, di bagian Upgrade history, klik Rollback.

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