Menggunakan SSH untuk mengakses JupyterLab

Menggunakan SSH untuk mengakses JupyterLab

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.

Setiap kali Anda tidak memiliki akses HTTPS ke instance JupyterLab, Anda harus menggunakan SSH untuk membuat koneksi.

Untuk menyiapkan penerusan port SSH, selesaikan langkah-langkah berikut, lalu akses sesi JupyterLab Anda melalui browser lokal:

1. Jalankan perintah berikut menggunakan Google Cloud CLI di terminal pilihan Anda atau di Cloud Shell:

   gcloud compute ssh \
       --project PROJECT_ID \
       --zone ZONE \
       INSTANCE_NAME \
       -- -L 8080:localhost:8080

   Ganti kode berikut:

   • PROJECT_ID: project ID Google Cloud Anda
   • ZONE: adalah zona tempat instance Anda berada
   • INSTANCE_NAME: nama instance Anda

Catatan: Jika menggunakan Cloud Shell untuk menjalankan perintah, tambahkan -4 ke flag SSH untuk menggunakan IPv4 guna terhubung. Contoh: -- -4 -L LOCAL_PORT:localhost:REMOTE_PORT

1. Akses sesi JupyterLab Anda melalui browser lokal:

   • Jika Anda menjalankan perintah di mesin lokal, kunjungi https://localhost:8080 untuk mengakses JupyterLab.

   • Jika Anda menjalankan perintah menggunakan Cloud Shell, akses JupyterLab melalui  Web Preview di port 8080.

Alasan Anda mungkin tidak memiliki akses HTTPS

Untuk mendapatkan akses HTTPS ke JupyterLab, instance notebook yang dikelola pengguna harus memiliki akses ke layanan proxy Google Cloud. Saat dimulai, instance akan mencoba mendaftarkan diri ke layanan proxy. Jika gagal mendapatkan akses proxy, instance notebook yang dikelola pengguna akan meminta Anda untuk mengakses JupyterLab melalui SSH.

Berikut adalah alasan umum mengapa Anda mungkin tidak memiliki akses HTTPS ke JupyterLab:

• Setelan metadata mode proxy instance JupyterLab Anda salah.

• Jaringan Anda dikonfigurasi untuk memblokir akses internet bagi mesin virtual (VM) yang menjalankan notebook JupyterLab.

• Instance notebook yang dikelola pengguna Anda tidak memiliki alamat IP eksternal.

• Setelan Kontrol Layanan VPC Anda memblokir akses ke Artifact Registry.

Bagian berikut menunjukkan cara menyelesaikan masalah ini.

Agar perubahan diterapkan, Anda mungkin perlu memulai ulang VM notebook saat mencoba menyelesaikan masalah ini.

Setelan metadata mode proxy instance JupyterLab Anda salah

Secara default, saat Anda menggunakan notebook yang dikelola pengguna untuk membuat instance JupyterLab, Vertex AI Workbench akan menambahkan setelan metadata mode proxy. Jika Anda mengubah atau menghapus setelan metadata mode proxy, instance notebook yang dikelola pengguna tidak dapat terhubung ke layanan proxy.

Untuk memastikan setelan metadata mode proxy Anda valid, selesaikan langkah-langkah berikut:

1. Di Konsol Google Cloud, buka halaman Notebook yang dikelola pengguna.

   Buka Notebook yang dikelola pengguna

2. Pilih instance yang perlu Anda ubah.

3. Di samping Lihat detail VM, klik Lihat di Compute Engine.

4. Di halaman detail VM, klik Edit.

5. Di bagian Metadata, tambahkan atau ubah metadata untuk memastikan ada proxy-mode entryset to the correct value, for example:project_editors`.

   Pelajari lebih lanjut kemungkinan nilai entri metadata proxy-mode.

6. Klik Simpan.

Jaringan memblokir akses internet

Instance JupyterLab Anda mengakses layanan proxy melalui URL publik. Jika setelan jaringan Virtual Private Cloud Anda memblokir akses ke internet publik atau aturan firewall memblokir traffic keluar, Anda harus menggunakan SSH untuk mengakses instance notebook yang dikelola pengguna. Jika memungkinkan, Anda dapat bekerja sama dengan administrator jaringan dan firewall untuk mengizinkan akses ke instance notebook yang dikelola pengguna melalui internet publik.

Instance notebook yang dikelola pengguna tidak memiliki alamat IP eksternal

Anda mungkin telah membuat instance notebook yang dikelola pengguna tanpa alamat IP eksternal. Jika Anda perlu mengubah setelan ini, selesaikan langkah-langkah berikut.

1. Di Konsol Google Cloud, buka halaman Notebook yang dikelola pengguna.

   Buka Notebook yang dikelola pengguna

2. Klik nama instance yang perlu diubah.

3. Klik Lihat detail VM.

4. Klik Edit.

5. Di bagian Antarmuka jaringan, luaskan jaringan yang Anda inginkan untuk memiliki alamat IP eksternal.

6. Klik menu drop-down Alamat IP Eksternal, dan pilih opsi yang Anda inginkan. Untuk mengatasi masalah ini, Anda tidak boleh memilih Tidak ada.

7. Di bagian Antarmuka jaringan, klik Selesai.

8. Klik Simpan.

Setelan Kontrol Layanan VPC memblokir akses ke Artifact Registry

Agar terhubung ke layanan proxy, instance notebook yang dikelola pengguna menjalankan agen yang didownload dari Artifact Registry. Tanpa agen ini, instance Anda tidak dapat terhubung ke layanan proxy.

Jika setelan Kontrol Layanan VPC Anda memblokir akses ke Artifact Registry, Anda harus menambahkan layanan Artifact Registry ke perimeter layanan Kontrol Layanan VPC Anda. Pelajari lebih lanjut cara kerja perimeter layanan dan layanan Kontrol Layanan VPC yang dapat digunakan untuk mengamankan.

Pemecahan masalah lebih lanjut

Jika masih mengalami masalah saat melakukan koneksi, coba tinjau log konsol untuk virtual machine Anda. Log ini dapat membantu Anda mengetahui penyebab instance notebook yang dikelola pengguna tidak dapat mendaftar dengan layanan proxy.

Untuk mengakses log ini, selesaikan langkah-langkah berikut:

1. Di Konsol Google Cloud, buka halaman Notebook yang dikelola pengguna.

   Buka Notebook yang dikelola pengguna

2. Pilih instance yang ingin Anda selesaikan masalahnya.

3. Di Logs, klik Serial port 1 (console).

Langkah berikutnya

Untuk tips tentang cara menyelesaikan masalah lain, lihat bagian pemecahan masalah di notebook yang dikelola pengguna.