Mendaftarkan instance lama dengan Notebooks API

Halaman ini menunjukkan cara memigrasikan dan mendaftarkan instance notebook lama yang dikelola pengguna dengan Notebooks API. Instance yang dibuat menggunakan Compute Engine API disebut instance lama. Instance lama tidak memiliki update terbaru untuk fungsi dan fitur.

Untuk menggunakan fungsi dan fitur baru yang tersedia dengan Notebooks API, Anda harus register instance lama Anda dengan Notebooks API. Sebelum mendaftarkan instance lama Anda, periksa apakah instance lama tersebut memenuhi persyaratan. Anda dapat migrate instance yang tidak memenuhi persyaratan.

Jika Anda mengaktifkan Notebooks API sebelum mendaftarkan instance lama, proses aktivasi Notebooks API akan mencoba mendaftarkan instance lama yang ada secara otomatis.

Persyaratan dan batasan

Sebelum mendaftarkan instance lama Anda ke Notebooks API, pertimbangkan persyaratan dan batasan berikut.

Zona sumber dan tujuan harus cocok dan merupakan zona yang valid untuk Notebooks API.

Misalnya, instance notebook lama yang dikelola pengguna di us-west1-a tetap berada di us-west1-a saat didaftarkan dengan Notebooks API. Namun, instance notebook lama yang dikelola pengguna di us-central1-f tidak akan terdaftar dengan Notebooks API karena us-central1-f bukan zona yang valid untuk Notebooks API.

Untuk mendapatkan daftar zona yang valid untuk instance notebook Notebooks API, jalankan perintah berikut menggunakan Google Cloud CLI di terminal pilihan Anda atau di Cloud Shell:
```
gcloud notebooks locations list
```
Jika zona instance lama Anda bukan zona yang valid untuk Notebooks API, Anda dapat menghubungidukungan atau pengelola akun Anda, atau Anda dapatmemigrasikan instance lama ke instance notebook baru yang dikelola pengguna.
Hanya instance disk ganda yang dapat menggunakan semua fitur notebook yang dikelola pengguna.

Instance lama disk tunggal tidak dapat menggunakan beberapa fitur notebook yang dikelola pengguna, seperti upgrade otomatis, bahkan setelah terdaftar dengan Notebooks API. Agar instance lama disk tunggal dapat menggunakan semua fitur yang tersedia, Anda harus memigrasikan instance disk tunggal ke instance disk ganda.

Anda dapat memigrasikan instance disk tunggal ke instance disk ganda sebagai bagian dari migrasi dari instance lama ke instance yang terdaftar dengan Notebooks API. Jika sudah mendaftarkan instance lama dengan Notebooks API, Anda masih dapat memigrasikan instance ke instance disk ganda baru untuk menyelesaikan masalah.

Untuk memverifikasi jumlah disk, selesaikan langkah-langkah berikut.
Konsol
1. Di konsol Google Cloud, buka halaman Instance VM.
  
  Buka instance VM
2. Temukan instance notebook yang dikelola pengguna lama saat ini.
3. Klik nama instance untuk membuka halaman Detail instance VM.
4. Di bagian boot disk dan disk tambahan, pastikan jumlah disk yang terpasang ke VM.
gcloud
1. Di Cloud Shell atau lingkungan mana pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut :
```
gcloud compute instances describe MY_INSTANCE_NAME
    --zone=MY_ZONE
```
  Ganti kode berikut:
  - MY_INSTANCE_NAME: nama instance Anda
  - MY_ZONE: zona instance
2. Tinjau informasi yang mengikuti disk:, dan verifikasi jumlah disk yang terpasang ke VM.

Memigrasikan instance lama ke instance notebook yang dikelola pengguna yang baru

Jika instance notebook lama yang dikelola pengguna berada di zona yang bukan zona valid untuk Notebooks API, atau jika Anda ingin bermigrasi dari instance disk tunggal ke instance disk ganda, Anda harus membuat instance notebook yang dikelola pengguna dan menyalin data pengguna dari instance lama ke instance baru.

Untuk membuat instance notebook yang dikelola pengguna dan menyalin data pengguna Anda dari instance lama ke instance baru, selesaikan langkah-langkah berikut:

Agar dapat menggunakan ssh untuk terhubung ke instance lama, di Cloud Shell atau lingkungan mana pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut:
```
export PROJECT_ID="MY_PROJECT_ID"
export ZONE="MY_ZONE"
export INSTANCE_NAME="MY_INSTANCE"
gcloud compute ssh
    --project $PROJECT_ID
    --zone $ZONE $INSTANCE_NAME
    -- -L 8080:localhost:8080
```
Ganti kode berikut:
- MY_PROJECT_ID: ID project Google Cloud Anda
- MY_ZONE: zona instance
- MY_INSTANCE: nama instance dengan informasi yang relevan.
Untuk menyalin konten instance lama ke bucket Cloud Storage, gunakan gsutil. Contoh perintah berikut menyalin semua file notebook (.ipynb) dari direktori default /home/jupyter/ ke direktori Cloud Storage bernama my-bucket/legacy-notebooks.
```
gsutil cp -R /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/
```
Buat instance notebook yang dikelola pengguna dengan spesifikasi hardware yang sama seperti instance lama. Anda dapat membuat instance menggunakan konsol Google Cloud atau Google Cloud CLI.

Dalam contoh ini, Vertex AI Workbench membuat instance notebook yang dikelola pengguna bernamanew-notebook di project example menggunakan image TensorFlow 2 terbaru, dengan jenis mesin n1-standard-1, dalam zona us-west1-a.

Baik di Cloud Shell maupun lingkungan apa pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut:
```
gcloud notebooks instances create new-notebook \
    --vm-image-project=example \
    --vm-image-family=tf-latest-cpu \
    --machine-type=n1-standard-1 \
    --location=us-west1-a
```
Instance baru dari notebook yang dikelola pengguna adalah disk ganda. Notebook ini memiliki boot disk dan disk data.
Gunakan ssh untuk terhubung ke instance notebook yang dikelola pengguna yang baru saja Anda buat.
Untuk menyalin konten instance lama dari bucket Cloud Storage ke instance baru, gunakan gsutil. Contoh perintah berikut menyalin semua file notebook (.ipynb) dari direktori Cloud Storage ke direktori /home/jupyter/ instance baru.
```
gsutil cp -R gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/
```
Pada instance baru dari notebook yang dikelola pengguna, buka JupyterLab dan pastikan data dan aset pengguna telah berhasil disalin.
Opsional: hapus instance lama.

Mendaftarkan instance lama pada Notebooks API

Agar dapat menggunakan Notebooks API untuk mengelola instance lama, Anda harus mendaftarkan instance lama ke Notebooks API.

Jika Anda mengaktifkan Notebooks API sebelum mendaftarkan instance lama, proses aktivasi Notebooks API akan mencoba mendaftarkan instance lama yang ada secara otomatis. Jika Anda membuat instance lama setelah Notebooks API diaktifkan, Anda harus mendaftarkannya secara manual menggunakan salah satu metode berikut.

Untuk mendaftarkan instance lama dengan Notebooks API, Anda dapat menggunakan konsol Google Cloud atau Notebooks API.

Konsol

Untuk menggunakan opsi Daftar semua di konsole Google Cloud, selesaikan langkah-langkah berikut:

Di konsol Google Cloud, buka halaman Notebook yang dikelola pengguna.

Buka Notebook yang dikelola pengguna
Jika Anda memiliki satu atau beberapa instance notebook lama yang dikelola pengguna, akan muncul pesan yang menunjukkan bahwa Anda perlu mendaftarkannya dengan Notebooks API. Di samping pesan ini, klik Daftarkan semua.
Jika Anda tidak memiliki instance notebook lama yang dikelola pengguna, tetapi belum mengaktifkan Notebooks API, klik Aktifkan Notebooks API untuk memastikan bahwa instance notebook baru yang dikelola pengguna dibuat dengan menggunakan Notebooks API.

Notebooks API

Untuk menggunakan metode register yang disediakan oleh Notebooks API, di Cloud Shell atau lingkungan apa pun tempat Google Cloud CLI diinstal, masukkan perintah Google Cloud CLI berikut:

gcloud notebooks instances register MY_INSTANCE_NAME
    --location=MY_ZONE

Ganti kode berikut:

MY_INSTANCE_NAME: nama instance Anda
MY_ZONE: zona instance

Langkah selanjutnya

Membuat instance notebook yang dikelola pengguna menggunakan container kustom