TutorialBagian 9 dari 12

Menjalankan & Menerbitkan ke Internet

Menjalankan di komputer sendiri untuk mencoba, lalu menerbitkannya lewat Vercel.

Isi halaman ini

Menjalankan di komputer sendiri

Dari folder proyek:

bash
npm run dev

Buka http://localhost:3000 di peramban. Untuk menghentikan, tekan Ctrl + C pada jendela perintah.

Memeriksa sebelum menerbitkan

bash
npx tsc --noEmit
npm run build

Perintah pertama memeriksa kesalahan penulisan kode; kedua membangun versi produksi.

Menerbitkan lewat Vercel

Vercel menjalankan aplikasi ini secara gratis, dengan pembaruan otomatis setiap kali kode diperbarui.

1. Unggah kode ke GitHub

Buat repositori privat di akun GitHub instansi, lalu unggah kodenya.

2. Hubungkan ke Vercel

  1. Buka https://vercel.com, masuk memakai GitHub
  2. Add New → Project, pilih repositori Anda
  3. Biarkan seluruh pengaturannya apa adanya
  4. Jangan tekan Deploy dulu — isi variabel lingkungan lebih dahulu

3. Isi variabel lingkungan

Buka Settings → Environment Variables, lalu masukkan seluruh isi .env.local Anda satu per satu.

Setel NEXT_PUBLIC_BASE_URL ke alamat akhir Anda — bila belum punya domain, pakai alamat pemberian Vercel lebih dulu, dan perbarui nanti.

4. Terbitkan

Tekan Deploy, tunggu beberapa menit. Vercel memberi alamat seperti nama-proyek.vercel.app.

5. Pasang domain (opsional)

Settings → Domains, tambahkan domain Anda, lalu ikuti petunjuk pengarahan DNS-nya.

Setelah domainnya aktif, perbarui NEXT_PUBLIC_BASE_URL ke domain itu lalu terbitkan ulang. Alamat ini dipakai pada QR SKHP — bila keliru, kode QR yang sudah tercetak akan mengarah ke alamat yang salah.

Tugas terjadwal

Berkas vercel.json sudah mengatur pengiriman pengingat kedaluwarsa harian. Pastikan CRON_SECRET terisi di Vercel agar tugas itu berjalan.

Setelah terbit

  1. Buka Dashboard → Diagnostik Sistem — pastikan seluruhnya OK
  2. Daftarkan akun Anda, naikkan perannya menjadi admin
  3. Setel kode akses anjungan di Pengaturan Sistem
  4. Semai naskah panduan lewat Dashboard → Panduan → Penyemaian
  5. Coba satu permohonan uji dari awal sampai SKHP terbit

Memperbarui di kemudian hari

Setiap kali kode diperbarui dan diunggah ke GitHub, Vercel menerbitkannya sendiri. Anda tidak perlu melakukan apa pun.

Bila pembaruan itu menambah tabel atau lembar baru, keterangannya disertakan — jalankan berkas SQL-nya bila diminta.