Mengupgrade lingkungan instance
Instance Workbench Platform Agen Gemini Enterprise adalah instance Deep Learning VM Image dengan lingkungan notebook JupyterLab yang diaktifkan dan siap digunakan. Halaman ini menjelaskan cara mengupgrade lingkungan instance Agent Platform Workbench.
Alasan untuk melakukan upgrade
Sebaiknya upgrade lingkungan instance Agent Platform 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 Agent Platform Workbench:
Upgrade otomatis: Aktifkan upgrade otomatis saat Anda membuat instance Agent Platform Workbench. Selama jangka waktu berulang yang Anda tentukan, Agent Platform Workbench akan memeriksa apakah instance Anda dapat diupgrade, dan jika demikian, Agent Platform Workbench akan mengupgrade instance Anda.
Upgrade manual: Jika instance Agent Platform Workbench yang ada memenuhi persyaratan untuk upgrade, Anda dapat mengupgrade instance secara manual.
Persyaratan dan batasan
Kompatibilitas mundur dengan Agent Platform Workbench tidak dijamin. Buat salinan data Anda sebelum mengupgrade instance Agent Platform Workbench.
Untuk menentukan apakah Anda dapat mengupgrade instance Agent Platform Workbench tertentu, lihat persyaratan dan batasan berikut:
Notebooks API harus diaktifkan di Google Cloud project instance. Untuk mengetahui informasi selengkapnya, lihat Mencantumkan layanan yang diaktifkan dan Mengaktifkan API.
Jika instance Agent Platform Workbench Anda berbasis container, Agent Platform 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
latestdi dalam Dockerfile Anda.
Jika mengupgrade instance tidak memungkinkan, pertimbangkan untuk memigrasikan data ke instance Agent Platform Workbench baru.
Cara kerja upgrade
Instance Agent Platform 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 Agent Platform 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 Agent Platform 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 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
Instance Agent Platform Workbench Anda memiliki nomor versi lingkungan yang dapat Anda verifikasi:
Di konsol Google Cloud , buka halaman Instances.
Dalam daftar instance, temukan nomor versi lingkungan instance Anda di kolom Version.
Agent Platform Workbench memperbarui lingkungan secara rutin (lihat Catatan rilis), tetapi dengan setiap versi yang dirilis, tidak semua lingkungan diperbarui. Agent Platform 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 guna membuat instance Agent Platform Workbench, lihat Membuat versi spesifik dari instance Agent Platform Workbench.
Sebelum memulai
Sebelum mengupgrade, selesaikan langkah-langkah berikut.
Lihat catatan rilis untuk mempelajari update pada versi yang lebih baru.
Buat salinan data Anda sebagai cadangan.
Mengupgrade secara otomatis
Agent Platform 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 Agent Platform 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,
Agent Platform Workbench menggunakan metode API
checkUpgradability.
Metode ini memeriksa apakah ada versi image yang lebih baru pada boot disk
instance.
Jika instance dapat diupgrade, Agent Platform Workbench akan menggunakan metode upgrade internal untuk mengupgrade instance tersebut.
Membuat instance Agent Platform Workbench dengan upgrade otomatis yang diaktifkan
Untuk membuat instance Agent Platform Workbench dengan upgrade otomatis diaktifkan, centang kotak Aktifkan upgrade otomatis lingkungan dan tetapkan jadwal saat Anda membuat instance.
Anda dapat menentukan upgrade otomatis menggunakan konsol Google Cloud .
Di konsol Google Cloud , buka halaman Instances.
Klik Buat baru.
Dalam dialog Instance baru, klik Opsi lanjutan.
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 Agent Platform Workbench yang tersedia.
Di bagian System health, pilih Environment auto-upgrade.
Pilih apakah Anda akan mengupgrade notebook secara Weekly, atau Monthly.
Di dalam kolom Weekday, pilih opsi yang Anda inginkan.
Di dalam kolom Hour, pilih jam dalam sehari.
Selesaikan dialog pembuatan instance selanjutnya, lalu klik Buat.
Mengedit jadwal upgrade otomatis
Untuk mengedit jadwal upgrade otomatis setelah membuat instance Agent Platform Workbench, selesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Instances.
Klik nama instance yang memerlukan perubahan jadwal.
Di halaman Detail instance, di bagian Upgrade otomatis lingkungan, edit jadwal.
Klik Kirim untuk menyimpan perubahan.
Mengupgrade secara manual
Anda dapat mengupgrade instance Agent Platform Workbench 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 .
Di konsol Google Cloud , buka halaman Instances.
Klik nama instance yang ingin Anda periksa ketersediaannya untuk versi lingkungan yang lebih baru.
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 Agent Platform Workbench secara manual di Google Cloud konsol.
Di konsol Google Cloud , buka halaman Instances.
Jika instance Anda tidak berjalan, mulai instance. Agent Platform Workbench hanya dapat mengupgrade instance saat instance tersebut berjalan.
Klik nama instance yang ingin Anda upgrade.
Di halaman detail Instance, klik Upgrade.
Pastikan Anda telah membuat salinan data di instance sebelum melanjutkan.
Setelah data Anda dicadangkan, klik Upgrade. Agent Platform Workbench mengupgrade dan memulai instance Anda.
Upgrade.Me-roll back upgrade
Untuk melakukan roll back upgrade, selesaikan langkah-langkah berikut ini:
Di konsol Google Cloud , buka halaman Instances.
Klik nama instance yang ingin Anda roll back.
Di halaman Detail Instance, di bagian Upgrade history, klik Rollback.
Agent Platform Workbench me-roll back instance Anda ke versi sebelumnya.