> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/deka-gpu-documentations/panduan-untuk-enterprise/deka-gpu-mlops/notebook.md).

# Notebook

Menu *Notebooks* digunakan untuk membuat notebook bagi analisis data, pengembangan perangkat lunak, atau eksperimen *machine learning* menggunakan *JupyterLab*. *JupyterLab* berjalan pada *Pods* di klaster *Service Portal* Cloudeka.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-0689bc5b291b5141f370d6f48894f2f3745d4869%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Buat notebook

*Create Notebooks* digunakan untuk membuat notebook baru di *Service Portal* Cloudeka. Pada halaman *Notebooks*, klik tombol *+ New Notebook*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-558350c7119cbc2e69bac42bc088b4900f6cd21a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Pilih notebook: *JupyterLab*

Halaman *New Notebook* akan muncul dan beberapa kolom harus dilengkapi. Pada kolom *Name*, masukkan nama notebook. Nama harus terdiri dari karakter alfanumerik huruf kecil atau tanda hubung (`-`), dimulai dengan huruf, dan diakhiri dengan karakter alfanumerik. Panduan ini menggunakan *JupyterLab* sebagai lingkungan notebook. Pada bagian *Custom Notebook*, tentukan nama *image* yang dibuat di *Deka Registry* melalui *Service Portal* Cloudeka.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-f25a6e8aefdff628e5b874a9165b57bbb8f6e68e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Tambahkan *CPU/RAM* dan *GPU*

Pada bagian *CPU/RAM*, sesuaikan nilai *Minimum CPU* dan *Minimum Memory Gi* sesuai kebutuhan. Pada bagian *GPUs*, tentukan *GPU* yang akan digunakan. Kolom *GPU Vendor* otomatis diatur ke *NVIDIA*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-0c8d05f5d08d05564d61b935ddde4b44899e4c08%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Tambahkan volume ruang kerja

*Workspace Volumes* digunakan untuk menyimpan data yang dipakai notebook dan *workload* lain. Volume ini membantu mengatur dan mengelola data selama pengembangan. Pada bagian *Workspace Volume*, Anda dapat mengonfigurasi volume yang akan di-*mount* ke notebook.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-25bd16c223f71add50434db508eaece4b995ca91%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Untuk melihat detail konfigurasi volume, klik ikon perluas di samping ikon *Delete*. Jenis volume yang tersedia adalah *Empty volume* dan *Custom (Advanced)*. Jenis volume pertama, *Empty volume*, digunakan untuk membuat volume penyimpanan baru yang dapat di-*mount* ke notebook.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-c60be6034e5a6c1c5cba040c454c90036086b215%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Secara bawaan, jenis *Empty volume* menampilkan pengaturan berikut:

a. Jenis volume diatur ke *Empty volume*.

b. Nama bawaan volume baru adalah *“-volume”*. Anda dapat menyesuaikan namanya sesuai kebutuhan.

c. Ukuran bawaan adalah *5 Gibibytes (GiB)*.

d. Secara bawaan, *Storage Class* menggunakan *storage-nvme-c1*. Jika *Use Default Class* tidak dipilih, tersedia opsi seperti *Empty Storage Class*, *storage-mgmt*, *storage-nlsas*, *storage-nvme-c2*, dan kelas bawaan lainnya.

e. Tersedia tiga mode akses:

* *ReadWriteOnce (RWO)* memberikan akses baca dan tulis eksklusif ke satu server notebook.
* *ReadOnlyMany (ROX)* memberikan akses hanya-baca untuk beberapa server notebook.
* *ReadWriteMany (RWX)* memberikan akses baca dan tulis bersamaan untuk beberapa server notebook.

f. *Mount Path* adalah lokasi dalam *container* tempat volume diakses. Untuk *Workspace Volumes*, direktori bawaan *Jupyter Notebook* adalah `/home/jovyan`.

Jenis volume kedua adalah *Custom (Advanced)*. Opsi ini memungkinkan Anda menentukan konfigurasi volume khusus menggunakan spesifikasi volume *Kubernetes*. Lihat tautan *K8s docs* untuk informasi jenis volume dan opsi konfigurasi yang didukung.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-75624deb0e1b1b2a48454a7781a0585698637a3f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Secara bawaan, jenis *Custom (Advanced)* menampilkan pengaturan berikut:

a. Jenis volume diatur ke *Custom (Advanced)*.

b. Editor *YAML* tersedia untuk menentukan konfigurasi volume.

c. *Mount Path* menentukan lokasi volume di-*mount* dalam *container*. Secara bawaan, jalurnya adalah `/home/jovyan`.

### Tambahkan volume data

Bagian *Data Volumes* digunakan untuk menyimpan dan mengelola data secara persisten di luar siklus hidup server notebook. Data tetap tersedia meskipun server dihentikan atau dihapus. Bagian *Data Volumes* menyediakan dua fitur: *Add new volume* dan *Attach existing volume*. Anda dapat menambahkan lebih dari satu volume data.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-783c6a8c3a32ab82afe4d5dbaf39a7c0cd0eefb0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Fitur pertama adalah tombol *+ Add New Volume*, yang digunakan untuk membuat volume penyimpanan baru. Volume dapat di-*mount* ke notebook atau digunakan oleh berbagai komponen dalam *pipeline*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-7ff4d86237811367752b26ba6c88ac6e3337dbf1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Untuk melihat detail volume data baru, klik ikon perluas di samping ikon *Delete*. Secara bawaan, volume data baru menampilkan pengaturan berikut:

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-9d5dc6ca29722d8aead5019cb6a35f886190459a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

a. Jenis volume diatur ke *Empty volume*.

b. Nama bawaan volume baru adalah *“-datavol-1”*. Anda dapat menyesuaikan namanya sesuai kebutuhan.

c. Ukuran bawaan adalah *5 Gibibytes (GiB)*.

d. Secara bawaan, *Storage Class* menggunakan *storage-nvme-c1*. Jika *Use Default Class* tidak dipilih, tersedia opsi seperti *Empty Storage Class*, *storage-mgmt*, *storage-nlsas*, *storage-nvme-c2*, dan kelas bawaan lainnya.

e. Tersedia tiga mode akses:

* *ReadWriteOnce (RWO)* memberikan akses baca dan tulis eksklusif ke satu server notebook.
* *ReadOnlyMany (ROX)* memberikan akses hanya-baca untuk beberapa server notebook.
* *ReadWriteMany (RWX)* memberikan akses baca dan tulis bersamaan untuk beberapa server notebook.

f. *Mount Path* adalah lokasi dalam *container* tempat volume diakses. Untuk *Data Volumes*, direktori bawaan *Jupyter Notebook* adalah `/home/jovyan/-datavol-1`.

Fitur kedua adalah tombol *+ Attach Existing Volume*, yang digunakan untuk memasang volume penyimpanan yang ada ke notebook atau *pipeline machine learning*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-9d6e4b8118dc4b83a1347c1100c0479f8536c48e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Untuk melihat detail pemasangan volume, klik ikon perluas di samping ikon *Delete*. Secara bawaan, pemasangan volume menampilkan pengaturan berikut:

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-d2a7b562037586f1e56df4d626a9d40e50af676e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

a. Jenis volume diatur ke *Kubernetes volume*.

b. Anda dapat memilih *Readonly* agar volume terpasang dalam mode hanya-baca. Mode ini mencegah data ditulis atau diubah.

c. Kolom *Name* digunakan untuk memilih volume ruang kerja yang tersedia. Untuk membuat volume baru, lihat bagian *Create Volumes* dalam panduan ini.

d. *Mount Path* adalah lokasi dalam *container* tempat volume diakses. Untuk *Workspace Volumes*, direktori bawaan *Jupyter Notebook* adalah `/home/jovyan`.

### Pilih jenis *GPU*

Untuk memilih jenis *GPU* bagi server notebook, klik *Advanced Options*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-474645c992b43264ff4ca5e0b13232f6d8526984%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Pilih *GPU* pada bagian *Affinity Config*. Saat ini, tersedia opsi *GPU* berikut:

* *NVIDIA HGX-H100 SXM 80GB*
* *NVIDIA HGX-H100 SXM 10GB (MIG)*
* *NVIDIA HGX-H100 SXM 40GB (MIG)*
* *NVIDIA HGX-H100 SXM 20GB (MIG)*
* *NVIDIA EGX-L40S 48GB*

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-1f2ffa3ae6a82fe7469eae4f068af24a2d3cb816%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Klik tombol *Launch* untuk membuat notebook.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-4c05abe19262ec0f3883621c6571ee598cccec8e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Buka notebook *JupyterLab*

Setelah membuat dan menjalankan notebook, klik tombol *Connect* untuk membukanya. *JupyterLab* akan terbuka secara otomatis.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-773883af0d644e58e928a8a103074c8c50464159%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

*JupyterLab* adalah ruang kerja untuk membuat dan menjalankan notebook. *JupyterLab* menyediakan alat untuk mengelola file, mengedit kode, dan menjalankan sel notebook melalui antarmuka berbasis web.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcVXreGc8i72Gaitk6zSOitx5jkw91aZBN-Qkn9s_08ts4xQ5lut63rfa8oELve5L-85ozlU-mrvIF__nqo3UU5KYpjmcJqYVC1rmmzzbXhEDzGRqyRR8qoZ8f-uAUbUNeKOjjRgmTcAAjblMijDJAyquk?key=_dSwSB0N680jj3O7sANgig" alt=""><figcaption></figcaption></figure>

## Hentikan notebook *JupyterLab*

*Stop Notebook Server* digunakan untuk menghentikan sementara server notebook yang berjalan. Tindakan ini menghemat sumber daya, mempertahankan status saat ini, dan meningkatkan pengelolaan sumber daya.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-fd2f6b6e6c3e8e2f53e907760919551ae138dc31%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Dialog konfirmasi ditampilkan sebelum server notebook dihentikan. Tinjau pesan peringatan, lalu klik *Stop* untuk melanjutkan atau *Cancel* untuk menutup dialog dan tetap menjalankan server notebook.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-f99ccb8c5ad6fffe3fedd7f32bb4ed81aab81b50%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Mulai notebook *JupyterLab*

*Start Notebook Server* digunakan untuk memulai server notebook yang dihentikan dan memulihkan akses ke lingkungan notebook. Setelah server berjalan, Anda dapat terhubung ke notebook dan melanjutkan pekerjaan.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-435686c7bf6170cacdcd0d1433e4df3078dd70d5%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Notifikasi akan muncul untuk menunjukkan bahwa server notebook sedang dimulai. Setelah proses selesai, notebook siap digunakan.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-f2f395f47463f13466e852d6ad85f5a0cc952d7a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Hapus notebook

*Delete Notebook* digunakan untuk menghapus notebook yang tidak lagi diperlukan. Pada halaman *Notebooks*, cari notebook yang ingin dihapus, lalu klik ikon *trash*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-baad7be9d737e33044e0e9ccc375edb33874c227%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Klik tombol *Delete* untuk melanjutkan proses penghapusan notebook.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-aae45a1f82afdace13d125e2116f550a0c5abd92%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
