Deployment

Produksi engine-whatsapp berjalan sebagai satu proses PM2 — tidak ada worker terpisah seperti engine-bot. Deploy via GitHub Actions ke self-hosted runner.

Branch dan workflow

Single process PM2

# Staging
pm2 start dist/app.js --name engine-dazo-dev

# Production
pm2 start dist/app.js --name engine-dazo

Tidak ada ecosystem.config.js di repo — PM2 config produksi ada di server, tidak terlihat dari git. Setup server baru butuh provisioning manual.

Alur workflow

Kedua workflow identik struktur — hanya beda branch, runner, project dir, dan PM2 service name:

1. checkout repo
2. cd $PROJECT_DIR  →  git fetch --all  →  git reset --hard origin/<branch>
3. npm install
4. NODE_OPTIONS="--max-old-space-size=4096" npm run build
5. PM2 restart app (jika ada) — tidak start first-run

Langkah workflow detail (production)

# deploy_production.yml
- name: Checkout code
  uses: actions/checkout@v3

- name: Deploy Dazo App production
  run: |
    cd /var/www/engine-whatsapp

    echo "Pulling latest code..."
    git fetch --all
    git reset --hard origin/v3

    echo "Installing Dependencies..."
    npm install

    echo "Building resources..."
    NODE_OPTIONS="--max-old-space-size=4096" npm run build

    echo "Deploy Successfully..."

- name: Restart app
  run: |
    if sudo pm2 list | grep -q 'engine-dazo'; then
      sudo pm2 restart engine-dazo
    fi

    echo "Deploy Successfully..."

Caveats

Setelah deploy

Verifikasi cepat:

1. pm2 status — pastikan engine-dazo (atau engine-dazo-dev) online
2. curl http://localhost:5002/api/device-info?instance=test-uuid — harus merespons (bukan connection refused)
3. Cek log PM2 — pm2 logs engine-dazo
4. Cek wa-logs.txt — cari error MongoDB atau Baileys
5. Verifikasi sesi tersisa di-restore — log harus menunjukkan startSession untuk setiap folder di session/auth/
6. Test kirim pesan via POST /api/send-message dengan instance yang aktif

Checklist sebelum push ke v3

• npx tsc --noEmit lolos (exit 0)
• Tidak ada console.log debug tambahan di diff
• Tidak ada perubahan .env dengan kredensial nyata
• Tidak ada perubahan bentuk payload webhook tanpa koordinasi backend
• Tidak ada perubahan event Socket.IO tanpa koordinasi frontend
• Tidak ada perubahan instanceId konsistensi (folder, Map key, room, kolom id)
• Commit message jelas, Bahasa Indonesia, prefix sesuai konvensi

Runbook failure

MongoDB down

1. Cek pm2 logs engine-dazo — cari Mongodb Error Connection
2. connectDB process.exit(1) saat gagal — service akan restart otomatis via PM2 (jika tidak exit repeatedly)
3. Pulihkan MongoDB
4. PM2 auto-restart setelah MongoDB pulih (PM2 restart pada crash)
5. Verifikasi sesi di-restore setelah restart

Sesi tidak ter-restore

1. Cek folder session/auth/ di server — pastikan masih ada
2. Cek log wa-logs.txt — cari [INIT] Gagal memuat sesi <instanceId>
3. Restart PM2: sudo pm2 restart engine-dazo
4. Jika masih gagal, hapus folder sesi bermasalah dan minta pemilik device scan QR ulang

Baileys disconnect berulang

1. Cek log untuk Connection closed. Reconnecting: true
2. Baileys auto-reconnect — tunggu beberapa menit
3. Jika loggedOut, sesi dihapus dari memory dan filesystem — device butuh scan QR ulang
4. Verifikasi koneksi internet server stabil (WhatsApp butuh koneksi persisten)

Webhook ke backend gagal

1. Cek WEBHOOK_URL di .env server — pastikan menunjuk ke backend yang benar
2. Cek log — cari Gagal mengirim webhook:
3. Verifikasi backend reachable: curl -X POST {WEBHOOK_URL}/callback_message
4. Jika WEBHOOK_URL mengandung webhook-test, webhook sengaja dilewati (mode dummy)

Log prefixes

Langkah berikutnya

• Detail workflow GitHub Actions? Baca CI/CD & GitHub Actions.
• Setup environment? Baca Environment.
• Cara kerja sesi? Baca Session Lifecycle.