Membuat instance notebook terkelola

Membuat instance notebook terkelola

Notebook terkelola Vertex AI Workbench tidak digunakan lagi. Pada 30 Januari 2025, dukungan untuk notebook terkelola akan berakhir dan kemampuan untuk membuat instance notebook terkelola 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 terkelola ke instance Vertex AI Workbench.

Halaman ini menunjukkan cara membuat instance notebook terkelola menggunakan Konsol Google Cloud atau Google Cloud CLI. Saat membuat instance, Anda dapat mengonfigurasi hardware, jenis enkripsi, jaringan, dan detail lainnya dari instance Anda.

Sebelum memulai

1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Aktifkan API Notebooks.

   Mengaktifkan API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

7. Aktifkan API Notebooks.

   Mengaktifkan API

Membuat instance dengan properti default

Anda dapat membuat instance notebook terkelola menggunakan Konsol Google Cloud atau gcloud CLI:

Konsol

1. Di Konsol Google Cloud, buka halaman Managed notebooks.

   Buka Managed notebooks

2. Klik  News notebook.

3. Di kolom Notebook name, masukkan nama instance Anda. Nama harus diawali dengan huruf, diikuti dengan maksimal 62 huruf kecil, angka, atau tanda hubung (-), dan tidak boleh diakhiri dengan tanda hubung.

4. Klik daftar Region, lalu pilih region untuk instance Anda.

5. Pilih opsi izin untuk menentukan pengguna mana yang dapat mengakses instance notebook terkelola:

   • Service Account: Opsi ini memberikan akses ke semua pengguna yang memiliki akses ke akun layanan Compute Engine yang Anda tautkan ke runtime. Untuk menentukan akun layanan Anda sendiri, hapus centang pada kotak Use Compute Engine default service account, lalu masukkan alamat email akun layanan yang ingin digunakan. Untuk mendapatkan informasi selengkapnya tentang akun layanan, lihat Jenis akun layanan.

   • Single User: Opsi ini memberikan akses hanya ke pengguna tertentu. Di kolom User email, masukkan alamat email akun pengguna milik pengguna yang akan menggunakan instance notebook terkelola.

   Catatan: Untuk memberikan akses ke instance melalui akun layanan atau opsi satu pengguna, Anda harus menggunakan alamat email akun pengguna individu. Akses grup tidak didukung.

   Untuk mempelajari lebih lanjut cara memberikan akses, lihat Mengelola akses.

6. Klik Create.

   Vertex AI Workbench akan otomatis memulai instance. Saat instance siap digunakan, Vertex AI Workbench akan mengaktifkan link Open JupyterLab.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• INSTANCE_NAME: Nama instance notebook terkelola Anda; harus diawali dengan huruf yang diikuti dengan maksimal 62 huruf kecil, angka, atau tanda hubung (-), dan tidak boleh diakhiri dengan tanda hubung
• PROJECT_ID: ID project Anda.
• LOCATION: Region tempat Anda ingin menempatkan instance
• ACCESS_MODE: mode akses yang ingin Anda gunakan; misalnya, SINGLE_USER atau SERVICE_ACCOUNT
• OWNER_EMAIL_ADDRESS: alamat email satu pengguna atau akun layanan yang memerlukan akses ke antarmuka JupyterLab instance
• MACHINE_TYPE: jenis mesin VM instance Anda

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Untuk mengetahui informasi lebih lanjut tentang perintah untuk membuat instance dari command line, baca dokumentasi gcloud CLI.

Vertex AI Workbench akan otomatis memulai instance setelah pembuatan. Setelah instance siap digunakan, Anda dapat mengaksesnya dari Konsol Google Cloud.

Membuat instance menggunakan setelan lanjutan

1. Di Konsol Google Cloud, buka halaman Managed notebooks.

   Buka Managed notebooks

2. Klik  New notebook.

3. Di kolom Notebook name, masukkan nama instance Anda. Nama harus diawali dengan huruf, diikuti dengan maksimal 62 huruf kecil, angka, atau tanda hubung (-), dan tidak boleh diakhiri dengan tanda hubung.

4. Klik daftar Region, lalu pilih region untuk instance Anda.

5. Pilih opsi izin untuk menentukan pengguna mana yang dapat mengakses instance notebook terkelola:

   • Service Account: Opsi ini memberikan akses ke semua pengguna yang memiliki akses ke akun layanan Compute Engine yang Anda tautkan ke runtime. Untuk menentukan akun layanan Anda sendiri, hapus centang pada kotak Use Compute Engine default service account, lalu masukkan alamat email akun layanan yang ingin digunakan. Untuk mendapatkan informasi selengkapnya tentang akun layanan, lihat Jenis akun layanan.

   • Single User: Opsi ini memberikan akses hanya ke pengguna tertentu. Di kolom User email, masukkan alamat email akun pengguna milik pengguna yang akan menggunakan instance notebook terkelola.

   Catatan: Untuk memberikan akses ke instance melalui akun layanan atau opsi satu pengguna, Anda harus menggunakan alamat email akun pengguna individu. Akses grup tidak didukung.

   Untuk mempelajari lebih lanjut cara memberikan akses, lihat Mengelola akses.

6. Klik Setelan lanjutan dan selesaikan dialog menggunakan petunjuk di bagian berikut.

Menggunakan image Docker kustom

Untuk menjalankan file notebook dalam container Docker kustom, tambahkan image container Docker kustom ke instance notebook terkelola Anda.

Image container Docker kustom harus berada di Artifact Registry. Anda harus memiliki akses ke image container.

1. Di bagian Environment, di Custom Docker images, pilih kotak centang Provide custom Docker images.

2. Masukkan jalur image container Docker, atau klik Select untuk menambahkannya dari Artifact Registry.

3. Untuk menambahkan image Docker kustom lainnya, klik  Add another Docker image, dan ulangi langkah-langkah ini.

Mengonfigurasi hardware

Pilih konfigurasi hardware untuk lingkungan Anda. Anda dapat mengubahnya nanti dari antarmuka pengguna JupyterLab.

Mengonfirmasi ketersediaan GPU

Ketersediaan akselerator GPU didasarkan pada region, jenis mesin, dan jumlah GPU yang Anda inginkan. Sebaiknya Anda mengonfirmasi ketersediaan dengan menggunakan referensi berikut:

• Ketersediaan region dan zona GPU. Jenis akselerator yang Anda inginkan harus tersedia di zona instance.
• GPU NVIDIA® A100. Periksa ketersediaan GPU untuk jenis mesin Anda.

Mengonfigurasi hardware

Untuk mengonfigurasi hardware Anda, lakukan langkah-langkah berikut:

1. Di bagian Hardware configuration, pilih Machine type.

2. Jika Anda ingin menggunakan GPU, pilih Jenis GPU. Jika Anda tidak melihat jenis GPU yang Anda inginkan, periksa ketersediaan GPU untuk jenis dan zona mesin Anda.

3. Jika Anda memilih untuk menggunakan GPU, pilih Number of GPU, lalu pilih Install NVIDIA GPU driver automatically for me.

4. Pilih Data disk type dan Data disk size in GB.

5. Untuk menggunakan perilaku sampah default sistem operasi, pilih kotak centang Delete to Trash. Jika Anda menggunakan perilaku sampah default, file yang dihapus menggunakan antarmuka pengguna JupyterLab dapat dipulihkan, tetapi file yang dihapus ini menggunakan kapasitas disk.

Memilih jenis enkripsi

Pilih kunci enkripsi yang dikelola Google default atau Customer-managed encryption key (CMEK). Untuk mempelajari lebih lanjut cara menggunakan CMEK dengan notebook terkelola, lihat Menggunakan kunci enkripsi yang dikelola pelanggan.

1. Di bagian Disk encryption, pilih Google-managed encryption key default atau pilih Customer-managed encryption key (CMEK).

2. Jika Anda memilih Customer-managed encryption key (CMEK), klik daftarnya, lalu pilih kunci yang dikelola pelanggan.

   • Jika kunci yang ingin digunakan tidak ada dalam daftar, masukkan resource ID kunci enkripsi Anda.

   • Untuk membuat kunci enkripsi yang dikelola pelanggan, lihat Membuat kunci enkripsi simetris.

Mengaktifkan penonaktifan saat tidak ada aktivitas

Penonaktifan saat tidak ada aktivitas diaktifkan secara default untuk mematikan instance setelah tidak aktif selama 180 menit. Anda dapat mengubah jumlah menit tidak aktif sebelum penonaktifan, atau menonaktifkan penonaktifan saat tidak ada aktivitas. Untuk mempelajari lebih lanjut, lihat Penonaktifan saat tidak ada aktivitas.

• Untuk mengubah jumlah menit sebelum penonaktifan, di bagian Idle shutdown, di kolom Time of inactivity before shutdown (Minutes), ubah nilainya ke bilangan bulat, mulai dari 10 sampai 1440.

• Untuk menonaktifkan penonaktifan saat tidak ada aktivitas, di bagian Idle shutdown, hapus Enable Idle Shutdown.

Mengonfigurasi jaringan Anda

Secara default, instance notebook terkelola Anda menggunakan jaringan VPC yang dikelola Google, yang tidak memerlukan konfigurasi. Jika ingin, Anda dapat menentukan jaringan VPC yang terletak dalam project atau jaringan yang dibagikan kepada Anda. Jika Anda menentukan jaringan, jaringan memerlukan koneksi akses layanan pribadi. Jaringan juga harus memiliki akses internet, atau Anda harus mengaktifkan Akses Google Pribadi untuk jaringan tersebut.

1. Di bagian Networking, pilih Networks in this project atau Networks shared with me.

2. Pada kolom Network, pilih jaringan yang ingin Anda gunakan.

3. Pada kolom Subnetwork, pilih subnetwork yang ingin Anda gunakan.

4. Untuk mengaktifkan alamat IP eksternal, centang kotak Enable external IP address. Jika jaringan yang ditentukan tidak memiliki akses internet, atau jika Anda tidak mengaktifkan alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi untuk jaringan tersebut agar dapat menggunakan instance ini.

5. Jika Anda belum mengonfigurasi koneksi akses layanan pribadi untuk jaringan ini, klik Set up connection dan selesaikan langkah berikut:

   1. Dalam dialog Create a private services access connection, aktifkan Service Networking API, lalu klik Enable API. Jika Service Networking API sudah diaktifkan, klik Continue.

   2. Di bagian Allocate an IP range, selesaikan dialog untuk memilih satu atau beberapa rentang IP yang ada, membuat rentang IP baru, atau menggunakan rentang IP yang dialokasikan secara otomatis.

   3. Setelah selesai, klik Continue.

   4. Di bagian Create a connection, tinjau jaringan dan alokasi rentang IP yang Anda pilih, lalu klik Create connection.

Mengonfigurasi opsi keamanan

Aktifkan atau nonaktifkan opsi berikut:

• nbconvert: nbconvert memungkinkan pengguna mengekspor dan mendownload file notebook sebagai jenis file berbeda, seperti HTML, PDF, atau LaTeX.
• File downloading from Notebook UI: Setelan ini memungkinkan pengguna mendownload file dari antarmuka pengguna JupyterLab.
• Terminal: Ini memungkinkan akses terminal ke instance notebook terkelola Anda dari dalam antarmuka pengguna JupyterLab.

Menyelesaikan pembuatan instance

1. Klik Create.

   Vertex AI Workbench akan otomatis memulai instance. Saat instance siap digunakan, Vertex AI Workbench akan mengaktifkan link Open JupyterLab.

Membuat instance menggunakan Terraform

Anda dapat membuat instance notebook terkelola menggunakan resource Terraform google_notebooks_runtime. Gunakan contoh berikut untuk membuat instance notebook terkelola baru yang bernama notebooks-runtime-basic.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

resource "google_notebooks_runtime" "basic_runtime" {
  name     = "notebooks-runtime-basic"
  location = "us-central1"

  access_config {
    access_type   = "SINGLE_USER"
    runtime_owner = "[e-mail]"
  }

  virtual_machine {
    virtual_machine_config {
      machine_type = "n1-standard-4"
      data_disk {
        initialize_params {
          disk_size_gb = "100"
          disk_type    = "PD_STANDARD"
        }
      }
    }
  }
}

Membuka JupyterLab

Setelah Anda membuat instance, Vertex AI Workbench akan otomatis memulai instance tersebut. Saat instance siap digunakan, Vertex AI Workbench akan mengaktifkan link Open JupyterLab.

1. Di samping nama instance notebook terkelola, klik Open JupyterLab.

2. Saat pertama kali mengakses antarmuka pengguna JupyterLab instance notebook terkelola, Anda harus memberikan izin gcloud CLI untuk mengakses data dan mengautentikasi instance notebook terkelola Anda.

   1. Pada dialog Authenticate your managed notebook, klik tombol untuk mendapatkan kode autentikasi.

   2. Pilih akun, lalu klik Allow. Salin kode autentikasi.

   3. Pada dialog Authenticate your Managed notebook, tempel kode autentikasi, lalu klik Authentication.

Instance notebook terkelola Anda akan membuka JupyterLab.

Membuka file notebook baru

1. Pilih File > New > Notebook.

2. Dalam dialog Select kernel, pilih Python, lalu klik Select.

3. File notebook baru akan terbuka.

Langkah selanjutnya

• Coba salah satu tutorial yang disertakan dalam instance notebook terkelola Anda yang baru. Di JupyterLab  File Browser, buka folder tutorials, dan buka salah satu file notebook.