Deploy dari Template

Dokumentasi ini mengikuti alur screenshot yang sudah disiapkan: mengambil template, menyiapkan data, mengedit app.py, upload ke GitHub, lalu deploy ke Vercel.

1. Ambil Template

1

Download template dari GitHub

1. Buka repository template.
2. Klik tombol Code.
3. Pilih Download ZIP.
4. Extract ZIP ke folder kerja.

Repository template dengan tombol Code terbuka.

Menu Download ZIP di GitHub.

2. Siapkan Folder Data

Setelah template diextract, pastikan struktur folder project sudah benar dan file data berada di folder data/.

nama-project/
  app.py
  data/
  index.html
  requirements.txt
  vercel.json

Struktur folder project setelah ZIP diextract.

File data sudah berada di folder data.

3. Sesuaikan API Python

Buka file app.py, lalu sesuaikan nama file data dan nama kolom yang dipakai untuk pencarian.

DATA_FILE = DATA_DIR / "file_data.csv"
title_column = "judul"
content_column = "isi"

Sesuaikan DATA_FILE dengan nama file data.

Sesuaikan title_column dan content_column dengan nama kolom data.

4. Upload Project ke GitHub

1

Buat atau masuk ke akun GitHub

Gunakan akun GitHub untuk menyimpan project sebelum dihubungkan ke Vercel.

Halaman akun GitHub.

2

Buat repository baru

1. Klik menu membuat repository baru.
2. Isi nama repository.
3. Buat repository.

Pilih menu New repository dari dashboard GitHub.

Isi form untuk membuat repository baru.

3

Upload file project

1. Pilih menu upload file.
2. Upload seluruh isi folder project.
3. Commit perubahan.

Menu memilih upload file.

Halaman upload file project.

Bagian commit changes untuk menyimpan upload.

Repository setelah semua file berhasil diupload.

5. Deploy Project ke Vercel

1

Buka Vercel dan buat project baru

1. Buka dashboard Vercel.
2. Pilih menu membuat project baru.

Halaman awal Vercel.

Menu membuat project baru.

2

Import repository GitHub

1. Pilih repository yang baru diupload.
2. Pastikan konfigurasi deploy sudah sesuai.
3. Klik Deploy.

Memilih repository GitHub yang akan diimport.

Konfigurasi deploy dan tombol Deploy.

3

Ambil URL hasil deploy

Setelah deploy selesai, Vercel akan menampilkan URL project.

Dashboard deploy dengan URL hasil deploy.

6. Cek Hasil Deploy

Sebelum link dibagikan, buka URL dari Vercel dan pastikan endpoint API merespons.

https://nama-project.vercel.app
https://nama-project.vercel.app/api/health

Troubleshooting

Jika deploy gagal, cek deployment logs di Vercel.

• File data belum berada di folder data/.
• Nama file data berbeda dengan kode di app.py.
• Nama kolom data tidak sama dengan kode.
• File app.py tidak ikut terupload.
• Dependency belum ditulis di requirements.txt.