19. Panduan Penyebaran (Deployment) Produksi

Ringkasan

Panduan ini mencakup opsi-opsi rilis produksi untuk T3 Stack Single-App Boilerplate pada berbagai platform seperti Vercel, Container Docker, serta VPS Hostinger / Node.js Process Manager (PM2).


Opsi Penyebaran

Opsi 1: Vercel Deployment (Sangat Direkomendasikan)

  • Push repositori kode ke GitHub / GitLab.
  • Import repositori pada Vercel Dashboard.
  • Atur variabel lingkungan (DATABASE_URL, NEXTAUTH_SECRET, NEXTAUTH_URL).
  • Klik Deploy. Vercel secara otomatis mendeteksi Next.js App Router.
  • Opsi 2: Docker Containerization

    Gunakan perintah build Docker standar:

    dockerfile
    # Build image
    docker build -t turah-singleapps .
    
    # Jalankan container
    docker run -d -p 3000:3000 --env-file .env turah-singleapps

    Opsi 3: VPS Hostinger / Node.js PM2

  • SSH ke dalam server VPS Anda.
  • Clone repositori dan install dependensi:
  • bash
       pnpm install --frozen-lockfile
  • Sinkronkan skema database & jalankan seed data awal:
  • bash
       pnpm prisma db push
       pnpm prisma db seed
  • Build bundle produksi Next.js:
  • bash
       pnpm build
  • Jalankan proses Node via PM2:
  • bash
       pm2 start npm --name "turah-app" -- start

    Berkas Terkait

  • next.config.js — Konfigurasi Next.js & header keamanan
  • package.json — Script build (pnpm build, pnpm start)