Menggunakan SSH untuk mengakses JupyterLab

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 INSTANCE_NAME \
    --project PROJECT_ID \
    --zone ZONE \
    -- -NL 8080:localhost:8080

    Ganti kode berikut:

  2. 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 Vertex AI Workbench harus memiliki akses ke layanan proxy Google Cloud. Saat dimulai, instance akan mencoba mendaftarkan diri ke layanan proxy. Jika gagal mendapatkan akses proxy, instance 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 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 membuat instance Vertex AI Workbench, Vertex AI Workbench akan menambahkan setelan metadata mode proxy. Jika Anda mengubah atau menghapus setelan metadata mode proxy, instance 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 Instances.

    Buka Instance

  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 entri mode proxy yang ditetapkan ke nilai yang benar, misalnya: project_editors.

  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 Vertex AI Workbench yang dikelola pengguna. Jika memungkinkan, Anda dapat bekerja sama dengan administrator jaringan dan firewall untuk mengizinkan akses ke instance melalui internet publik.

Instance Anda tidak memiliki alamat IP eksternal

Anda mungkin telah membuat instance Vertex AI Workbench tanpa alamat IP eksternal. Jika Anda perlu mengubahnya, selesaikan langkah-langkah berikut.

  1. Di konsol Google Cloud, buka halaman Instances.

    Buka Instance

  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 Vertex AI Workbench 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 menghubungkan, coba tinjau log konsol untuk virtual machine Anda. Log ini dapat membantu Anda mengetahui penyebab instance Vertex AI Workbench tidak dapat mendaftar dengan layanan proxy.

Untuk mengakses log ini, selesaikan langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Instances.

    Buka Instance

  2. Pilih instance yang ingin Anda selesaikan masalahnya.

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

Langkah selanjutnya

Untuk tips tentang cara menyelesaikan masalah lain, lihat bagian pemecahan masalah di instance Vertex AI Workbench.